開篇

?在看《Tomcat 架構解析》時候皂股，對server.xml的配置文件產生了興趣，剛好在網上搜了搜一些資料，發(fā)現一篇比較好的文章《詳解Tomcat 配置文件server.xml》愈魏，特意轉載過來供有興趣的人一起研究。
?再次申明想际，這篇文章是轉自互聯(lián)網而非原創(chuàng)培漏！

前言

?Tomcat隸屬于Apache基金會，是開源的輕量級Web應用服務器胡本，使用非常廣泛牌柄。server.xml是Tomcat中最重要的配置文件，server.xml的每一個元素都對應了Tomcat中的一個組件侧甫；通過對xml文件中元素的配置珊佣，可以實現對Tomcat中各個組件的控制。因此闺骚，學習server.xml文件的配置彩扔，對于了解和使用Tomcat至關重要。

?本文將通過實例僻爽，介紹server.xml中各個組件的配置虫碉，并詳細說明Tomcat各個核心組件的作用以及各個組件之間的相互關系。

?說明：由于server.xml文件中元素與Tomcat中組件的對應關系，后文中為了描述方便，“元素”和“組件”的使用不嚴格區(qū)分柠横。

一牍氛、server.xml配置實例

?server.xml位于$TOMCAT_HOME/conf目錄下；下面是一個server.xml實例蜒茄。后文中將結合該實例講解server.xml中啤挎，各個元素的含義和作用；在閱讀后續(xù)章節(jié)過程中伙判，可以對照該xml文檔便于理解勒魔。

<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <Listener className="org.apache.catalina.core.JasperListener" />
  <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 name="Catalina">
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
    <Engine name="Catalina" defaultHost="localhost">
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>
 
      <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" />
      </Host>
    </Engine>
  </Service>
</Server>

二喊式、server.xml文檔的元素分類和整體結構

1、整體結構

?server.xml的整體結構如下：

<Server>
    <Service>
        <Connector />
        <Connector />
        <Engine>
            <Host>
                <Context /><!-- 現在常常使用自動部署进胯，不推薦配置Context元素，Context小節(jié)有詳細說明 -->
            </Host>
        </Engine>
    </Service>
</Server>

?該結構中只給出了Tomcat的核心組件，除了核心組件外，Tomcat還有一些其他組件脾还，下面介紹一下組件的分類伴箩。

2、元素分類

?server.xml文件中的元素可以分為以下4類：

（1）頂層元素：<Server>和<Service>

?<Server>元素是整個配置文件的根元素鄙漏，<Service>元素則代表一個Engine元素以及一組與之相連的Connector元素嗤谚。

（2）連接器：<Connector>

?<Connector>代表了外部客戶端發(fā)送請求到特定Service的接口；同時也是外部客戶端從特定Service接收響應的接口怔蚌。

（3）容器：<Engine><Host><Context>

?容器的功能是處理Connector接收進來的請求巩步，并產生相應的響應。Engine桦踊、Host和Context都是容器椅野，但它們不是平行的關系，而是父子關系：Engine包含Host钞钙，Host包含Context鳄橘。一個Engine組件可以處理Service中的所有請求，一個Host組件可以處理發(fā)向一個特定虛擬主機的所有請求芒炼，一個Context組件可以處理一個特定Web應用的所有請求瘫怜。

（4）內嵌組件：可以內嵌到容器中的組件。
?實際上本刽，Server鲸湃、Service、Connector子寓、Engine暗挑、Host和Context是最重要的最核心的Tomcat組件，其他組件都可以歸為內嵌組件斜友。

?下面將詳細介紹Tomcat中各個核心組件的作用炸裆，以及相互之間的關系。

三鲜屏、核心組件

?本部分將分別介紹各個核心組件的作用烹看、特點以及配置方式等国拇。

1、Server

?Server元素在最頂層惯殊，代表整個Tomcat容器酱吝，因此它必須是server.xml中唯一一個最外層的元素。一個Server元素中可以有一個或多個Service元素土思。

