tomcat配置文件server.xml含义说明

tomcat的配置文件一般都在conf文件夹里，主要有server.xml，context.xml，tomcat_user.xml，web.xml四个常用配置文件，server.xml主要是服务器设置的，例如端口设置，路径设置。

下面对server.xml中tomcat的默认配置进行说明，了解含义之后，就可以根据自己的实际情况进行修改。

各组件关系图：

<Server port="8005" shutdown="SHUTDOWN">
<Server>

Server即Catalina servlet组件，它是server.xml的最外层元素。port="8005"——指定8005端口负监听tomcat的请求。若设置为-1，则禁止通过端口关闭Tomcat，同时shutdown.bat也不能使用。shutdown="SHUTDOWN"——收到字符串"SHUTDOWN"表示关闭，修改shutdown的值，对shutdown.bat无影响。 <!-- Security listener. Documentation at /docs/config/listeners.html
<Listener className="org.apache.catalina.security.SecurityListener" />
-->
<!--APR library loader. Documentation at /docs/apr.html -->
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<!--Initialize Jasper prior to webapps are loaded. Documentation at /docs/jasper-howto.html -->
<Listener className="org.apache.catalina.core.JasperListener" />
<!-- Prevent memory leaks due to use of particular java/javax APIs-->
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />Listener即监听器，负责监听特定的事件，当特定事件触发时，Listener会捕捉到该事件，并做出相应处理。Listener通常用在Tomcat的启动和关闭过程。Listener可嵌在Server、Engine、Host、Context内。className=""——指定实现org.apache.catalina.LifecycleListener接口的类。
<GlobalNamingResources>
<!-- Editable user database that can also be used by
UserDatabaseRealm to authenticate users
-->
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
</GlobalNamingResources>GlobalNamingResources用于配置JNDII(Java Naming and Directory Interface,Java命名和目录接口)。<Service name="Catalina">
</Service>Service包装Executor、Connector、Engine，以组成一个完整的服务。className——指定实现org.apache.catalina. Service接口的类，默认值为org.apache.catalina.core.StandardService。name———Service的名字。Server可以包含多个Service组件。<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />Connector是Tomcat接收请求的入口，每个Connector有自己专属的监听端口。port:"8080"——Connector监听客户服务的端口:8080。protoco="HTTP/1.1"——Connector使用的协议（HTTP/1.1或AJP/1.3）。connectionTimeout="20000"——每个请求的最长连接时间20000ms。redirectPort="8443"——服务器正在处理Http请求时，为收到的SSL(Secure Sockets Layer 安全套接层)处理重定位端口:8443。<Engine name="Catalina" defaultHost="localhost">
</Engine>

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

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

name:"Catalina"——Engine的名字。
defaultHost="localhost"——指定默认处理请求的虚拟主机名：localhost。要求和Host name定义一致。

<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>

Realm可以理解为包含用户、密码、角色的”数据库”。Tomcat定义了多种Realm实现：JDBC Database Realm、DataSource Database Realm、JNDI Directory Realm、UserDatabase Realm等
className:""——指定Realm 使用的类名，此类必须实现org.apache.catalina.Realm 接口

<Host name="localhost"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
</Host>

Host负责管理一个或多个Web项目.
name="localhost"——指定默认虚拟主机名：localhost。appBase="webapps"——默认Web源代码存放目录，可以是war文件或目录。（绝对路径、相对路径均可）unpackWARS="true"——是否自动将war文件解压，true-自动解压,false-直接从WAR文件运行Web项目。autoDeploy="true"——是否开启自动部署。设为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<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs"
prefix="localhost_access_log."
suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
Valve可以理解为Tomcat的拦截器，而我们常用filter为项目内的拦截器。Valve可以用于Tomcat的日志、权限等。Valve可嵌在Engine、Host、Context内。
className=""——指定Valve 使用的类名，如用org.apache.catalina.valves.AccessLogValve 类可以记录应用程序的访问信息。directory="logs"——指定log 文件存放的位置。prefix=""——指定log 文件的前缀。
suffix=""——指定log 文件的后缀。
pattern=""——有两个值，common 方式记录远程主机名或ip 地址，用户名，日期，第一行请求的字符串，HTTP 响应代码，发送的字节数。combined 方式比common 方式记录的值更多。