Tomcat 服务器核心配置解析

Tomcat 服务器核心配置解析

Tomcat服务器核心配置文件路径 Tomcat目录下的\conf\server.xml

注意：

• Tomcat 作为服务器的配置，主要是 server.xml 文件的配置
• server.xml 中包含了 Servlet 容器的相关配置，即 Catalina 的配置

主要标签结构如下：

<!--  Server 根元素，创建⼀个Server实例，⼦标签有 Listener、GlobalNamingResources、Service  -->
<Server>
    <!--  定义监听器  -->
    <Listener/>
    <!--  定义服务器的全局JNDI资源  -->
    <GlobalNamingResources/>
    <!--  定义⼀个Service服务，⼀个Server标签可以有多个Service服务实例  -->
    <Service/>
</Server>

Server 标签

<?xml version="1.0" encoding="UTF-8"?>
<!-- port:关闭服务器的监听端口	shutdown：关闭服务器的指令字符串  -->
<Server port="8005" shutdown="SHUTDOWN">
  <!-- 以日志形式输出服务器、操作系统、JVM的版本信息 -->
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <!-- 加载（服务器启动）和销毁（服务器停止）APR。如果找不到APR库，则会输出日志，并且不影响Tomcat启动 -->
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <!-- 避免JRE内存泄漏问题 -->
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
  <!-- 加载（服务器启动） 和 销毁（服务器停⽌） 全局命名服务 -->
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
  <!-- 在Context停⽌时重建 Executor 池中的线程， 以避免ThreadLocal 相关的内存泄漏 -->
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

  <!--  GlobalNamingResources 中定义了全局命名服务 -->
  <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 name="Catalina">
	......
  </Service>
</Server>

Service 标签

<!-- 
	该标签⽤于创建 Service 实例，默认使⽤ org.apache.catalina.core.StandardService。 
	默认情况下，Tomcat 仅指定了Service 的名称， 值为 "Catalina"。
	Service ⼦标签为 ： Executor、Connector、Engine，
-->
<Service name="Catalina">
	<!-- ⽤于配置Service 共享线程池 -->
    <Executor/>
    <!-- ⽤于配置Service 包含的链接器 -->
    <Connector/>
    <!-- ⽤于配置Service中链接器对应的Servlet 容器引擎 -->
	<Engine/>
</Service>

Executor 标签

<!-- 
	默认情况下，Service并未添加共享线程池配置，如果我们想添加一个共享线程池，可以在<Service>下添加配置：
 	name：线程池名称
	namePrefix: 所创建的线程名称前缀（线程前缀+线程号）
	maxThreads：池中最大线程数
	minSpareThreads：活跃线程数，也就是核⼼池线程数，这些线程不会被销毁，会⼀直存在
 	maxIdleTime：线程空闲时间，超过该时间后，空闲线程会被销毁，默认值为6000（1分钟），单位毫秒
 	maxQueueSize：在被执⾏前最⼤线程排队数⽬，默认为Int的最⼤值，也就是⼴义的⽆限。除⾮特殊情况，这个值不需要更改，否则会有请求不会被处理的情况发⽣
 	prestartminSpareThreads：启动线程池时是否启动 minSpareThreads部分线程。默认值为false，即不启动
 	threadPriority：线程池中线程优先级，默认值为5，值从1到10
 	className：线程池实现类，未指定情况下，默认实现类为org.apache.catalina.core.StandardThreadExecutor。如果想使⽤自定义线程池⾸先需要实现org.apache.catalina.Executor接口
-->
<Executor name="commonThreadPool"
          namePrefix="thread-exec-"
          maxThreads="200"
          minSpareThreads="100"
          maxIdleTime="60000"
          maxQueueSize="Integer.MAX_VALUE"
          prestartminSpareThreads="false"
          threadPriority="5"
          className="org.apache.catalina.core.StandardThreadExecutor"/>

Connector 标签

<!-- 
 Connector 标签用于创建链接器实例，默认情况下，server.xml配置了两个链接器，一个支持HTTP协议，一个支持AJP协议
 大多数情况下，我们并不需要新增链接器配置，只是需根据需要对已有链接器对已有链接器进行优化

port：
端口号，Connector ⽤于创建服务端Socket 并进行监听， 以等待客户端请求链接。如果该属性设置为0， Tomcat将会随机选择⼀个可用的端口号给当前Connector 使用

protocol：
当前Connector ⽀持的访问协议。 默认为 HTTP/1.1 ， 并采⽤⾃动切换机制选择⼀个基于 JAVA NIO 的链接器或者基于本地APR的链接器（根据本地是否含有Tomcat的本地库判定）

connectionTimeOut:
Connector 接收链接后的等待超时时间， 单位为 毫秒。 -1 表示不超时。

redirectPort：
当前Connector 不⽀持SSL请求， 接收到了⼀个请求， 并且也符合security-constraint 约束，需要SSL传输，Catalina⾃动将请求重定向到指定的端⼝。

executor：
指定共享线程池的名称， 也可以通过maxThreads、minSpareThreads 等属性配置内部线程池。

-->
<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

Engine 标签

<!--
Engine 表示 Servlet 引擎

name： 用于指定 Engine 的名称， 默认为Catalina
defaultHost：默认使⽤的虚拟主机名称， 当客户端请求指向的主机⽆效时， 将交由默认的虚拟主机处
理， 默认为localhost
-->
<Engine name="Catalina" defaultHost="localhost">
 ...
</Engine>

Host 标签

<!-- Host 标签⽤于配置⼀个虚拟主机 -->
<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
 ...
</Host>

Context 标签

<Host name="www.abc.com" appBase="webapps" unpackWARs="true"
      autoDeploy="true">
    <!--
 docBase：Web应⽤⽬录或者War包的部署路径。可以是绝对路径，也可以是相对于 Host appBase的
相对路径。
 path：Web应⽤的Context 路径。如果我们Host名为localhost， 则该web应⽤访问的根路径为：
 http://localhost:8080/web_demo。
-->
    <Context docBase="/Users/yingdian/web_demo" path="/web3"></Context>

    <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>