?在第一部分的例子中务热，在最外層有一個<Server>元素，shutdown屬性表示關閉Server的指令己儒；port屬性表示Server接收shutdown指令的端口號崎岂，設為-1可以禁掉該端口。

?Server的主要任務闪湾，就是提供一個接口讓客戶端能夠訪問到這個Service集合该镣，同時維護它所包含的所有的Service的聲明周期，包括如何初始化响谓、如何結束服務损合、如何找到客戶端要訪問的Service。

2娘纷、Service

?Service的作用嫁审，是在Connector和Engine外面包了一層，把它們組裝在一起赖晶，對外提供服務律适。一個Service可以包含多個Connector，但是只能包含一個Engine遏插；其中Connector的作用是從客戶端接收請求捂贿，Engine的作用是處理接收進來的請求。

?在第一部分的例子中胳嘲，Server中包含一個名稱為“Catalina”的Service厂僧。實際上，Tomcat可以提供多個Service了牛，不同的Service監(jiān)聽不同的端口颜屠，后文會有介紹。

3鹰祸、Connector

?Connector的主要功能甫窟，是接收連接請求，創(chuàng)建Request和Response對象用于和請求端交換數據蛙婴；然后分配線程讓Engine來處理這個請求粗井，并把產生的Request和Response對象傳給Engine。

?通過配置Connector，可以控制請求Service的協(xié)議及端口號浇衬。在第一部分的例子中呆瞻，Service包含兩個Connector：

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

?（1）通過配置第1個Connector，客戶端可以通過8080端口號使用http協(xié)議訪問Tomcat径玖。其中，protocol屬性規(guī)定了請求的協(xié)議颤介，port規(guī)定了請求的端口號梳星，redirectPort表示當強制要求https而請求是http時，重定向至端口號為8443的Connector滚朵，connectionTimeout表示連接的超時時間冤灾。

?在這個例子中，Tomcat監(jiān)聽HTTP請求辕近，使用的是8080端口韵吨，而不是正式的80端口；實際上移宅，在正式的生產環(huán)境中归粉，Tomcat也常常監(jiān)聽8080端口，而不是80端口漏峰。這是因為在生產環(huán)境中糠悼，很少將Tomcat直接對外開放接收請求，而是在Tomcat和客戶端之間加一層代理服務器(如nginx)浅乔，用于請求的轉發(fā)倔喂、負載均衡、處理靜態(tài)文件等靖苇；通過代理服務器訪問Tomcat時席噩，是在局域網中，因此一般仍使用8080端口贤壁。

?（2）通過配置第2個Connector悼枢，客戶端可以通過8009端口號使用AJP協(xié)議訪問Tomcat。AJP協(xié)議負責和其他的HTTP服務器(如Apache)建立連接脾拆；在把Tomcat與其他HTTP服務器集成時萧芙，就需要用到這個連接器。之所以使用Tomcat和其他服務器集成假丧，是因為Tomcat可以用作Servlet/JSP容器双揪，但是對靜態(tài)資源的處理速度較慢，不如Apache和IIS等HTTP服務器包帚；因此常常將Tomcat與Apache等集成渔期，前者作Servlet容器，后者處理靜態(tài)資源，而AJP協(xié)議便負責Tomcat和Apache的連接疯趟。Tomcat與Apache等集成的原理如下圖：

image

?關于Connector的更多內容拘哨，可以參考我的另一篇文章：詳解tomcat的連接數與線程池

4、Engine

?Engine組件在Service組件中有且只有一個信峻；Engine是Service組件中的請求處理組件倦青。Engine組件從一個或多個Connector中接收請求并處理，并將完成的響應返回給Connector盹舞，最終傳遞給客戶端产镐。

?前面已經提到過，Engine踢步、Host和Context都是容器癣亚，但它們不是平行的關系，而是父子關系：Engine包含Host获印，Host包含Context述雾。

