server.xml 解析

server.xml的结构：

常用配置的参数注释：

<?xml version='1.0' encoding='utf-8'?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<!-- Note:  A "Server" is not itself a "Container", so you may not
     define subcomponents such as "Valves" at this level.
     Documentation at /docs/config/server.html
 -->
<Server port="8005" shutdown="SHUTDOWN">
<!--tomcat 的关闭端口 -->

  <!--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" />
  <!-- JMX Support for the Tomcat server. Documentation at /docs/non-existent.html -->
  <Listener className="org.apache.catalina.mbeans.ServerLifecycleListener" />
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />

  <!-- Global JNDI resources
       Documentation at /docs/jndi-resources-howto.html
  -->
  <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>

  <!-- A "Service" is a collection of one or more "Connectors" that share
       a single "Container" Note:  A "Service" is not itself a "Container",
       so you may not define subcomponents such as "Valves" at this level.
       Documentation at /docs/config/service.html
   -->
  <Service name="Catalina">

    <!--The connectors can use a shared executor, you can define one or more named thread pools-->

    <Executor name="tomcatThreadPool" namePrefix="catalina-exec-" maxThreads="150" minSpareThreads="4"/>
         <!--最大 maxThreads 最小线程数 minSpareThreads-->

    <!-- A "Connector" represents an endpoint by which requests are received
         and responses are returned. Documentation at :
         Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)
         Java AJP  Connector: /docs/config/ajp.html
         APR (HTTP/AJP) Connector: /docs/apr.html
         Define a non-SSL HTTP/1.1 Connector on port 8080
    -->
    <!--
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />-->
    <!-- A "Connector" using the shared thread pool-->
    <!-- executor="tomcatThreadPool" 加载线程池的配置-->
    <Connector executor="tomcatThreadPool"
               port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
<!--
1.maxThreads：设定处理客户请求的线程的最大数目，这个值也决定了服务器可以同时响应客户请求的最大数目，默认值为200.
2.minSpareThreads：设置Tomcat初始化时创建的socket 线程数，默认值为4.
3.maxSpareThreads:设置Tomcat连接器最大空闲socket 线程数，默认值为150.
4.enableLookup：如果设为true,表示支持域名解析，可以把IP地址解析为主机名。Web应用调用request、getRemostltost方法将返回客户的主机名，默认属性是为true。
5.redirectPort：指定转发端口。
6.acceptCount：设定在监听端口队列中的最大客户请求数，默认值为100，如果队列已满客户请求将被拒绝。
7.connectionTimeout：定义建立客户连接超时的时间，默认这为20000毫秒。如果为-1，表示不限制建立客户连接的时间。
8.minProcessors：服务器启动时创建的最小处理线程数，即使没有任何HTTP请求，Tomcat也要保持至少这么多线程以等待处理。
9.maxProcessors：同时最大的处理线程数，如果系统中已经有这个数字的线程，那么更多的连接请求将进入排队。
10.useBodyEncodingForURI：表示是否用request.setCharacterEncoding参数对URL提交的数据和表单中GET方式提交的数据进行重新编码，默认值是false.
-->
    <!-- Define a SSL HTTP/1.1 Connector on port 8443
         This connector uses the JSSE configuration, when using APR, the
         connector should be using the OpenSSL style configuration
         described in the APR documentation -->
    <!--
    <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
               maxThreads="150" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS" />
    -->

    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

    <!-- An Engine represents the entry point (within Catalina) that processes
         every request.  The Engine implementation for Tomcat stand alone
         analyzes the HTTP headers included with the request, and passes them
         on to the appropriate Host (virtual host).
         Documentation at /docs/config/engine.html -->

    <!-- You should set jvmRoute to support load-balancing via AJP ie :
    <Engine name="Catalina" defaultHost="localhost" jvmRoute="jvm1">
    -->
    <Engine name="Catalina" defaultHost="localhost">

      <!--For clustering, please take a look at documentation at:
          /docs/cluster-howto.html  (simple how to)
          /docs/config/cluster.html (reference documentation) -->
      <!--
      <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
      -->        

      <!-- The request dumper valve dumps useful debugging information about
           the request and response data received and sent by Tomcat.
           Documentation at: /docs/config/valve.html -->
      <!--
      <Valve className="org.apache.catalina.valves.RequestDumperValve"/>
      -->

      <!-- This Realm uses the UserDatabase configured in the global JNDI
           resources under the key "UserDatabase".  Any edits
           that are performed against this UserDatabase are immediately
           available for use by the Realm.  -->
      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
             resourceName="UserDatabase"/>

      <!-- Define the default virtual host
           Note: XML Schema validation will not work with Xerces 2.2.
       -->
       <!--name 指定主机名-->
       <!--appBase 应用程序基本目录，即存放应用程序的目录-->
       <!--unpackWARs 如果为true，则tomcat会自动将WAR文件解压，否则不解压，直接从WAR文件中运行应用程序-->
      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true"
            xmlValidation="false" xmlNamespaceAware="false">

        <!-- SingleSignOn valve, share authentication between web applications
             Documentation at: /docs/config/valve.html -->
        <!--
        <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
        -->

        <!-- Access log processes all example.
             Documentation at: /docs/config/valve.html -->
        <!-- directory="logs" tomcat下的目录，可以改名称或者用绝对地址，会生成新的目录-->
        <!-- fileDateFormat="yyyy-MM-dd" rotatable="true" 日志切割 fileDateFormat参数决定 时间改变就会新建一个日志-->
        <!--prefix="localhost_access_log." suffix=".txt"  前缀和后缀-->
        <!--pattern="method: %m, client ip: %a, time: %t, &quot; %r &quot; statusCode: %s, byteSent: %b, User-Agent: %{User-Agent}i" 日志格式-->
        <Valve className="org.apache.catalina.valves.AccessLogValve"
        directory="logs"
        fileDateFormat="yyyy-MM-dd" rotatable="true"
        prefix="localhost_access_log." suffix=".txt"
        pattern="method: %m, client ip: %a, time: %t, &quot; %r &quot; statusCode: %s, byteSent: %b, User-Agent: %{User-Agent}i" resolveHosts="false"/>
        <!--Context(表示一个web应用程序，通常为WAR文件，关于WAR的具体信息见servlet规范)-->
        <!--docBase 应用程序的路径或者是WAR文件存放的路径-->
        <!--path 表示此web应用程序的url的前缀，这样请求的url为http://localhost:8080/path/****-->
        <!--reloadable 这个属性非常重要，如果为true，则tomcat会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes目录的变化，自动装载新的应用程序，我们可以在不重起tomcat的情况下改变应用程序-->
        <Context path="/FaceRecognitionServer" docBase="/home/asr/workspace/FaceRecognitionServer" reloadable="false"/>
      </Host>
    </Engine>
  </Service>
</Server>