詳解Tomcat 配置文件server.xml

前言

Tomcat隸屬於Apache基金會,是開源的輕量級Web應用服務器,使用很是普遍。server.xml是Tomcat中最重要的配置文件,server.xml的每個元素都對應了Tomcat中的一個組件;經過對xml文件中元素的配置,能夠實現對Tomcat中各個組件的控制。所以,學習server.xml文件的配置,對於瞭解和使用Tomcat相當重要。javascript

本文將經過實例,介紹server.xml中各個組件的配置,並詳細說明Tomcat各個核心組件的做用以及各個組件之間的相互關係。html

說明:因爲server.xml文件中元素與Tomcat中組件的對應關係,後文中爲了描述方便,「元素」和「組件」的使用不嚴格區分。java

若是以爲文章對你有幫助,歡迎點贊或轉載。文章有疏漏之處,歡迎批評指正。nginx

目錄

1、一個server.xml配置實例

server.xml位於$TOMCAT_HOME/conf目錄下;下面是一個server.xml實例。後文中將結合該實例講解server.xml中,各個元素的含義和做用;在閱讀後續章節過程當中,能夠對照該xml文檔便於理解。

複製代碼
 1 <Server port="8005" shutdown="SHUTDOWN">
 2   <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
 3   <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
 4   <Listener className="org.apache.catalina.core.JasperListener" />
 5   <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
 6   <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
 7   <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
 8 
 9   <GlobalNamingResources>
10     <Resource name="UserDatabase" auth="Container"
11               type="org.apache.catalina.UserDatabase"
12               description="User database that can be updated and saved"
13               factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
14               pathname="conf/tomcat-users.xml" />
15   </GlobalNamingResources>
16  
17   <Service name="Catalina">
18     <Connector port="8080" protocol="HTTP/1.1"
19                connectionTimeout="20000"
20                redirectPort="8443" />
21     <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
22     <Engine name="Catalina" defaultHost="localhost">
23       <Realm className="org.apache.catalina.realm.LockOutRealm">
24         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
25                resourceName="UserDatabase"/>
26       </Realm>
27  
28       <Host name="localhost"  appBase="webapps"
29             unpackWARs="true" autoDeploy="true">
30         <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
31                prefix="localhost_access_log." suffix=".txt"
32                pattern="%h %l %u %t &quot;%r&quot; %s %b" />
33       </Host>
34     </Engine>
35   </Service>
36 </Server>
複製代碼

2、server.xml文檔的元素分類和總體結構

一、總體結構

server.xml的總體結構以下:

複製代碼
 1 <Server>
 2     <Service>
 3         <Connector />
 4         <Connector />
 5         <Engine>
 6             <Host>
 7                 <Context /><!-- 如今經常使用自動部署,不推薦配置Context元素,Context小節有詳細說明 -->
 8             </Host>
 9         </Engine>
10     </Service>
11 </Server>
複製代碼

該結構中只給出了Tomcat的核心組件,除了核心組件外,Tomcat還有一些其餘組件,下面介紹一下組件的分類。

二、元素分類

server.xml文件中的元素能夠分爲如下4類:

(1)頂層元素:<Server>和<Service>

<Server>元素是整個配置文件的根元素,<Service>元素則表明一個Engine元素以及一組與之相連的Connector元素。

(2)鏈接器:<Connector>

<Connector>表明了外部客戶端發送請求到特定Service的接口;同時也是外部客戶端從特定Service接收響應的接口。

(3)容器:<Engine><Host><Context>

容器的功能是處理Connector接收進來的請求,併產生相應的響應。Engine、Host和Context都是容器,但它們不是平行的關係,而是父子關係:Engine包含Host,Host包含Context。一個Engine組件能夠處理Service中的全部請求,一個Host組件能夠處理髮向一個特定虛擬主機的全部請求,一個Context組件能夠處理一個特定Web應用的全部請求。