?在第一部分的例子中，Engine的配置語句如下：

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

?其中兼丰，name屬性用于日志和錯誤信息玻孟，在整個Server中應該唯一。defaultHost屬性指定了默認的host名稱鳍征，當發(fā)往本機的請求指定的host名稱不存在時取募，一律使用defaultHost指定的host進行處理；因此蟆技，defaultHost的值玩敏，必須與Engine中的一個Host組件的name屬性值匹配。

5质礼、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頭中提取出主機名，尋找名稱匹配的主機衷佃。如果沒有匹配趟卸，請求將發(fā)送至默認主機。因此默認主機不需要是在DNS服務器中注冊的網絡名氏义，因為任何與所有Host名稱不匹配的請求锄列，都會路由至默認主機赠制。

（3）Host的配置

?在第一部分的例子中恍涂，Host的配置如下：

<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應用的自動部署有關；將在下一節(jié)(Context)中介紹硫兰。

6诅愚、Context

（1）Context的作用

?Context元素代表在特定虛擬主機上運行的一個Web應用。在后文中劫映，提到Context违孝、應用或Web應用，它們指代的都是Web應用泳赋。每個Web應用基于WAR文件雌桑，或WAR文件解壓后對應的目錄（這里稱為應用目錄）。

?Context是Host的子容器祖今，每個Host中可以定義任意多的Context元素筹燕。

?在第一部分的例子中，可以看到server.xml配置文件中并沒有出現Context元素的配置。這是因為撒踪，Tomcat開啟了自動部署过咬，Web應用沒有在server.xml中配置靜態(tài)部署，而是由Tomcat通過特定的規(guī)則自動部署制妄。下面介紹一下Tomcat自動部署Web應用的機制掸绞。

（2）Web應用自動部署

?Host的配置

?要開啟Web應用的自動部署，需要配置所在的虛擬主機耕捞；配置的方式就是前面提到的Host元素的deployOnStartup和autoDeploy屬性衔掸。如果deployOnStartup和autoDeploy設置為true，則tomcat啟動自動部署：當檢測到新的Web應用或Web應用的更新時俺抽，會觸發(fā)應用的部署(或重新部署)敞映。二者的主要區(qū)別在于，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應用時，發(fā)現了xmlBase目錄下的app1.xml秒梅，或appBase目錄下的app1.WAR或app1應用目錄旗芬，則該Web應用的path屬性是”app1”。如果名稱不是app1而是ROOT捆蜀，則該Web應用是虛擬主機默認的Web應用疮丛，此時path屬性推導為””幔嫂。

?reloadable屬性指示tomcat是否在運行時監(jiān)控在WEB-INF/classes和WEB-INF/lib目錄下class文件的改動。如果值為true誊薄，那么當class文件改動時履恩，會觸發(fā)Web應用的重新加載。在開發(fā)環(huán)境下暇屋，reloadable設置為true便于調試似袁；但是在生產環(huán)境中設置為true會給服務器帶來性能壓力，因此reloadable參數的默認值為false咐刨。

?下面來看自動部署時昙衅，xmlBase下的XML配置文件app1.xml的例子：

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

?在該例子中，docBase位于Host的appBase目錄之外定鸟；path屬性沒有指定而涉，而是根據app1.xml自動推導為”app1”；由于是在開發(fā)環(huán)境下联予，因此reloadable設置為true啼县，便于開發(fā)調試。

?自動部署舉例

?最典型的自動部署沸久，就是當我們安裝完Tomcat后季眷，$TOMCAT_HOME/webapps目錄下有如下文件夾：

?當我們啟動Tomcat后，可以使用http://localhost:8080/來訪問Tomcat卷胯，其實訪問的就是ROOT對應的Web應用子刮；我們也可以通過http://localhost:8080/docs來訪問docs應用，同理我們可以訪問examples/host-manager/manager這幾個Web應用窑睁。

（3）server.xml中靜態(tài)部署Web應用

