Tomcat 初探（二） server.xml 配置

前言

　　在上一篇文章中，我们在示例中演示了网站的发布，其中涉及到了 server.xml 的修改，本文中我会给大家详细解释一下 server.xml 文件中的节点及其属性的作用，本片文章参考并摘抄了他人的一些文章，列举出来，表示感谢：

tomcat server.xml 中文版：http://www.blogjava.net/baoyaer/articles/107278.html

tomcat server.xml 文件内各节点详解：http://www.cnblogs.com/gentoo/archive/2012/10/13/2722463.html

tomcat 启动过程原理详解：http://www.ha97.com/4820.html

结构

• Server 节点代表着整个 catalina servlet container 且只能有一个；
• Service 节点由一个 Engine、一个或多个 Connector 组成；
• Connector 节点主要监听客户请求，Tomcat 有两个典型的 Connector，一个直接侦听来自 browser 的 http 请求，一个侦听来自其他 WebServer 的请求；
• Engine 节点主要负责处理所有 Connector 所获得的客户请求，交由 HOST 处理后，回应 Connector 并返回客户；
• HOST 节点代表一个虚拟主机，每个虚拟主机和一个网络域名相匹配，每个虚拟主机下都可以部署一个或多个 Web App，每个 Web App 对应于一个 Context 和 Context 的 path；
• Context 节点对应着我们的 Web App，一个 Web App 由一个或多个 Servlet 组成。

　　好了，通过上面对与各个节点的介绍，想必大家对于 server.xml 的文档结构有了一个大致的了解，现在我们以 http://localhost:8080/lofei/welcome.jsp 地址为例再来梳理一下 tomcat 的处理流程：

请求被发送到本机的8080端口，被正在侦听的 Coyote HTTP/1.1 Connector 获得；

1. Connector 把请求转交给它所在 Service 中的 Engine 来处理，并等待来自该 Engine 的回应；
2. Engine 获取请求 localhost/lofei/welcome.jsp，匹配它所拥有的所有虚拟主机 HOST（当然有的请求匹配不到也没关系，Engine 有一个默认的虚拟主机，当请求无法匹配到任何 HOST 上时，就交给该默认 HOST 来处理。）；
3. Engine 匹配它所拥有的所有名为 localhost 的请求；
4. 匹配到的 HOST 获得请求 /lofei/welcome.jsp，匹配它所有的 Context（如果匹配不到就把该请求交给路径名为""的 Context 去处理），匹配的 Context 为 path 为 lofei 的 Context；
5. 匹配到的 Context 获得请求 /welcome.jsp，在 mapping table 中寻找对应的 servlet context 匹配到对应的页面；
6. 构造 HttpServletRequest 对象和 HtppResponse 镀锡i昂，作为参数调用 JspServlet 的 doGet 和 doPost 方法；
7. Context 把执行完了之后的 HttpServletResponse 对象返回给 Host；
8. Host 把 HttpServletResponse 对象返回给 Engine；
9. Engine 把 HttpServeletResponse 对象返回给 Connector；
10. Connetor HttpServletResponse 对象返回给客户 browser。

 详解

　　server.xml 的详细配置注解如下：

<?xml version='1.0' encoding='utf-8'?>

<!--启动Server在端口8005处等待关闭命令，如果接收到“SHUTDOWN”字符串则关闭服务器-->
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <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 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>

  <!--Tomcat的Standalone Service，name用于指定service的名称，是一组 Connector 的集合，它们共用一个 Engine 来处理客户请求-->
  <Service name="Catalina">
    <!--Connector 表示客户端和Service之间的链接
    port 指定服务器端要创建的端口号，并在这个端口监听来自客户端的请求
    minProcessors 服务器启动时创建的处理请求的线程数
    maxProcessors 最大可以创建的处理请求的线程数
    enableLookupas 如果为true，则可以通过调用 request.getRemoteHost()进行 DNS 查询来得到远程客户端的实际主机名，若为 false 则不进行DNS查询，
　　　　而返回的是其IP地址；
    redirectPort 指定服务正在处理 http 请求时收到了一个 SSL 传输请求后重定向的端口号
    acceptCount 指定当前所有可以使用的处理请求的线程都被使用时，可以放到处理队列中的请求数，超过这个数的请求将不予处理
    connectionTimeout 指定超时的时间数（单位：毫秒）
    下面的示例中：第一个监听器监听8080端口，负责建立HTTP连接，在通过浏览器访问Tomcat服务器的Web应用时，使用的就是这个连接器；第二个连接器监听8009
　　　　端口，负责和其他的HTTP服务器建立连接，在Tomcat与其他HTTP服务器集成时，就需要用到这个连接器。
    -->
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

    <!--表示指定 service 中请求处理引擎，接收和处理来自 Connector 的请求
    defaultHost 指定缺省的处理请求的主机名，它至少与其中的一个host元素的name属性值是一样的
    -->
    <Engine name="Catalina" defaultHost="localhost">
      <!--表示存放用户名，密码，以及role的数据库-->
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

      <!--表示一个虚拟主机
      name 指定主机名
      appBase 应用程序基本目录，即存放应用程序的目录
      unpackWARs 如果为true，则tomcat会自动将war文件解压，否则不解压，直接从war文件中运行应用程序
      -->
      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

        <!--表示日志、调试和错误信息
        prefix 指定log文件的前缀
        suffix 指定log文件的后缀
        pattern 有两个值，common方式记录远程主机名或ip地址、用户名、日期、第一样请求的字符串、HTTP响应代码、发送的字节数，combinded方式比common方式记录的值更多
        -->
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log." suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
    
        <!--表示一个web应用程序，通常为war文件
        docBase 应用程序的路径或者是war文件存放的路径
        path 表示此web应用程序的url的前缀，这样请求的url为http://localhost:8080/path/***
        reloadable 这个属性非常重要，如果为true，则tomcat会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes目录的变化，自动装载新的应用程序，我们可以在不重启tomcat
        的情况下改变应用程序        
        -->
        <Context path="" docBase="" />
        
        <!--表示日志、调试和错误信息
        prefix 指定log文件的前缀
        suffix 指定log文件的后缀
        timestamp 如果为tur，则log文件名中要加入时间，如：localhost_log.001-12-22.txt-->
        <Logger className="org.apache.catalina.logger.FileLogger"/>
      </Host>
    </Engine>
  </Service>
</Server>