tomcat-01-server.xml讲解

桃扇骨 2023-06-04 10:55 14阅读 0赞

# 1.顶级元素server #

![1672408-20190804154508881-1889745980.png][]

它默认监听在8005端口以接收shutdown命令。要启用多个tomcat实例，将它们监听在不同的端口即可。这个端口的定义为管理员提供一个关闭实例的便捷途径，可以直接telnet至此端口使用SHUTDOWN命令关闭此实例。不过基于安全角度的考虑，通常不允许远程进行。

Server的相关属性：

*  **`className`**：用于实现此组件的java类的名称，这个类必须实现接口org.apache.catalina.Server。不给定该属性时将采用默认的标准类org.apache.catalina.core.StandardServer；
 *  **`address`**：监听端口绑定的地址。如不指定，则默认为Localhost，即只能在localhost上发送SHUTDOWN命令；
 *  **`port`**：接收shutdown指令的端口，默认仅允许通过本机访问，默认为8005；
 *  **`shutdown`**：通过TCP/IP连接发往此Server用于实现关闭tomcat实例的命令字符串。

**在server组件中可嵌套一个或多个service组件。（这里我们需要说一下，**

**        1.  看到网上道德好多资料说通过配置多个service就可以，但是我的当时对8.5 版本，尝试了几次，是没有成功的。**

**        2.  但是我们需要知道的是，可以这样操作，但是现实中，我们不会把项目部署到同一个tomcat下面的，因为要是发布的话，停了一个，另一个服务也就不能访问了，这样是不行的。）**

# 2.顶级元素service #

定义了service就能提供服务了。service组件中封装connector和container，它同时也表示将此service中的connector和container绑定起来，即由它们组成一个service向外提供服务。默认定义如下：

**Service相关的属性**：

*  `className`：用于实现service的类名，这个类必须实现org.apache.catalina.Service接口。不给定该属性时将采用默认的标准类org.apache.catalina.core.StandardService。
 *  `name`：此service的显示名称，该名称主要用于在日志中进行标识service。一般来说无关紧要，默认为Catalina。

**Service的作用**，是在Connector和Engine外面包了一层，把它们组装在一起，对外提供服务。**一个Service可以包含多个Connector（这里可以启动多个端口，通过观察可以发现，启动的线程数，也增加了，但是网上一直没有人说这样的操作，到底是好，还是不好，以后可以自己测试一下）**，但是只能包含一个Engine；其中Connector的作用是从客户端接收请求，Engine的作用是处理接收进来的请求。

![1672408-20190804161232712-1576017193.png][]

在第一部分的例子中，Server中包含一个名称为“Catalina”的Service。实际上，Tomcat可以提供多个Service，不同的Service监听不同的端口，后文会有介绍。

# 3.执行器executor #

执行器定义tomcat各组件之间共享的线程池。在以前，每个connector都会独自创建自己的线程池，但现在，可以定义一个线程池，各组件都可以共享该线程池，不过主要是为各connector之间提供共享。注意，**executor创建的是共享线程池，如果某个connector不引用executor创建的线程池，那么该connector仍会根据自己指定的属性创建它们自己的线程池**。

连接器必须要实现org.apache.catalina.Executor接口。它是一个嵌套在service组件中的元素，为了挑选所使用的connector，该元素还必须定义在connector元素之前。

默认的定义如下：

其中该组件的属性有：

*  `className`：用于实现此组件的java类的名称，这个类必须实现接口org.apache.catalina.Executor。不给定该属性时将采用默认的标准类org.apache.catalina.core.StandardThreadExecutor；
 *  `name`：该线程池的名称，其他组件需要使用该名称引用该线程池。

标准类的属性包括：

*  `threadPriority`：线程优先级，默认值为5。
 *  `daemon`：线程是否以daemon的方式运行，默认值为true。
 *  `namePrefix`：执行器创建每个线程时的名称前缀，最终线程的名称为:namePrefix+threadNumber。
 *  `maxThreads`：**线程池激活的最大线程数量。默认值为200。**
 *  `minSpareThreads`：线程池中最少空闲的线程数量。默认值为25。
 *  `maxIdleTime`：在空闲线程关闭前的毫秒数。除非激活的线程数量小于或等于minSpareThreads的值，否则会有空闲线程的出现。默认值为60000，即空闲线程需要保留1分钟的空闲时间才被杀掉。
 *  `maxQueueSize`：可执行任务的最大队列数，达到队列上限时的连接请求将被拒绝。
 *  `prestartminSpareThreads`：在启动executor时是否立即创建minSpareThreads个线程数，默认为false，即在需要时才创建线程。

![1672408-20190804163109982-351578354.png][]

# 4.连接器connector #

连接器用于**接收客户端发送的请求并返回响应给客户端**。一个service中可以有多个connector。有多种connector，常见的为http/1.1,http/2和ajp(apache jserv protocol)。在tomcat中，ajp连接协议类型专用于tomcat前端是apache反向代理的情况下。

因此tomcat可以扮演两种角色：

*  Tomcat仅作为应用程序服务器：请求来自于前端的web服务器，这可能是Apache, IIS, Nginx等；
 *  Tomcat既作为web服务器，也作为应用程序服务器：请求来自于浏览器。

Tomcat应该考虑工作情形并为相应情形下的请求**分别定义**好需要的连接器才能正确接收来自于客户端的请求。

此处暂先介绍HTTP/1.1连接器的属性设置。ajp后文再做介绍。

HTTP连接器表示支持HTTP/1.1协议的组件。设置了该连接器就表示catalina启用它的独立web服务功能，当然，肯定也提供它必须的servlets和jsp执行功能。在一个service中可以配置一个或多个连接器，每个连接器都可以将请求转发给它们相关联的engine以处理请求、创建响应。

**每个流入的请求都需要一个独立的线程来接收**。当并发请求数量超出maxThreads指定的值时，多出的请求将被堆叠在套接字中，直到超出acceptCount指定的值。超出accpetCount的请求将以"connection refused"错误进行拒绝。

# 5.容器类engine #

engine是service组件中用来分析协议的引擎机器，**它从一个或多个connector上接收请求，并将请求交给对应的虚拟主机进行处理，最后返回完整的响应数据给connector，通过connector将响应数据返回给客户端。**

**      只有一个engine元素必须嵌套在每个service中，且engine必须在其所需要关联的connector之后，这样在engine前面的connector都可以被此engine关联，而在engine后面的connector则被忽略，因为一个service中只允许有一个engine。**

# **6.**容器类host #

host容器用来定义虚拟主机。engine从connector接收到请求进行分析后，会将相关的属性参数传递给对应的(筛选方式是从请求首部的host字段和虚拟主机名称进行匹配)虚拟host进行处理。如果没有合适的虚拟主机，则传递给默认虚拟主机。因此每个容器中必须至少定义一个虚拟主机，且必须有一个虚拟主机和engine容器中定义的默认虚拟主机名称相同。

# 7.容器类context(这里在多部署情况下讲解吧) #

转载于:https://www.cnblogs.com/lys-lyy/p/11298864.html

[1672408-20190804154508881-1889745980.png]: /images/20230601/7b230557bdf5406ab986d3560c4820bd.png
[1672408-20190804161232712-1576017193.png]: /images/20230601/e651d417b0774ab8b53c8db09e286605.png
[1672408-20190804163109982-351578354.png]: /images/20230601/1f5a1b9c524a4007a748b2da3749dfc7.png