tomcat 的 server.xml配置文件

tomcat的配置文件在其安装后生成的conf目录下，其中主配置文件便是conf下的server.xml文件。

server.xml文件由server->service->engine->host->context结构组成。

<?xml version="1.0" encoding="UTF-8"?>
<!--
tomcat实例顶层元素，代表整个容器。由org.apache.catalina.Server接口来定义
port: 使用8005端口监听tomcat服务，当服务端shutdown属性发出"SHUTDOWN"指令时，会终止tomcat服务。
shoudown：向指定8005端口发送的指令字符串，表示关闭(shutdown)，必选属性。 -->
<Server port="8005" shutdown="SHUTDOWN">
    <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
    <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
    <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>

    <!--
    service标签下包含了一个或者多个connector标签和一个engine标签，
    主要负责接收由客户端浏览器直接发来和其他web服务器(如apache)转发来的请求。
    name:Service的名称  -->
    <Service name="Catalina">
        <!--
        表示在8080端口使用http协议直接接收来自客户端的请求,然后将请求交给engine来处理。
        port:服务器连接器的端口号,该连接器将在指定端口侦听来自客户端的请求
        protocal:
        connectionTimeout:等待超时的时间数（以毫秒为单位）
        redirectPort:服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号
        enableLookups:如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名；
                         若为false则不进行DNS查询，而是返回其ip地址
        acceptCount:当所有可以使用的处理请求的线程都被用光时,可以放到处理队列中的请求数,超过这个数 请求将不予处理，
                    而返回Connection refused错误
        maxThreads:设定在监听端口的线程的最大数目,这个值也决定了服务器可以同时响应客户请求的最大数目.默认值为200
        address:如果服务器有两个以上IP地址,该属性可以设定端口监听的IP地址,默认情况下,端口会监听服务器上所有IP地址
        minProcessors:服务器启动时创建的处理请求的线程数，每个请求由一个线程负责
        maxProcessors:最多可以创建的处理请求的线程数
        minSpareThreads:最小备用线程
        maxSpareThreads:最大备用线程
        debug:日志等级
        disableUploadTimeout:禁用上传超时,主要用于大数据上传时
        -->
        <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
        <!--
        表示在8009端口使用ajp协议接收来自其他web服务器转发来的请求，然后将请求交给engine来处理。 -->
        <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
        <!--
        每一个service标签只能有一个engine元素。engine元素下面可以配置多个虚拟主机，每一个虚拟主机有一个域名。 -->
        <!--
        engine收到请求后，会将该请求匹配到某一个host上，然后由该host来处理。
        engine定义了一个默认的host，当请求无法匹配到任何一个host上时，就由该默认的host来处理。
        name:对应$CATALINA_HOME/config/Catalina中的Catalina
        defaultHost:对应Host元素中的name属性,也就是和$CATALINA_HOME/config/Catalina/localhost中的localhost
        缺省的处理请求的虚拟主机名，它至少与其中的一个Host元素的name属性值是一样的
        debug:日志等级
         -->
        <Engine name="Catalina" defaultHost="localhost">

            <Realm className="org.apache.catalina.realm.LockOutRealm">

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

            </Realm>
            <!--
            一个Engine元素可以包含多个<Host>元素
            在host下可以放web应用程序，每个app都有一个context。host会将获得的请求交给匹配到的context处理。
            每个host代表一个虚拟主机，每个虚拟主机会匹配某个域名。
            name:在此例中一直被强调为$CATALINA_HOME/config/Catalina/localhost中的localhost虚拟主机名
            appBase:默认的应用路径,也就是把应用放在一个目录下,并在autoDeploy为true的情况下,可自动部署应用此路径相对于
            $CATALINA_HOME/ (web applications的基本目录)
            unpackWARs:设置为true,在Web应用为*.war是,解压此WAR文件.如果为true,则tomcat会自动将WAR文件解压;否则不解压,直接从WAR文件中运行应用程序.
            autoDeploy:默认为true,表示如果有新的WEB应用放入appBase 并且Tomcat在运行的情况下,自动载入应
            debug:是日志的调试等级
            -->
            <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 &quot;%r&quot; %s %b" />
                <!--
                一个context表示一个web应用，配置文件里默认没有的话可以手动添加。
                path:访问的URI,如:http://localhost/是我的应用的根目录,
                    访问此应用将用:http://localhost/lime进行操作,此元素必须表示此web application的URL的前缀，
                    用来匹配一个Context。请求的URL形式为http://localhost:8080/path/*
                docBase:WEB应用的目录,此目录必须符合Java WEB应用的规范。web application的文件存放路径或者是WAR文件存放路径
                reloadable:是否在程序有改动时重新载入,设置成true会影响性能,但可自动载入修改后的文件.
                            如果为true，则Tomcat将支持热部署，会自动检测web application的/WEB-INF/lib
                            和/WEB-INF/classes目录的变化，自动装载新的JSP和Servlet，我们可以在不重起
                            Tomcat的情况下改变web application
                debug:日志等级
                 -->
                <context path="lime" docBase=""/>
            </Host>
        </Engine>
    </Service>
</Server>

啦啦啦