我的架構夢：（十五）Tomcat 服務器核心配置詳解

注意：

• Tomcat 作爲服務器的配置，主要是 conf/server.xml 文件的配置；
• server.xml中包含了 Servlet容器的相關配置，即 Catalina 的配置；
• Xml 文件的講解主要是標籤的使用。

一、主要標籤結構

<!--
	Server 根元素，創建一個Server實例，子標籤有 Listener、GlobalNamingResources、
	Service 
--> 
<Server>
	<!--定義監聽器-->
	<Listener/> 
	<!--定義服務器的全局JNDI資源 --> 
	<GlobalNamingResources/> 
	<!--定義一個Service服務，一個Server標籤可以有多個Service服務實例 -->
    <Service/>
</Server>

二、Server 標籤

<!--
	port:關閉服務器的監聽端口 
	shutdown:關閉服務器的指令字符串
-->
<Server port="8005" shutdown="SHUTDOWN">
  <!-- 以日誌形式輸出服務器 、操作系統、JVM的版本信息 -->
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <!-- Security listener. Documentation at /docs/config/listeners.html
  <Listener className="org.apache.catalina.security.SecurityListener" />
  -->
  <!--APR library loader. Documentation at /docs/apr.html -->
  <!-- 加載(服務器啓動) 和 銷燬 (服務器停止) APR。 如果找不到APR庫， 則會輸出日誌， 並不影響 Tomcat啓動 -->
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <!-- Prevent memory leaks due to use of particular java/javax APIs-->
  <!-- 避免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" />

  <!-- Global JNDI resources
       Documentation at /docs/jndi-resources-howto.html
       GlobalNamingResources 中定義了全局命名服務
  -->
  <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">
  	...
  </Service>
</Server>

三、Service 標籤

 
<!--
	該標籤用於創建 Service 實例，默認使用 org.apache.catalina.core.StandardService。 默認情況下，Tomcat 僅指定了Service 的名稱， 值爲 "Catalina"。
	Service 子標籤爲 : Listener、Executor、Connector、Engine，
	其中:
		Listener 用於爲Service添加生命週期監聽器，
		Executor 用於配置Service 共享線程池，
		Connector 用於配置Service 包含的鏈接器，
		Engine 用於配置Service中鏈接器對應的Servlet 容器引擎
-->
<Service name="Catalina">
	...
</Service>

四、Executor 標籤

<!--
	默認情況下，Service 並未添加共享線程池配置。 如果我們想添加一個線程池， 可以在 <Service> 下添加如下配置:
	name:線程池名稱，用於 Connector中指定
	namePrefix:所創建的每個線程的名稱前綴，一個單獨的線程名稱爲 namePrefix+threadNumber
	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 等屬性配置內部線程池。
	URIEncoding:
	用於指定編碼URI的字符編碼， Tomcat8.x版本默認的編碼爲 UTF-8 , Tomcat7.x版本默認爲ISO-
	8859-1
-->
<!--org.apache.coyote.http11.Http11NioProtocol ， 非阻塞式 Java NIO 鏈接器--> 
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

可以使用共享線程池

<Connector port="8080" 
	protocol="HTTP/1.1" 
	executor="commonThreadPool" 
	maxThreads="1000" 
    minSpareThreads="100" 
    acceptCount="1000" 
    maxConnections="1000" 
    connectionTimeout="20000" 
    compression="on" 
    compressionMinSize="2048" 
    disableUploadTimeout="true" 
    redirectPort="8443" 
    URIEncoding="UTF-8" />

六、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 標籤

Context 標籤用於配置一個Web應用，如下:

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