本文将介绍Tomcat中主要的配置文件server.xml的一些标签及其含义

Tomcat隶属于Apache基金会，是开源的轻量级Web应用服务器，使用非常广泛。server.xml是Tomcat中最重要的配置文件，server.xml的每一个元素都对应了Tomcat中的一个组件；通过对xml文件中元素的配置，可以实现对Tomcat中各个组件的控制。因此，学习server.xml文件的配置，对于了解和使用Tomcat至关重要。

安装好tomcat后，在conf目录下的server.xml默认会有一些配置

<Server port="8005" shutdown="SHUTDOWN">
    <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
    <Listener SSLEngine="on"
        className="org.apache.catalina.core.AprLifecycleListener" />
    <Listener className="org.apache.catalina.core.JasperListener" />
    <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
    <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
    <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

    <GlobalNamingResources>
        <Resource auth="Container" description="User database that can be updated and saved"
            factory="org.apache.catalina.users.MemoryUserDatabaseFactory" name="UserDatabase"
            pathname="conf/tomcat-users.xml" type="org.apache.catalina.UserDatabase" />
    </GlobalNamingResources>

    <Service name="Catalina">

        <Connector URIEncoding="UTF-8" connectionTimeout="20000"
            port="80" protocol="HTTP/1.1" redirectPort="8443" />
        <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

        <Engine defaultHost="localhost" name="Catalina">

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

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

                <Valve className="org.apache.catalina.valves.AccessLogValve"
                    directory="logs" pattern="%h %l %u %t "%r" %s %b" prefix="localhost_access_log."
                    suffix=".txt" />

            </Host>
        </Engine>
    </Service>

以上的就是我们要逐一介绍的节点

Server节点

描述：Server代表一个Tomcat实例（一个JVM）所以server.xml中唯一一个最外层的元素（唯一）

功能：提供接口让客户端能访问Server包含的Service，维护各个Service的生命周期等。

属性：

• port: 指定端口监听关闭tomcat的请求，设为-1可以禁掉该端口。
• shutdown: 关闭tomcat的发送的字符串

Service

描述：一个Server节点可以包含多个Service节点。不同的Service所监听的端口必须是不能重复的。

功能：一个Service可以理解为Engine和Connector的容器。每个Connector通过一个特定的端口和协议接收入站请求交将其转发至关联的Engine进行处理。

属性：

• name:指定service 的名字
  会默认生成一个名为Catalina的Service

Service包含Connector和Engine两个节点。

Connector

描述：一个Service可以包含多个Connector，Connector有多种类型

• HTTP连接器
• SSL连接器
• AJP 1.3连接器
• proxy连接器
  他用来表示客户端和service之间的连接。

HTTP connector 示例：

<Connector port="8080" protocol="HTTP/1.1"
      maxThreads="150" connectionTimeout="20000"
      redirectPort="8443" URIEncoding="UTF-8"/>

SSL connector 示例：

<Connector port="8443"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" acceptCount="100" debug="0" scheme="https" secure="true"
    clientAuth="false" sslProtocol="TLS" />

AJP connector 示例：

<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

在默认的Service中包含两个Connector：
分别是

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"redirectPort="8443"/>
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>

此时Tomcat监听的HTTP请求，协议是HTTP/1.1，端口是8080，转发HTTPS请求到8443端口。

配置<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>客户端就可以通过8009端口使用AJP协议访问tomcat。

AJP协议：
AJP协议负责和其他http服务器建立连接，把tomcat服务器和其他http服务器连接时，就需要这个，之所以使用Tomcat和其他服务器集成，是因为Tomcat可以用作Servlet/JSP容器，但是对静态资源的处理速度较慢，不如Apache和IIS等HTTP服务器；因此常常将Tomcat与Apache等集成，前者作Servlet容器，后者处理静态资源，而AJP协议便负责Tomcat和Apache的连接

功能：接收连接请求，创建Request和Response对象用于和请求端交换数据，然后分配线程让Engine处理请求并把Request和Response对象传递给Engine

主要属性属性：

• port 指定服务器要创建的端口号，并在改端口监听客户端的请求。
• minProcessors 服务启动时创建处理请求的线程数目。
• maxProcessors 最大可创建的处理请求线程数目。
• enableLookups true:进行DNS查询得到远程客户端的实际主机名 false不进行查询。s
• redirectPort 如果某连接器支持的协议是HTTP，当接收客户端发来的HTTPS请求时，则转发至此属性定义的端口
• connectionTimeout 等待客户端发送请求的超时时间，单位为毫秒，默认为60000，即1分钟；

其他属性

Engine

描述：一个Service 对应一个Engine。

功能：一个Engine�从一个或者多个Connector中接收请求并处理，并将完成的响应返回给Connector。

主要属性：

• defaultHost 默认host的名字。
• name 用于日志和错误信息，在Server中唯一
• startStopThreads 该Engine启动子Host默认开启的线程

Host

描述：一个Engine对应多个Host ，每个�Host代表Engine的一个虚拟主机。Host组件至少有一个，且其中一个的name必须与Engine组件的defaultHost属性相匹配。

功能：运用来运行多个web应用，负责�Web应用的生命周期。

tip: 虚拟主机是一种在一个web服务器上服务多个域名的机制，对每个域名而言，都好象独享了整个主机。实际上，大多数的小型商务网站都是采用虚拟主机实现的，这主要是因为虚拟主机能直接连接到Internet并提供相应的带宽，以保障合理的访问响应速度，另外虚拟主机还能提供一个稳定的固定IP。

主要属性：

• name 指定虚拟主机的主机名
• unpackWARs 是否将war文件解压，true为运行解压war文件后灯文件夹，false直接运行war文件。
• autoDeploy 是否自动部署
• appBase �此虚拟Host的WebApp存放路径。

若只配置appBase，不配Context 的docBase(appBase和docBase二选一就可以了)，则appBase的每个文件夹里都代表一个应用.这个目录下面的.war文件将被自动解压缩并部署为应用。

Context

描述：一个Host可以对应多个Context，Context表示在特定的虚拟主机�上运行的一个Web�应用。
功能：

主要属性：

• path 指定Web应用的URL入口 （多指项目名）
• docBase 指定Web应用的文件路径，可以是绝对路径，也可以是相对路径（相对该Context所在的Host的appBase属性值）
• reloadable 若此属性为true，tomcat在运行状态下回监视WEB-INF/classes和WEB-INF/lib目录下class的文件改动，若有文件更新服务器会重载Web应用

其他属性

例子：在默认Host标签中添加Context

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
     <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
                       prefix="localhost_access_log." suffix=".txt"
                       pattern="%h %l %u %t "%r" %s %b"/>
    <Context path="/test" reloadable="true" docBase="/Users/WLW/tomcat/webapps2">
    
    </Context>
</Host>

在/Users/WLW/tomcat/webapps2下创建test.html。

访问http://localhost:8080/test/test.html

参考