Tomcat虛擬主機 server.xml 引入子文件配置教程

在配置 Tomcat 虛擬主機時候冷溶，如何每一個虛擬主機寫成單獨文件癌蚁，server.xml 包含這些子文件赶站？本文會詳細介紹绰上。

1. service.xml 詳解

Tomcat Server的結(jié)構(gòu)圖如下：

該文件描述了如何啟動Tomcat Server

service.xml 文件節(jié)點結(jié)構(gòu)：

<Server>
    <Listener />
    <GlobaNamingResources></GlobaNamingResources
    <Service>
        <Connector />
        <Engine>
            <Logger />
            <Realm />
            <host>
                <Logger />
                <Context />
            </host>
        </Engine>
    </Service>
</Server>
節(jié)點詳細介紹
  • 默認的 service.xml 內(nèi)容[Tomcat8.5.20版本泡垃，刪除注釋后]：
<?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.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="80" 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 "%r" %s %b" />
            </Host>
            -->
        </Engine>
    </Service>
</Server>

3. 直接使用

  1. 在<server>元素前添加如下格式：
<!DOCTYPE server-xml [<!ENTITY localhost-vhost SYSTEM "file:///usr/devl/tomcat8/conf/localhost.xml">]>
  1. 在<Engine>…</Engine]引用它（localhost-vhost）即可
  • 先在$CATALINA_HOME/conf/下創(chuàng)建vhost目錄
cd $CATALINA_HOME/conf/
mkdir vhost
  • 創(chuàng)建每個單獨虛擬主機的xml配置文件

/usr/devl/tomcat8/conf/vhost/localhost.xml

<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 "%r" %s %b" />
</Host>

/usr/devl/tomcat8/conf/vhost/lmsite.cn.xml

<Host name="lmsite.cn" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <Alias>www.lmsite.cn</Alias>
    <Context path="" docBase="/var/webapps/lmsite/" debug="0" reloadable="true" crossContext="true"/>
    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
    prefix="lmsite_access_log." suffix=".txt" pattern="%h %l %u %t "%r" %s %b" />
</Host>

/usr/devl/tomcat8/conf/vhost/bbs.lmsite.cn.xml

<Host name="bbs.jonny.com.cn" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <Context path="" docBase="/var/webapps/lmsite/bbs" debug="0" reloadable="true" crossContext="true"/>
    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
    prefix="bbs_lmsite_access_log." suffix=".txt" pattern="%h %l %u %t "%r" %s %b" />
</host>
  • 最終的 service.xml 文件示例：
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE server-xml [<!ENTITY localhost-vhost SYSTEM "file:///usr/devl/tomcat8/conf/localhost.xml">]>
<!DOCTYPE server-xml [<!ENTITY localhost-vhost SYSTEM "file:///usr/devl/tomcat8/conf/localhost.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.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="80" 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 "%r" %s %b" />
            </Host>
            -->
            &localhost-vhost;
            &lmsite.cn-vhost;
            &bbs.lmsite.cn-vhost;
        </Engine>
    </Service>
</Server>

4. 關(guān)于service.xml 查到的詳解資料

<Server>元素

它代表整個容器,是Tomcat實例的頂層元素.由org.apache.catalina.Server接口來定義.它包含一個<Service>元素.并且它不能做為任何元素的子元素.

一個“Server”是一個提供完整的JVM的獨立組件析珊，它可以包含一個或多個 “Service”實例羡鸥。服務(wù)器在指定的端口上監(jiān)聽shutdown命令。
注意：一個“Server”自身不是一個“Container”（容器）唾琼，因此在這里你 不可以定義諸如“Valves”或者“Loggers”子組件
啟動Server 在端口8005處等待關(guān)閉命令! 如果接受到"SHUTDOWN"字符串則關(guān)閉服務(wù)器

  • 測試：
telnet localhost 8005   
輸入：`SHUTDOWN`
結(jié)果：`關(guān)閉tomcat`

<Server port="8005" shutdown="SHUTDOWN" debug="0">

  1. className指定實現(xiàn)org.apache.catalina.Server接口的類.默認值為org.apache.catalina.core.StandardServer
  2. port指定Tomcat監(jiān)聽shutdown命令端口.終止服務(wù)器運行時,必須在Tomcat服務(wù)器所在的機器上發(fā)出shutdown命令.該屬性是必須的.
  3. shutdown指定終止Tomcat服務(wù)器運行時,發(fā)給Tomcat服務(wù)器的shutdown監(jiān)聽端口的字符串.該屬性必須設(shè)置

<Service>元素

該元素由org.apache.catalina.Service接口定義,它包含一個<Engine>元素,以及一個或多個<Connector>,這些Connector元素共享用同一個Engine元素
一個“Service”是一個或多個共用一個單獨“Container”(容器)的“Connectors” 組合（因此兄春，應(yīng)用程序在容器中可見）。通常锡溯，這個容器是一個“Engine” （引擎）赶舆，但這不是必須的。
注意：一個“Service”自身不是一個容器祭饭，因此芜茵，在這個級別上你不可定義 諸如“Valves”或“Loggers”子組件。

Tomcat的Standalone Service
Service是一組Connector的集合
它們共用一個Engine來處理所有Connector收到的請求

<Service name="Catalina">
<Service name="Apache">
第一個<Service>處理所有直接由Tomcat服務(wù)器接收的web客戶請求.
第二個<Service>處理所有由Apahce服務(wù)器轉(zhuǎn)發(fā)過來的Web客戶請求 .

  1. className 指定實現(xiàn)org.apahce.catalina.Service接口的類.默認為org.apahce.catalina.core.StandardService
  2. name定義Service的名字

<Connector>元素

由Connector接口定義.<Connector>元素代表與客戶程序?qū)嶋H交互的給件,它負責(zé)接收客戶請求,以及向客戶返回響應(yīng)結(jié)果.

