框架源码私享笔记(01)Tomcat核心架构功能 | 配置详解

<Server port="8005" shutdown="SHUTDOWN"> 
  <Service name="Catalina"> 
    <Connector port="8080" protocol="HTTP/1.1"/> 
    <Engine name="Catalina" defaultHost="localhost"> 
      <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true"> 
        <Context path="/ladingjieniu" docBase="ladingjieniu.war"/>  
      </Host> 
    </Engine> 
  </Service> 
</Server> 

<?xml version="1.0" encoding="UTF-8"?>
<!--
Server是tomcat的最顶级容器，是server.xml的最外层标签，代表整个tomcat容器
参数port，是tomcat用来监听shutdown命令的TCP/IP端口号，默认为
8005。设置为-1，表示禁止通过端口关闭Tomcat，此时shutdown.bat/sh命令不能使用。
如果在一台服务器启动多个tomcat服务实例，该端口需保持差异。
shutdown，用来指定shutdown 命令的别名,默认值SHUTDOWN
-->
<Server port="8005" shutdown="SHUTDOWN">
    <!--监听器组件,不同组件功能不一样-->
    <Listener className="org.apache.catalina.startup.VersionLoggerListener"/>
    <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on"/>
    
    <!--配置全局JNDI资源-->
    <GlobalNamingResources>
        <!-- 用户数据库Realm，配合tomcat-users.xml，管理tomcat host manager的用户身份验证 -->
        <Resource name="ladingjieniu" 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>

    <!--
     一个server里有多个service，里面有一个engine和多个connector。相当于一个服务
     可以配置多个connector去监听外部请求，并在engine Servlet处理。
    -->
    <Service name="Catalina">
        <!-- 供Service内各个Connector组件共享使用的线程池执行器，我们可以定义多个命名线程池 -->
        <!--
        配置连接器使用连接池参数：
        maxThreads：最大并发数
        minSpareThreads：线程池的核心线程数
        maxIdleTime：Executor中空闲线程超时关闭的毫秒数，默认1分钟
        maxConnections 与tomcat建立的最大socket连接数，默认是10000
        acceptCount；请求的队列最大长度，默认是100
        -->
        <Executor name="tomcatThreadPool" namePrefix="ladingjieniushuojishu-exec-"
            maxThreads="100" minSpareThreads="50"/>

        <!-- 连接器组件，负责接收和响应连接，然后创建Request和Response对象转发给engine
             默认连接器，监听端口8080，并支持HTTP/1.1协议，支持指定命名共享线程池的连接器。
             port:连接器监听的请求端口，必须唯一
             protocol：连接器监听的请求协议类型,默认是http/1.1
             redirectPort：如果当前连接器不支持SSL（HTTPS）请求，但是收到SSL（HTTPS）请求时，Catalina将重定向至指定端口的Connector。
             URIEncoding：用于解码URL的字符编码，则默认使用 UTF-8。
             connectionTimeout：此连接器在建立连接之后等待请求URI的超时时间（毫秒），默认值为60000（即 60秒）。
             当client与tomcat建立连接之后，在"connectionTimeout"时间之内，仍然没有得到client的请求数据，此时连接将会被断开。
             maxConnections：tomcat在任何给定时间能同时接收和处理的最大连接数，默认1w。
             acceptCount：当同时连接数超过maxConnections时，系统会继续接收连接，并放入Accept等待队列的长度，默认是100.
             同时连接数超过maxConnections，且等待队列也放满，后续收到的请求都将被直接拒绝。
             
        -->
        <Connector port="8080" protocol="HTTP/1.1"
                   connectionTimeout="20000" executor="tomcatThreadPool"
                   redirectPort="8443"/>

        <!--在端口8009上定义使用AJP/1.3协议访问的连接器-->
        <!--
        <Connector protocol="AJP/1.3"
                   address="::1"
                   port="8009"
                   redirectPort="8443" />
        -->

        <!--
        请求处理组件，一个Service标签只能有一个Engine标签
        Engine组件从一个或多个Connector中接收请求并处理，并将完成的响应返回给Connector，最终响应给客户端。
        -->
        <Engine name="Catalina" defaultHost="localhost">
            <!--
            一个虚拟主机，可以指定应用程序的基本目录，包含了一个或多个Web应用
            默认的虚拟主机名为"localhost"，
            如果配置多个Host，可以让一个tomcat支持从不同的域名访问Web应用。
            autoDeploy ： Tomcat 在 运行时应定期检查新的或更新的 Web 应用程序。
            appBase ：虚拟主机的应用程序基础目录。
            unpackWARs：是否将Web应用的WAR文件解压。如果为true，则先解压然后运行解压的Web应用，如果为false，直接使用WAR文件运行Web应用。
            -->
            <Host name="localhost" appBase="webapps"
                  unpackWARs="true" autoDeploy="true">
                <!--通过日志记录在该Host中处理的相关请求-->
                <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"/>
            </Host>
            <!--
            支持配置多个web服务，域名映射， 需要修改本地hosts文件 。
            -->
            <Host name="www.ladingjieniu.com" appBase="lading" unpackWARs="true" autoDeploy="true">
            <!-- 
            Context的path，表示该 Web 应用程序的虚拟上下文路径。
            docBase，表示web应用程序的物理根目录，若该路径是相对路径的话，则是相对于appBase而言，若是绝对路径，则与appBase无关。
            reloadable是否支持重新加载web应用程序类，默认为false。
            如果设为true，Tomcat服务器在运行时会监视在WEB-INF/classes和Web-INF/lib目录下的class文件变化，服务器自重新加载该Web应用。

            -->
                  <Context docBase="/app/ladingjieniu/myweb-1.0-SNAPSHOT" path="/myweb" reloadable="true" />
            </Host>
        </Engine>
    </Service>
</Server>