(4)內嵌組件:能夠內嵌到容器中的組件。實際上,Server、Service、Connector、Engine、Host和Context是最重要的最核心的Tomcat組件,其餘組件均可以歸爲內嵌組件。

下面將詳細介紹Tomcat中各個核心組件的做用,以及相互之間的關係。

3、核心組件

本部分將分別介紹各個核心組件的做用、特色以及配置方式等。

一、Server

Server元素在最頂層,表明整個Tomcat容器,所以它必須是server.xml中惟一一個最外層的元素。一個Server元素中能夠有一個或多個Service元素。

在第一部分的例子中,在最外層有一個<Server>元素,shutdown屬性表示關閉Server的指令;port屬性表示Server接收shutdown指令的端口號,設爲-1能夠禁掉該端口。

Server的主要任務,就是提供一個接口讓客戶端可以訪問到這個Service集合,同時維護它所包含的全部的Service的聲明週期,包括如何初始化、如何結束服務、如何找到客戶端要訪問的Service。

二、Service

Service的做用,是在Connector和Engine外面包了一層,把它們組裝在一塊兒,對外提供服務。一個Service能夠包含多個Connector,可是隻能包含一個Engine其中Connector的做用是從客戶端接收請求,Engine的做用是處理接收進來的請求。

在第一部分的例子中,Server中包含一個名稱爲「Catalina」的Service。實際上,Tomcat能夠提供多個Service,不一樣的Service監聽不一樣的端口,後文會有介紹。

三、Connector

Connector的主要功能,是接收鏈接請求,建立Request和Response對象用於和請求端交換數據;而後分配線程讓Engine來處理這個請求,並把產生的Request和Response對象傳給Engine。

經過配置Connector,能夠控制請求Service的協議及端口號。在第一部分的例子中,Service包含兩個Connector:

1 <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
2 <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

(1)經過配置第1個Connector,客戶端能夠經過8080端口號使用http協議訪問Tomcat。其中,protocol屬性規定了請求的協議,port規定了請求的端口號,redirectPort表示當強制要求https而請求是http時,重定向至端口號爲8443的Connector,connectionTimeout表示鏈接的超時時間。

在這個例子中,Tomcat監聽HTTP請求,使用的是8080端口,而不是正式的80端口;實際上,在正式的生產環境中,Tomcat也經常監聽8080端口,而不是80端口。這是由於在生產環境中,不多將Tomcat直接對外開放接收請求,而是在Tomcat和客戶端之間加一層代理服務器(如nginx),用於請求的轉發、負載均衡、處理靜態文件等;經過代理服務器訪問Tomcat時,是在局域網中,所以通常仍使用8080端口。

(2)經過配置第2個Connector,客戶端能夠經過8009端口號使用AJP協議訪問Tomcat。AJP協議負責和其餘的HTTP服務器(如Apache)創建鏈接;在把Tomcat與其餘HTTP服務器集成時,就須要用到這個鏈接器。之因此使用Tomcat和其餘服務器集成,是由於Tomcat能夠用做Servlet/JSP容器,可是對靜態資源的處理速度較慢,不如Apache和IIS等HTTP服務器;所以經常將Tomcat與Apache等集成,前者做Servlet容器,後者處理靜態資源,而AJP協議便負責Tomcat和Apache的鏈接。Tomcat與Apache等集成的原理以下圖(圖片來源):

關於Connector的更多內容,能夠參考個人另外一篇文章:詳解tomcat的鏈接數與線程池

四、Engine

Engine組件在Service組件中有且只有一個;Engine是Service組件中的請求處理組件。Engine組件從一個或多個Connector中接收請求並處理,並將完成的響應返回給Connector,最終傳遞給客戶端。

前面已經提到過,Engine、Host和Context都是容器,但它們不是平行的關係,而是父子關係:Engine包含Host,Host包含Context。

在第一部分的例子中,Engine的配置語句以下:

1 <Engine name="Catalina" defaultHost="localhost">