一個“Connector”（連接器）代表一個請求被接收和應(yīng)答所需要的端點倡蝙。每個連接器通過相關(guān)的“Container”（容器）處理請求九串。
默認情況下，一個非SSL的HTTP/1.1的連接器被綁定在端口8080寺鸥。你也可以通過根據(jù)后面的使用說明并取消第二個連接器入口的注釋猪钮，在端口8443上建立一個SSL HTTP/1.1的連接器。開放SSL支持需要下面幾步（參見Tomcat 5文檔中怎樣配置SSL的說明以取得更多的詳細信息）：

  • 如果你的JDK是1.3或1.3以前的版本胆建，下載安裝JSSE 1.0.2或以后版本烤低，并放置JAR文件到“$JAVA_HOME/jre/lib/ext”目錄下。
  • 帶一個“changeit”的口令值執(zhí)行：
%JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA (Windows)
$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA(UNIX)

來生成它自己的證書私鑰笆载。

默認情況下扑馁，當一個web應(yīng)用程序調(diào)用請求時，DNS查詢是可行的凉驻。這將對性能造成一些不利的影響腻要，因此，你可以將“enableLookups”設(shè)置為“false”來關(guān)閉DNS查詢涝登。當DNS查詢被關(guān)閉時,request.getRemoteHost()將返回包含遠程客戶IP地址的字符串雄家。

Coyote HTTP/1.1 Connector
className : 該Connector的實現(xiàn)類是org.apache.coyote.tomcat4.CoyoteConnector
port : 在端口號8080處偵聽來自客戶browser的HTTP1.1請求.如果把8080改成80,則只要輸入http://localhost/即可
protocol:設(shè)定Http協(xié)議,默認值為HTTP/1.1
minSpareThreads: 該Connector先創(chuàng)建5個線程等待客戶請求，每個請求由一個線程負責(zé)
maxSpareThread:設(shè)定在監(jiān)聽端口的線程的最大數(shù)目,這個值也決定了服務(wù)器可以同時響應(yīng)客戶請求的最大數(shù)目.默認值為200
acceptCount : 當現(xiàn)有線程已經(jīng)達到最大數(shù)75時胀滚，為客戶請求排隊.當隊列中請求數(shù)超過100時咳短，后來的請求返回Connection refused錯誤
redirectport : 當客戶請求是https時，把該請求轉(zhuǎn)發(fā)到端口8443去 enableLookups:如果設(shè)為true,表示支持域名解析,可以把IP地址解析為主機名.WEB應(yīng)用中調(diào)用request.getRemoteHost方法返回客戶機主機名.默認值為true
connectionTimeout:定義建立客戶連接超時的時間.如果為-1,表示不限制建立客戶連接的時間,其它屬性略

<Connector port="8080" maxThread="50" minSpareThreads="25" maxSpareThread="75" enableLookups="false" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" disableUploadTimeout="true" />
<Connection port="8009" enableLookups="false" redirectPort="8443" debug="0" protocol="AJP/1.3" />