?除了自動部署挺峡，我們也可以在server.xml中通過<context>元素靜態(tài)部署Web應用。靜態(tài)部署與自動部署是可以共存的担钮。在實際應用中橱赠，并不推薦使用靜態(tài)部署，因為server.xml 是不可動態(tài)重加載的資源箫津，服務器一旦啟動了以后狭姨，要修改這個文件，就得重啟服務器才能重新加載苏遥。而自動部署可以在Tomcat運行時通過定期的掃描來實現饼拍，不需要重啟服務器。

?server.xml中使用Context元素配置Web應用暖眼，Context元素應該位于Host元素中惕耕。舉例如下：

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

?docBase：靜態(tài)部署時，docBase可以在appBase目錄下诫肠，也可以不在司澎；本例中欺缘，docBase不在appBase目錄下。

?path：靜態(tài)部署時挤安，可以顯式指定path屬性谚殊，但是仍然受到了嚴格的限制：只有當自動部署完全關閉(deployOnStartup和autoDeploy都為false)或docBase不在appBase中時，才可以設置path屬性蛤铜。在本例中嫩絮，docBase不在appBase中，因此path屬性可以設置围肥。

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

4、核心組件的關聯(lián)

1穆刻、整體關系

?核心組件之間的整體關系置尔，在上一部分有所介紹，這里總結一下：

?Server元素在最頂層氢伟，代表整個Tomcat容器榜轿；一個Server元素中可以有一個或多個Service元素。

?Service在Connector和Engine外面包了一層朵锣，把它們組裝在一起谬盐，對外提供服務。一個Service可以包含多個Connector诚些，但是只能包含一個Engine飞傀；Connector接收請求，Engine處理請求泣刹。

?Engine助析、Host和Context都是容器犀被，且 Engine包含Host椅您，Host包含Context。每個Host組件代表Engine中的一個虛擬主機寡键；每個Context組件代表在特定Host上運行的一個Web應用掀泳。

2、如何確定請求由誰處理西轩？

?當請求被發(fā)送到Tomcat所在的主機時员舵，如何確定最終哪個Web應用來處理該請求呢？

（1）根據協(xié)議和端口號選定Service和Engine

?Service中的Connector組件可以接收特定端口的請求藕畔，因此马僻，當Tomcat啟動時，Service組件就會監(jiān)聽特定的端口注服。在第一部分的例子中韭邓，Catalina這個Service監(jiān)聽了8080端口（基于HTTP協(xié)議）和8009端口（基于AJP協(xié)議）措近。當請求進來時，Tomcat便可以根據協(xié)議和端口號選定處理請求的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一節(jié)有詳細的說明：Tomcat根據應用的 path屬性與URI的匹配程度來選擇Web應用處理相應請求俺夕，這里不再贅述裳凸。

（4）舉例

?以請求http://localhost:8080/app1/index.html為例，首先通過協(xié)議和端口號（http和8080）選定Service劝贸；然后通過主機名（localhost）選定Host姨谷；然后通過uri（/app1/index.html）選定Web應用。

3映九、如何配置多個服務

?通過在Server中配置多個Service服務梦湘，可以實現通過不同的端口號來訪問同一臺機器上部署的不同Web應用。

?在server.xml中配置多服務的方法非常簡單件甥，分為以下幾步：

（1）復制<Service>元素捌议，放在當前<Service>后面。

（2）修改端口號：根據需要監(jiān)聽的端口號修改<Connector>元素的port屬性引有；必須確保該端口沒有被其他進程占用瓣颅，否則Tomcat啟動時會報錯，而無法通過該端口訪問Web應用譬正。以Win7為例宫补，可以用如下方法找出某個端口是否被其他進程占用：netstat -aon|findstr "8081"發(fā)現8081端口被PID為2064的進程占用，tasklist |findstr "2064"發(fā)現該進程為FrameworkService.exe(這是McAfee殺毒軟件的進程)曾我。