其中,name屬性用於日誌和錯誤信息,在整個Server中應該惟一。defaultHost屬性指定了默認的host名稱,當發往本機的請求指定的host名稱不存在時,一概使用defaultHost指定的host進行處理;所以,defaultHost的值,必須與Engine中的一個Host組件的name屬性值匹配。

五、Host

(1)Engine與Host

Host是Engine的子容器。Engine組件中能夠內嵌1個或多個Host組件,每一個Host組件表明Engine中的一個虛擬主機。Host組件至少有一個,且其中一個的name必須與Engine組件的defaultHost屬性相匹配。

(2)Host的做用

Host虛擬主機的做用,是運行多個Web應用(一個Context表明一個Web應用),並負責安裝、展開、啓動和結束每一個Web應用。

Host組件表明的虛擬主機,對應了服務器中一個網絡名實體(如」www.test.com」,或IP地址」116.25.25.25」);爲了使用戶能夠經過網絡名鏈接Tomcat服務器,這個名字應該在DNS服務器上註冊。

客戶端一般使用主機名來標識它們但願鏈接的服務器;該主機名也會包含在HTTP請求頭中。Tomcat從HTTP頭中提取出主機名,尋找名稱匹配的主機。若是沒有匹配,請求將發送至默認主機。所以默認主機不須要是在DNS服務器中註冊的網絡名,由於任何與全部Host名稱不匹配的請求,都會路由至默認主機。

(3)Host的配置

在第一部分的例子中,Host的配置以下:

1 <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">

下面對其中配置的屬性進行說明:

name屬性指定虛擬主機的主機名,一個Engine中有且僅有一個Host組件的name屬性與Engine組件的defaultHost屬性相匹配;通常狀況下,主機名須要是在DNS服務器中註冊的網絡名,可是Engine指定的defaultHost不須要,緣由在前面已經說明。

unpackWARs指定了是否將表明Web應用的WAR文件解壓;若是爲true,經過解壓後的文件結構運行該Web應用,若是爲false,直接使用WAR文件運行Web應用。

Host的autoDeploy和appBase屬性,與Host內Web應用的自動部署有關;此外,本例中沒有出現的xmlBase和deployOnStartup屬性,也與Web應用的自動部署有關;將在下一節(Context)中介紹。

六、Context

(1)Context的做用

Context元素表明在特定虛擬主機上運行的一個Web應用。在後文中,提到Context、應用或Web應用,它們指代的都是Web應用。每一個Web應用基於WAR文件,或WAR文件解壓後對應的目錄(這裏稱爲應用目錄)。

Context是Host的子容器,每一個Host中能夠定義任意多的Context元素。

在第一部分的例子中,能夠看到server.xml配置文件中並無出現Context元素的配置。這是由於,Tomcat開啓了自動部署,Web應用沒有在server.xml中配置靜態部署,而是由Tomcat經過特定的規則自動部署。下面介紹一下Tomcat自動部署Web應用的機制。

(2)Web應用自動部署

Host的配置

要開啓Web應用的自動部署,須要配置所在的虛擬主機;配置的方式就是前面提到的Host元素的deployOnStartup和autoDeploy屬性。若是deployOnStartup和autoDeploy設置爲true,則tomcat啓動自動部署:當檢測到新的Web應用或Web應用的更新時,會觸發應用的部署(或從新部署)。兩者的主要區別在於,deployOnStartup爲true時,Tomcat在啓動時檢查Web應用,且檢測到的全部Web應用視做新應用;autoDeploy爲true時,Tomcat在運行時按期檢查新的Web應用或Web應用的更新。除此以外,兩者的處理類似。

經過配置deployOnStartup和autoDeploy能夠開啓虛擬主機自動部署Web應用;實際上,自動部署依賴於檢查是否有新的或更改過的Web應用,而Host元素的appBase和xmlBase設置了檢查Web應用更新的目錄。

其中,appBase屬性指定Web應用所在的目錄,默認值是webapps,這是一個相對路徑,表明Tomcat根目錄下webapps文件夾。