第一個Connector元素定義了一個HTTP Connector,它通過8080端口接收HTTP請求;第二個Connector元素定義了一個JD Connector,它通過8009端口接收由其它服務(wù)器轉(zhuǎn)發(fā)過來的請求.
<Engine>元素每個Service元素只能有一個Engine元素.處理在同一個<Service>中所有<Connector>元素接收到的客戶請求.由org.apahce.catalina.Engine接口定義.

一個“Engine”（引擎）代表處理每個請求的入口點（在Catalina內(nèi)）蛛淋。這個Tomcat 的標準獨立引擎實現(xiàn)分析包含在請求中的HTTP頭信息，并將請求傳送到適當?shù)闹鳈C 或虛擬主機上篡腌。

Engine用來處理Connector收到的Http請求它將匹配請求和自己的虛擬主機褐荷，并把請求轉(zhuǎn)交給對應(yīng)的Host來處理.默認虛擬主機是localhost

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

  1. className指定實現(xiàn)Engine接口的類,默認值為StandardEngine
  2. defaultHost指定處理客戶的默認主機名,在<Engine>中的<Host>子元素中必須定義這一主機
  3. name定義Engine的名字
    在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>

<Host>元素

它由Host接口定義.一個Engine元素可以包含多個<Host>元素.每個<Host>的元素定義了一個虛擬主機.它包含了一個或多個Web應(yīng)用.

定義默認的虛擬主機
注意：XML模式確認將不能與Xerces 2.2同工作。
虛擬主機:localhost
appBase : 指定虛擬主機的目錄,可以指定絕對目錄,也可以指定相對于<CATALINA_HOME>的相對目錄.如果沒有此項,默認為<CATALINA_HOME>/webapps. 它將匹配請求和自己的Context的路徑嘹悼，并把請求轉(zhuǎn)交給對應(yīng)的Context來處理
autoDeploy:如果此項設(shè)為true,表示Tomcat服務(wù)處于運行狀態(tài)時,能夠監(jiān)測appBase下的文件,如果有新有web應(yīng)用加入進來,會自運發(fā)布這個WEB應(yīng)用
unpackWARs:如果此項設(shè)置為true,表示把WEB應(yīng)用的WAR文件先展開為開放目錄結(jié)構(gòu)后再運行.如果設(shè)為false將直接運行為WAR文件 alias:指定主機別名,可以指定多個別名
deployOnStartup:如果此項設(shè)為true,表示Tomcat服務(wù)器啟動時會自動發(fā)布appBase目錄下所有的Web應(yīng)用.如果Web應(yīng)用中的server.xml沒有相應(yīng)的<Context>元素,將采用Tomcat默認的Context

<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">
在<Host>元素中可以包含如下子元素<Logger>, <Realm>, <Value>, <Context>

<Context>元素