（3）修改Service和Engine的name屬性

（4）修改Host的appBase屬性（如webapps2）

（5）Web應用仍然使用自動部署

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

?以第一部分的server.xml為例，多個Service的配置如下：

<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <Listener className="org.apache.catalina.core.JasperListener" />
  <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 name="Catalina">
    <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
    <Engine name="Catalina" defaultHost="localhost">
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

      <Host name="localhost"  appBase="/opt/project/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" />
      </Host>
    </Engine>
  </Service>

  <Service name="Catalina2">
    <Connector port="8084" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
    <Connector port="8010" protocol="AJP/1.3" redirectPort="8443" />
    <Engine name="Catalina2" defaultHost="localhost">
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

      <Host name="localhost"  appBase="/opt/project/webapps2" 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" />
      </Host>
    </Engine>
  </Service>
</Server>

?再將原webapps下的docs目錄拷貝到webapps2中抒巢，則通過如下兩個接口都可以訪問docs應用：
?http://localhost:8080/docs/
?http://localhost:8084/docs/

五贫贝、其他組件

?除核心組件外，server.xml中還可以配置很多其他組件蛉谜。下面只介紹第一部分例子中出現的組件稚晚，如果要了解更多內容凤优，可以查看Tomcat官方文檔。

1蜈彼、Listener

  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <Listener className="org.apache.catalina.core.JasperListener" />
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

?Listener(即監(jiān)聽器)定義的組件筑辨，可以在特定事件發(fā)生時執(zhí)行特定的操作；被監(jiān)聽的事件通常是Tomcat的啟動和停止幸逆。

?監(jiān)聽器可以在Server棍辕、Engine、Host或Context中还绘，本例中的監(jiān)聽器都是在Server中楚昭。實際上，本例中定義的6個監(jiān)聽器拍顷，都只能存在于Server組件中抚太。監(jiān)聽器不允許內嵌其他組件。

?監(jiān)聽器需要配置的最重要的屬性是className昔案，該屬性規(guī)定了監(jiān)聽器的具體實現類尿贫，該類必須實現了org.apache.catalina.LifecycleListener接口。

?下面依次介紹例子中配置的監(jiān)聽器：

?VersionLoggerListener：當Tomcat啟動時踏揣，該監(jiān)聽器記錄Tomcat庆亡、Java和操作系統(tǒng)的信息。該監(jiān)聽器必須是配置的第一個監(jiān)聽器捞稿。

?AprLifecycleListener：Tomcat啟動時又谋，檢查APR庫，如果存在則加載娱局。APR彰亥，即Apache Portable Runtime，是Apache可移植運行庫衰齐，可以實現高可擴展性任斋、高性能，以及與本地服務器技術更好的集成娇斩。

?JasperListener：在Web應用啟動之前初始化Jasper仁卷，Jasper是JSP引擎穴翩，把JVM不認識的JSP文件解析成java文件犬第，然后編譯成class文件供JVM使用。

?JreMemoryLeakPreventionListener：與類加載器導致的內存泄露有關芒帕。

?GlobalResourcesLifecycleListener：通過該監(jiān)聽器歉嗓，初始化< GlobalNamingResources>標簽中定義的全局JNDI資源；如果沒有該監(jiān)聽器背蟆，任何全局資源都不能使用鉴分。< GlobalNamingResources>將在后文介紹哮幢。

?ThreadLocalLeakPreventionListener：當Web應用因thread-local導致的內存泄露而要停止時，該監(jiān)聽器會觸發(fā)線程池中線程的更新志珍。當線程執(zhí)行完任務被收回線程池時橙垢，活躍線程會一個一個的更新。只有當Web應用(即Context元素)的renewThreadsWhenStoppingContext屬性設置為true時伦糯，該監(jiān)聽器才有效柜某。

2、GlobalNamingResources與Realm

?第一部分的例子中敛纲，Engine組件下定義了Realm組件：

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