xmlBase屬性指定Web應用的XML配置文件所在的目錄,默認值爲conf/<engine_name>/<host_name>,例如第一部分的例子中,主機localhost的xmlBase的默認值是$TOMCAT_HOME/conf/Catalina/localhost。

檢查Web應用更新

一個Web應用可能包括如下文件:XML配置文件,WAR包,以及一個應用目錄(該目錄包含Web應用的文件結構);其中XML配置文件位於xmlBase指定的目錄,WAR包和應用目錄位於appBase指定的目錄。

Tomcat按照以下的順序進行掃描,來檢查應用更新:

A、掃描虛擬主機指定的xmlBase下的XML配置文件

B、掃描虛擬主機指定的appBase下的WAR文件

C、掃描虛擬主機指定的appBase下的應用目錄

<Context>元素的配置

Context元素最重要的屬性是docBase和path,此外reloadable屬性也比較經常使用。

docBase指定了該Web應用使用的WAR包路徑,或應用目錄。須要注意的是,在自動部署場景下(配置文件位於xmlBase中),docBase不在appBase目錄中,才須要指定;若是docBase指定的WAR包或應用目錄就在docBase中,則不須要指定,由於Tomcat會自動掃描appBase中的WAR包和應用目錄,指定了反而會形成問題。

path指定了訪問該Web應用的上下文路徑,當請求到來時,Tomcat根據Web應用的 path屬性與URI的匹配程度來選擇Web應用處理相應請求。例如,Web應用app1的path屬性是」/app1」,Web應用app2的path屬性是」/app2」,那麼請求/app1/index.html會交由app1來處理;而請求/app2/index.html會交由app2來處理。若是一個Context元素的path屬性爲」」,那麼這個Context是虛擬主機的默認Web應用;當請求的uri與全部的path都不匹配時,使用該默認Web應用來處理。

可是,須要注意的是,在自動部署場景下(配置文件位於xmlBase中),不能指定path屬性,path屬性由配置文件的文件名、WAR文件的文件名或應用目錄的名稱自動推導出來。如掃描Web應用時,發現了xmlBase目錄下的app1.xml,或appBase目錄下的app1.WAR或app1應用目錄,則該Web應用的path屬性是」app1」。若是名稱不是app1而是ROOT,則該Web應用是虛擬主機默認的Web應用,此時path屬性推導爲」」。

reloadable屬性指示tomcat是否在運行時監控在WEB-INF/classes和WEB-INF/lib目錄下class文件的改動。若是值爲true,那麼當class文件改動時,會觸發Web應用的從新加載。在開發環境下,reloadable設置爲true便於調試;可是在生產環境中設置爲true會給服務器帶來性能壓力,所以reloadable參數的默認值爲false。

下面來看自動部署時,xmlBase下的XML配置文件app1.xml的例子:

1 <Context docBase="D:\Program Files\app1.war" reloadable="true"/>

在該例子中,docBase位於Host的appBase目錄以外;path屬性沒有指定,而是根據app1.xml自動推導爲」app1」;因爲是在開發環境下,所以reloadable設置爲true,便於開發調試。

自動部署舉例

最典型的自動部署,就是當咱們安裝完Tomcat後,$TOMCAT_HOME/webapps目錄下有以下文件夾:

當咱們啓動Tomcat後,可使用http://localhost:8080/來訪問Tomcat,其實訪問的就是ROOT對應的Web應用;咱們也能夠經過http://localhost:8080/docs來訪問docs應用,同理咱們能夠訪問examples/host-manager/manager這幾個Web應用。

(3)server.xml中靜態部署Web應用

除了自動部署,咱們也能夠在server.xml中經過<context>元素靜態部署Web應用。靜態部署與自動部署是能夠共存的。在實際應用中,並不推薦使用靜態部署,由於server.xml 是不可動態重加載的資源,服務器一旦啓動了之後,要修改這個文件,就得重啓服務器才能從新加載。而自動部署能夠在Tomcat運行時經過按期的掃描來實現,不須要重啓服務器。