它由Context接口定義.是使用最頻繁的元素.每個<Context元素代表了運行在虛擬主機上的單個Web應(yīng)用.一個<Host>可以包含多個<Context>元素.每個web應(yīng)用有唯一的一個相對應(yīng)的Context代表web應(yīng)用自身.servlet容器為第一個web應(yīng)用創(chuàng)建一個Context叛甫，對應(yīng)于一個Web App
path : 該Context的路徑名是""层宫，故該Context是該Host的默認Context
docBase : 該Context的根目錄是webapps/mycontext/
reloadable:如果這個屬性設(shè)為true, Tomcat服務(wù)器在運行狀態(tài)下會監(jiān)視在WEB-INF/classes和Web-INF/lib目錄CLASS文件的改運.如果監(jiān)視到有class文件被更新,服務(wù)器自重新加載Web應(yīng)用
useNaming:指定是否支持JNDI,默認值為了true
cookies指定是否通過Cookies來支持Session,默認值為true
<Context path="" docBase="mycontext" debug="0"/>
Tomcat Server處理一個http請求的過程：
假設(shè)來自客戶的請求為：http://localhost:8080/wsota/wsota_index.jsp

  1. 請求被發(fā)送到本機端口8080，被在那里偵聽的Coyote HTTP/1.1 Connector獲得
  2. Connector把該請求交給它所在的Service的Engine來處理其监，并等待來自Engine的回應(yīng)
  3. Engine獲得請求localhost/wsota/wsota_index.jsp萌腿，匹配它所擁有的所有虛擬主機Host
  4. Engine匹配到名為localhost的Host（即使匹配不到也把請求交給該Host處理，因為該Host被定義為該Engine的默認主機）
  5. localhost Host獲得請求/wsota/wsota_index.jsp抖苦，匹配它所擁有的所有Context
  6. Host匹配到路徑為/wsota的Context（如果匹配不到就把該請求交給路徑名為""的Context去處理）
  7. path="/wsota"的Context獲得請求/wsota_index.jsp毁菱，在它的mapping table中尋找對應(yīng)的servlet
  8. Context匹配到URL PATTERN為*.jsp的servlet，對應(yīng)于JspServlet類
  9. 構(gòu)造HttpServletRequest對象和HttpServletResponse對象锌历，作為參數(shù)調(diào)用JspServlet的doGet或doPost方法
  10. Context把執(zhí)行完了之后的HttpServletResponse對象返回給Host
  11. Host把HttpServletResponse對象返回給Engine
  12. Engine把HttpServletResponse對象返回給Connector
  13. Connector把HttpServletResponse對象返回給客戶browser
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 人面猴
    序言：七十年代末贮庞，一起剝皮案震驚了整個濱河市，隨后出現(xiàn)的幾起案子究西，更是在濱河造成了極大的恐慌窗慎，老刑警劉巖，帶你破解...
    沈念sama閱讀 206,968評論 6贊 482
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件卤材，死亡現(xiàn)場離奇詭異遮斥，居然都是意外死亡，警方通過查閱死者的電腦和手機扇丛，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,601評論 2贊 382
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進店門术吗，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人晕拆，你說我怎么就攤上這事藐翎。” “怎么了实幕？”我有些...
    開封第一講書人閱讀 153,220評論 0贊 344
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵吝镣，是天一觀的道長。 經(jīng)常有香客問我昆庇，道長末贾，這世上最難降的妖魔是什么？ 我笑而不...
    開封第一講書人閱讀 55,416評論 1贊 279
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任整吆，我火速辦了婚禮拱撵，結(jié)果婚禮上，老公的妹妹穿的比我還像新娘表蝙。我一直安慰自己拴测，他們只是感情好，可當我...
    茶點故事閱讀 64,425評論 5贊 374
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布府蛇。 她就那樣靜靜地躺著集索，像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上务荆，一...
    開封第一講書人閱讀 49,144評論 1贊 285
  • 城市分裂傳說
    那天妆距，我揣著相機與錄音，去河邊找鬼函匕。 笑死娱据，一個胖子當著我的面吹牛，可吹牛的內(nèi)容都是我干的盅惜。 我是一名探鬼主播中剩，決...
    沈念sama閱讀 38,432評論 3贊 401
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼，長吁一口氣：“原來是場噩夢啊……” “哼酷窥！你這毒婦竟也來了咽安？” 一聲冷哼從身側(cè)響起，我...
    開封第一講書人閱讀 37,088評論 0贊 261
  • 萬榮殺人案實錄
    序言：老撾萬榮一對情侶失蹤蓬推，失蹤者是張志新（化名）和其女友劉穎妆棒，沒想到半個月后，有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體沸伏，經(jīng)...
    沈念sama閱讀 43,586評論 1贊 300
  • ?護林員之死
    正文 獨居荒郊野嶺守林人離奇死亡糕珊，尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,028評論 2贊 325
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年，在試婚紗的時候發(fā)現(xiàn)自己被綠了毅糟。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片红选。...
    茶點故事閱讀 38,137評論 1贊 334
  • 活死人
    序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖姆另，靈堂內(nèi)的尸體忽然破棺而出喇肋，到底是詐尸還是另有隱情，我是刑警寧澤迹辐，帶...
    沈念sama閱讀 33,783評論 4贊 324
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布蝶防，位于F島的核電站，受9級特大地震影響明吩，放射性物質(zhì)發(fā)生泄漏间学。R本人自食惡果不足惜，卻給世界環(huán)境...
    茶點故事閱讀 39,343評論 3贊 307
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一印荔、第九天 我趴在偏房一處隱蔽的房頂上張望低葫。 院中可真熱鬧，春花似錦仍律、人聲如沸嘿悬。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,333評論 0贊 19
  • 一樁弒父案水泉，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽善涨。三九已至主到，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間躯概，已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,559評論 1贊 262
  • 情欲美人皮
    我被黑心中介騙來泰國打工畔师， 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留娶靡，地道東北人。 一個月前我還...
    沈念sama閱讀 45,595評論 2贊 355
  • 代替公主和親
    正文 我出身青樓看锉，卻偏偏與公主長得像姿锭，于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子伯铣，可洞房花燭夜當晚...
    茶點故事閱讀 42,901評論 2贊 345

推薦閱讀更多精彩內(nèi)容