?Realm喂击，可以把它理解成“域”；Realm提供了一種用戶密碼與web應用的映射關系淤翔，從而達到角色安全管理的作用翰绊。在本例中，Realm的配置使用name為UserDatabase的資源實現旁壮。而該資源在Server元素中使用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>

?GlobalNamingResources元素定義了全局資源监嗜，通過配置可以看出，該配置是通過讀取$TOMCAT_HOME/ conf/tomcat-users.xml實現的抡谐。

?關于Tomcat域管理的更多內容秤茅，可以參考：Realm域管理

3、Valve

?在第一部分的例子中童叠，Host元素內定義了Valve組件：

<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)關聯(lián)五垮。

?不同的Valve有不同的特性，下面介紹一下本例中出現的AccessLogValve杜秸。

?AccessLogValve的作用是通過日志記錄其所在的容器中處理的所有請求放仗，在本例中，Valve放在Host下撬碟，便可以記錄該Host處理的所有請求诞挨。AccessLogValve記錄的日志就是訪問日志，每天的請求會寫到一個日志文件里呢蛤。AccessLogValve可以與Engine惶傻、Host或Context關聯(lián)；在本例中其障，只有一個Engine银室，Engine下只有一個Host，Host下只有一個Context，因此AccessLogValve放在三個容器下的作用其實是類似的蜈敢。

?本例的AccessLogValve屬性的配置辜荠，使用的是默認的配置；下面介紹AccessLogValve中各個屬性的作用：

（1）className：規(guī)定了Valve的類型抓狭，是最重要的屬性伯病；本例中，通過該屬性規(guī)定了這是一個AccessLogValve否过。

（2）directory：指定日志存儲的位置狱从，本例中，日志存儲在$TOMCAT_HOME/logs目錄下叠纹。

（3）prefix：指定了日志文件的前綴季研。

（4）suffix：指定了日志文件的后綴。通過directory誉察、prefix和suffix的配置与涡，在$TOMCAT_HOME/logs目錄下，可以看到如下所示的日志文件持偏。

（5）pattern：指定記錄日志的格式驼卖，本例中各項的含義如下：

• %h：遠程主機名或IP地址；如果有nginx等反向代理服務器進行請求分發(fā)鸿秆，該主機名/IP地址代表的是nginx酌畜，否則代表的是客戶端。后面遠程的含義與之類似卿叽，不再解釋桥胞。
• %l：遠程邏輯用戶名，一律是”-”考婴，可以忽略贩虾。
• %u：授權的遠程用戶名，如果沒有沥阱，則是”-”缎罢。
• %t：訪問的時間。
• %r：請求的第一行考杉，即請求方法(get/post等)策精、uri、及協(xié)議崇棠。
• %s：響應狀態(tài)咽袜，200,404等等。
• %b：響應的數據量易茬，不包括請求頭酬蹋，如果為0及老，則是””-抽莱。

?例如范抓，下面是訪問日志中的一條記錄

?pattern的配置中，除了上述各項食铐，還有一個非常常用的選項是%D匕垫，含義是請求處理的時間(單位是毫秒)，對于統(tǒng)計分析請求的處理速度幫助很大虐呻。

?開發(fā)人員可以充分利用訪問日志象泵，來分析問題、優(yōu)化應用斟叼。例如偶惠，分析訪問日志中各個接口被訪問的比例，不僅可以為需求和運營人員提供數據支持朗涩，還可以使自己的優(yōu)化有的放矢忽孽；分析訪問日志中各個請求的響應狀態(tài)碼，可以知道服務器請求的成功率谢床，并找出有問題的請求兄一；分析訪問日志中各個請求的響應時間，可以找出慢請求识腿，并根據需要進行響應時間的優(yōu)化出革。

六、參考文獻

Tomcat官方文檔
Tomcat 6 —— Realm域管理
Tomcat Port 8009 與AJP13協(xié)議
使用Jasper引擎解析JSP