server.xml中使用Context元素配置Web應用,Context元素應該位於Host元素中。舉例以下:

1 <Context path="/" docBase="D:\Program Files \app1.war" reloadable="true"/>

docBase:靜態部署時,docBase能夠在appBase目錄下,也能夠不在;本例中,docBase不在appBase目錄下。

path:靜態部署時,能夠顯式指定path屬性,可是仍然受到了嚴格的限制:只有當自動部署徹底關閉(deployOnStartup和autoDeploy都爲false)或docBase不在appBase中時,才能夠設置path屬性。在本例中,docBase不在appBase中,所以path屬性能夠設置。

reloadable屬性的用法與自動部署時相同。

4、核心組件的關聯

一、總體關係

核心組件之間的總體關係,在上一部分有所介紹,這裏總結一下:

Server元素在最頂層,表明整個Tomcat容器;一個Server元素中能夠有一個或多個Service元素。

Service在Connector和Engine外面包了一層,把它們組裝在一塊兒,對外提供服務。一個Service能夠包含多個Connector,可是隻能包含一個Engine;Connector接收請求,Engine處理請求。

Engine、Host和Context都是容器,且 Engine包含Host,Host包含Context。每一個Host組件表明Engine中的一個虛擬主機;每一個Context組件表明在特定Host上運行的一個Web應用。

二、如何肯定請求由誰處理?

當請求被髮送到Tomcat所在的主機時,如何肯定最終哪一個Web應用來處理該請求呢?

(1)根據協議和端口號選定Service和Engine

Service中的Connector組件能夠接收特定端口的請求,所以,當Tomcat啓動時,Service組件就會監聽特定的端口。在第一部分的例子中,Catalina這個Service監聽了8080端口(基於HTTP協議)和8009端口(基於AJP協議)。當請求進來時,Tomcat即可以根據協議和端口號選定處理請求的Service;Service一旦選定,Engine也就肯定。

經過在Server中配置多個Service,能夠實現經過不一樣的端口號來訪問同一臺機器上部署的不一樣應用。

(2)根據域名或IP地址選定Host

Service肯定後,Tomcat在Service中尋找名稱與域名/IP地址匹配的Host處理該請求。若是沒有找到,則使用Engine中指定的defaultHost來處理該請求。在第一部分的例子中,因爲只有一個Host(name屬性爲localhost),所以該Service/Engine的全部請求都交給該Host處理。

(3)根據URI選定Context/Web應用

這一點在Context一節有詳細的說明:Tomcat根據應用的 path屬性與URI的匹配程度來選擇Web應用處理相應請求,這裏再也不贅述。

(4)舉例

以請求http://localhost:8080/app1/index.html爲例,首先經過協議和端口號(http和8080)選定Service;而後經過主機名(localhost)選定Host;而後經過uri(/app1/index.html)選定Web應用。

三、如何配置多個服務

經過在Server中配置多個Service服務,能夠實現經過不一樣的端口號來訪問同一臺機器上部署的不一樣Web應用。

在server.xml中配置多服務的方法很是簡單,分爲如下幾步:

(1)複製<Service>元素,放在當前<Service>後面。

(2)修改端口號:根據須要監聽的端口號修改<Connector>元素的port屬性;必須確保該端口沒有被其餘進程佔用,不然Tomcat啓動時會報錯,而沒法經過該端口訪問Web應用。

以Win7爲例,能夠用以下方法找出某個端口是否被其餘進程佔用:netstat -aon|findstr "8081"發現8081端口被PID爲2064的進程佔用,tasklist |findstr "2064"發現該進程爲FrameworkService.exe(這是McAfee殺毒軟件的進程)。

(3)修改Service和Engine的name屬性

(4)修改Host的appBase屬性(如webapps2)

(5)Web應用仍然使用自動部署

(6)將要部署的Web應用(WAR包或應用目錄)拷貝到新的appBase下。

