Tomcat中配置文件详解
Server.xml配置文件说明,以及Tomcat组件的说明
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