Tomcat 8（二）server.xml详解

Tomcat服务器是由一系列可配置的组件构成的，其中核心组件是Catalina Servlet，它是最顶层组件。

Tomcat的各组件是在server.xml（CATALINA_HOME\conf\server.xml）配置的

Tomcat各组件关系图

1. Server

Server即Catalina servlet组件，它是server.xml的最外层元素

常用属性：

Address—Tomcat监听shutdown命令的地址，默认为localhost 

className—指定实现org.apache.catalina.Server接口的类，默认值为org.apache.catalina.core.StandardServer

port－Tomcat监听shutdown命令的端口。设置为-1，则禁止通过端口关闭Tomcat，同时shutdown.bat也不能使用

shutdown－通过指定的地址（Address）、端口（port）关闭Tomcat所需的字符串。修改shutdown的值，对shutdown.bat无影响

通过端口关闭Tomcat，可以用telnet进行测试

安装telnet

打开控制面板－程序－启用或关闭Windows功能，勾上”Telnet服务器”、”Telnet客户端”，点”确定”

安装成功后，首先启动Tomcat，然后在cmd下输入

telnet localhost 8005

然后输入SHUTDOWN即可关闭Tomcat

2. Listener

Listener即监听器，负责监听特定的事件，当特定事件触发时，Listener会捕捉到该事件，并做出相应处理。Listener通常用在Tomcat的启动和关闭过程。Listener可嵌在Server、Engine、Host、Context内

常用属性：

className－指定实现org.apache.catalina.LifecycleListener接口的类

3. GlobalNamingResources

GlobalNamingResources用于配置JNDI

4. Service

Service包装Executor、Connector、Engine，以组成一个完整的服务

常用属性：

className—指定实现org.apache.catalina. Service接口的类，默认值为org.apache.catalina.core.StandardService

name—Service的名字

Server可以包含多个Service组件

5. Executor

Executor即Service提供的线程池，供Service内各组件使用

常用属性：

className－指定实现org.apache.catalina. Executor接口的类，默认值为org.apache.catalina.core. StandardThreadExecutor

name－线程池的名字

daemon－是否为守护线程，默认值为true

maxIdleTime－总线程数高于minSpareThreads时，空闲线程的存活时间（单位：ms），默认值为60000，即1min