以第一部分的server.xml爲例,多個Service的配置以下:

複製代碼
 1 <?xml version='1.0' encoding='utf-8'?>
 2 <Server port="8005" shutdown="SHUTDOWN">
 3   <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
 4   <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
 5   <Listener className="org.apache.catalina.core.JasperListener" />
 6   <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
 7   <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
 8   <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
 9 
10   <GlobalNamingResources>
11     <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" />
12   </GlobalNamingResources>
13 
14   <Service name="Catalina">
15     <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
16     <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
17     <Engine name="Catalina" defaultHost="localhost">
18       <Realm className="org.apache.catalina.realm.LockOutRealm">
19         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
20                resourceName="UserDatabase"/>
21       </Realm>
22 
23       <Host name="localhost"  appBase="/opt/project/webapps" unpackWARs="true" autoDeploy="true">
24         <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" />
25       </Host>
26     </Engine>
27   </Service>
28 
29   <Service name="Catalina2">
30     <Connector port="8084" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
31     <Connector port="8010" protocol="AJP/1.3" redirectPort="8443" />
32     <Engine name="Catalina2" defaultHost="localhost">
33       <Realm className="org.apache.catalina.realm.LockOutRealm">
34         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
35                resourceName="UserDatabase"/>
36       </Realm>
37 
38       <Host name="localhost"  appBase="/opt/project/webapps2" unpackWARs="true" autoDeploy="true">
39         <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" />
40       </Host>
41     </Engine>
42   </Service>
43 </Server>
複製代碼

再將原webapps下的docs目錄拷貝到webapps2中,則經過以下兩個接口均可以訪問docs應用:

http://localhost:8080/docs/

http://localhost:8084/docs/

5、其餘組件

除核心組件外,server.xml中還能夠配置不少其餘組件。下面只介紹第一部分例子中出現的組件,若是要了解更多內容,能夠查看Tomcat官方文檔

一、Listener

複製代碼
1   <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
2   <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
3   <Listener className="org.apache.catalina.core.JasperListener" />
4   <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
5   <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
6   <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
複製代碼

Listener(即監聽器)定義的組件,能夠在特定事件發生時執行特定的操做;被監聽的事件一般是Tomcat的啓動和中止。

監聽器能夠在Server、Engine、Host或Context中,本例中的監聽器都是在Server中。實際上,本例中定義的6個監聽器,都只能存在於Server組件中。監聽器不容許內嵌其餘組件。

監聽器須要配置的最重要的屬性是className,該屬性規定了監聽器的具體實現類,該類必須實現了org.apache.catalina.LifecycleListener接口。

下面依次介紹例子中配置的監聽器:

  • VersionLoggerListener:當Tomcat啓動時,該監聽器記錄Tomcat、Java和操做系統的信息。該監聽器必須是配置的第一個監聽器。
  • AprLifecycleListener:Tomcat啓動時,檢查APR庫,若是存在則加載。APR,即Apache Portable Runtime,是Apache可移植運行庫,能夠實現高可擴展性、高性能,以及與本地服務器技術更好的集成。
  • JasperListener:在Web應用啓動以前初始化Jasper,Jasper是JSP引擎,把JVM不認識的JSP文件解析成java文件,而後編譯成class文件供JVM使用。
  • JreMemoryLeakPreventionListener:與類加載器致使的內存泄露有關。
  • GlobalResourcesLifecycleListener:經過該監聽器,初始化< GlobalNamingResources>標籤中定義的全局JNDI資源;若是沒有該監聽器,任何全局資源都不能使用。< GlobalNamingResources>將在後文介紹。
  • ThreadLocalLeakPreventionListener:當Web應用因thread-local致使的內存泄露而要中止時,該監聽器會觸發線程池中線程的更新。當線程執行完任務被收回線程池時,活躍線程會一個一個的更新。只有當Web應用(即Context元素)的renewThreadsWhenStoppingContext屬性設置爲true時,該監聽器纔有效。

二、GlobalNamingResources與Realm

第一部分的例子中,Engine組件下定義了Realm組件:

1       <Realm className="org.apache.catalina.realm.LockOutRealm">
2         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
3                resourceName="UserDatabase"/>
4       </Realm>

Realm,能夠把它理解成「域」;Realm提供了一種用戶密碼與web應用的映射關係,從而達到角色安全管理的做用。在本例中,Realm的配置使用name爲UserDatabase的資源實現。而該資源在Server元素中使用GlobalNamingResources配置:

1   <GlobalNamingResources>
2     <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" />
3   </GlobalNamingResources>

GlobalNamingResources元素定義了全局資源,經過配置能夠看出,該配置是經過讀取$TOMCAT_HOME/ conf/tomcat-users.xml實現的。

關於Tomcat域管理的更多內容,能夠參考:Realm域管理

三、Valve

在第一部分的例子中,Host元素內定義了Valve組件:

1 <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" />

單詞Valve的意思是「閥門」,在Tomcat中表明瞭請求處理流水線上的一個組件;Valve能夠與Tomcat的容器(Engine、Host或Context)關聯。

不一樣的Valve有不一樣的特性,下面介紹一下本例中出現的AccessLogValve。

AccessLogValve的做用是經過日誌記錄其所在的容器中處理的全部請求,在本例中,Valve放在Host下,即可以記錄該Host處理的全部請求。AccessLogValve記錄的日誌就是訪問日誌,天天的請求會寫到一個日誌文件裏。AccessLogValve能夠與Engine、Host或Context關聯;在本例中,只有一個Engine,Engine下只有一個Host,Host下只有一個Context,所以AccessLogValve放在三個容器下的做用實際上是相似的。

本例的AccessLogValve屬性的配置,使用的是默認的配置;下面介紹AccessLogValve中各個屬性的做用:

(1)className:規定了Valve的類型,是最重要的屬性;本例中,經過該屬性規定了這是一個AccessLogValve。

(2)directory:指定日誌存儲的位置,本例中,日誌存儲在$TOMCAT_HOME/logs目錄下。

(3)prefix:指定了日誌文件的前綴。

(4)suffix:指定了日誌文件的後綴。經過directory、prefix和suffix的配置,在$TOMCAT_HOME/logs目錄下,能夠看到以下所示的日誌文件。

(5)pattern:指定記錄日誌的格式,本例中各項的含義以下:

  • %h:遠程主機名或IP地址;若是有nginx等反向代理服務器進行請求分發,該主機名/IP地址表明的是nginx,不然表明的是客戶端。後面遠程的含義與之相似,再也不解釋。
  • %l:遠程邏輯用戶名,一概是」-」,能夠忽略。
  • %u:受權的遠程用戶名,若是沒有,則是」-」。
  • %t:訪問的時間。
  • %r:請求的第一行,即請求方法(get/post等)、uri、及協議。
  • %s:響應狀態,200,404等等。
  • %b:響應的數據量,不包括請求頭,若是爲0,則是」」-。

例如,下面是訪問日誌中的一條記錄

pattern的配置中,除了上述各項,還有一個很是經常使用的選項是%D,含義是請求處理的時間(單位是毫秒),對於統計分析請求的處理速度幫助很大。

開發人員能夠充分利用訪問日誌,來分析問題、優化應用。例如,分析訪問日誌中各個接口被訪問的比例,不只能夠爲需求和運營人員提供數據支持,還可使本身的優化有的放矢;分析訪問日誌中各個請求的響應狀態碼,能夠知道服務器請求的成功率,並找出有問題的請求;分析訪問日誌中各個請求的響應時間,能夠找出慢請求,並根據須要進行響應時間的優化。

6、參考文獻

Tomcat官方文檔

《How Tomcat Works》

《深刻分析Java Web技術內幕》

Tomcat 6 —— Realm域管理

Tomcat Port 8009 與AJP13協議

使用Jasper引擎解析JSP

相關文章
相關標籤/搜索