maxQueueSize－任务队列上限，默认值为Integer.MAX_VALUE(（2147483647），超过此值，将拒绝

maxThreads－线程池内线程数上限，默认值为200

minSpareThreads－线程池内线程数下限，默认值为25

namePrefix－线程名字的前缀。线程名字通常为namePrefix+ threadNumber

prestartminSpareThreads－是否在Executor启动时，就生成minSpareThreads个线程。默认为false

threadPriority－Executor内线程的优先级，默认值为5（Thread.NORM_PRIORITY）

threadRenewalDelay－重建线程的时间间隔。重建线程池内的线程时，为了避免线程同时重建，每隔threadRenewalDelay（单位：ms）重建一个线程。默认值为1000，设置为负则不重建

6. Connector

Connector是Tomcat接收请求的入口，每个Connector有自己专属的监听端口

Connector有两种：HTTP Connector和AJP Connector

常用属性：

port－Connector接收请求的端口

protocol－Connector使用的协议（HTTP/1.1或AJP/1.3）

connectionTimeout－每个请求的最长连接时间（单位：ms）

redirectPort－处理http请求时，收到一个SSL传输请求，该SSL传输请求将转移到此端口处理

executor－指定线程池

如果没设置executor，可在Connector标签内设置maxThreads（默认200）、minSpareThreads（默认10）

acceptCount－Connector请求队列的上限。默认为100。当该Connector的请求队列超过acceptCount时，将拒绝接收请求

7. Engine

Engine负责处理Service内的所有请求。它接收来自Connector的请求，并决定传给哪个Host来处理，Host处理完请求后，将结果返回给Engine，Engine再将结果返回给Connector

常用属性：

name－Engine的名字

defaultHost－指定默认Host。Engine接收来自Connector的请求，然后将请求传递给defaultHost，defaultHost 负责处理请求

className－指定实现org.apache.catalina. Engine接口的类，

默认值为org.apache.catalina.core. StandardEngine

backgroundProcessorDelay－Engine及其部分子组件（Host、Context）调用backgroundProcessor方法的时间间隔。backgroundProcessorDelay为负，将不调用backgroundProcessor。

backgroundProcessorDelay的默认值为10

注：Tomcat启动后，Engine、Host、Context会启动一个后台线程，定期调用backgroundProcessor方法。backgroundProcessor方法主要用于重新加载Web应用程序的类文件和资源、扫描Session过期

jvmRoute－Tomcat集群节点的id。部署Tomcat集群时会用到该属性，

Service内必须包含一个Engine组件

Service包含一个或多个Connector组件，Service内的Connector共享一个Engine

8. Host

Host负责管理一个或多个Web项目

常用属性：

name－Host的名字

appBase－存放Web项目的目录（绝对路径、相对路径均可）

unpackWARs－当appBase下有WAR格式的项目时，是否将其解压（解成目录结构的Web项目）。设成false，则直接从WAR文件运行Web项目

autoDeploy－是否开启自动部署。设为true，Tomcat检测到appBase有新添加的Web项目时，会自动将其部署

startStopThreads－线程池内的线程数量。Tomcat启动时，Host提供一个线程池，用于部署Web项目

startStopThreads为0，并行线程数=系统CPU核数

startStopThreads为负数，并行线程数=系统CPU核数+startStopThreads，如果（系统CPU核数+startStopThreads）小于1，并行线程数设为1

startStopThreads为正数，并行线程数= startStopThreads

startStopThreads默认值为1

startStopThreads为默认值时，Host只提供一个线程，用于部署Host下的所有Web项目。如果Host下的Web项目较多，由于只有一个线程负责部署这些项目，因此这些项目将依次部署，最终导致Tomcat的启动时间较长。此时，修改startStopThreads值，增加Host部署Web项目的并行线程数，可降低Tomcat的启动时间

Tomcat配置多Host可参考此文：http://grass51.blog.51cto.com/4356355/1123400

9. Context

Context代表一个运行在Host上的Web项目。一个Host上可以有多个Context

将一个Web项目（D:\MyApp）添加到Tomcat，在Host标签内，添加Context标签

 

常用属性：

path－该Web项目的URL入口。path设置为””，输入http://localhost:8080即可访问MyApp；path设置为”/test/MyApp”，输入http://localhost:8080/test/MyApp才能访问MyApp

docBase－Web项目的路径，绝对路径、相对路径均可

（相对路径是相对于CATALINA_HOME\webapps）

reloadable－设置为true，Tomcat会自动监控Web项目的/WEB-INF/classes/和/WEB-INF/lib变化，当检测到变化时，会重新部署Web项目。reloadable默认值为false。通常项目开发过程中设为true，项目发布的则设为false

crossContext－设置为true，该Web项目的Session信息可以共享给同一host下的其他Web项目。默认为false

10. Cluster

Tomcat集群配置。(见Tomcat 8（三）Apache2.2.25+Tomcat8.0.3集群配置和Tomcat 8（四）server.xml的Cluster标签详解)

11. Realm

Realm可以理解为包含用户、密码、角色的”数据库”。Tomcat定义了多种Realm实现：JDBC Database Realm、DataSource Database Realm、JNDI Directory Realm、UserDatabase Realm等

12. Valve

Valve可以理解为Tomcat的拦截器，而我们常用filter为项目内的拦截器。Valve可以用于Tomcat的日志、权限等。Valve可嵌在Engine、Host、Context内

 

最后再来回顾一下Tomcat处理请求的流程图

（request为http://localhost:8080/examples/index.html）

 

现在，再来看看”Tomcat各组件关系图”（文章开头那张），可以发现Server和Service充当的就是包装的角色：Server包装了Listener、GlobalNamingResources、Service；Service包装了Executor、Connector、Engine