1. 程式人生 > >深度好文_深入瞭解tomcat server.xml

深度好文_深入瞭解tomcat server.xml

Tomcat Server的結構圖




該檔案描述瞭如何啟動Tomcat Server 

<Server>
    <Listener />
    <GlobaNamingResources>
    </GlobaNamingResources
    <Service>
        <Connector />
        <Engine>
            <Logger />
            <Realm />
               <host>
                   <Logger />
                   <Context />
               </host>
        </Engine>
    </Service>
</Server>

元素名

屬性

解釋

server

port

指定一個埠,這個埠負責監聽關閉tomcat的請求

shutdown

指定向埠傳送的命令字串

service

name

指定service的名字

Connector(表示客戶端和service之間的連線)

port

指定伺服器端要建立的埠號,並在這個斷口監聽來自客戶端的請求

minProcessors

伺服器啟動時建立的處理請求的執行緒數

maxProcessors

最大可以建立的處理請求的執行緒數

enableLookups

如果為true,則可以通過呼叫request.getRemoteHost()進行DNS查詢來得到遠端客戶端的實際主機名,若為false則不進行DNS查詢,而是返回其ip地址

redirectPort

指定伺服器正在處理http請求時收到了一個SSL傳輸請求後重定向的埠號

acceptCount

指定當所有可以使用的處理請求的執行緒數都被使用時,可以放到處理佇列中的請求數,超過這個數的請求將不予處理

connectionTimeout

指定超時的時間數(以毫秒為單位)

Engine(表示指定service中的請求處理機,接收和處理來自Connector的請求)

defaultHost

指定預設的處理請求的主機名,它至少與其中的一個host元素的name屬性值是一樣的

Context(表示一個web應用程式,通常為WAR檔案,關於WAR的具體資訊見servlet規範)

docBase

應用程式的路徑或者是WAR檔案存放的路徑

path

表示此web應用程式的url的字首,這樣請求的url為http://localhost:8080/path/****

reloadable

這個屬性非常重要,如果為true,則tomcat會自動檢測應用程式的/WEB-INF/lib 和/WEB-INF/classes目錄的變化,自動裝載新的應用程式,我們可以在不重起tomcat的情況下改變應用程式

host(表示一個虛擬主機)

name

指定主機名

appBase

應用程式基本目錄,即存放應用程式的目錄

unpackWARs

如果為true,則tomcat會自動將WAR檔案解壓,否則不解壓,直接從WAR檔案中執行應用程式

Logger(表示日誌,除錯和錯誤資訊)

className

指定logger使用的類名,此類必須實現org.apache.catalina.Logger 介面

prefix

指定log檔案的字首

suffix

指定log檔案的字尾

timestamp

如果為true,則log檔名中要加入時間,如下例:localhost_log.001-10-04.txt

Realm(表示存放使用者名稱,密碼及role的資料庫)

className

指定Realm使用的類名,此類必須實現org.apache.catalina.Realm介面

Valve(功能與Logger差不多,其prefix和suffix屬性解釋和Logger 中的一樣)

className

指定Valve使用的類名,如用org.apache.catalina.valves.AccessLogValve類可以記錄應用程式的訪問資訊

directory

指定log檔案存放的位置

pattern

有兩個值,common方式記錄遠端主機名或ip地址,使用者名稱,日期,第一行請求的字串,HTTP響應程式碼,傳送的位元組數。combined方式比common方式記錄的值更多

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

<!-- 一個“Server”是一個提供完整的JVM的獨立元件,它可以包含一個或多個
     “Service”例項。伺服器在指定的埠上監聽shutdown命令。
     
     注意:一個“Server”自身不是一個“Container”(容器),因此在這裡你
     不可以定義諸如“Valves”或者“Loggers”子元件
-->

<!-- 啟動Server
     在埠8005處等待關閉命令
     如果接受到"SHUTDOWN"字串則關閉伺服器
     -->

  
測試:
 telnet localhost 8005   
輸入:SHUTDOWN
結果:關閉tomcat

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

1>className指定實現org.apache.catalina.Server介面的類.預設值為org.apache.catalina.core.StandardServer
2>port指定Tomcat監聽shutdown命令埠.終止伺服器執行時,必須在Tomcat伺服器所在的機器上發出shutdown命令.該屬性是必須的.
3>shutdown指定終止Tomcat伺服器執行時,發給Tomcat伺服器的shutdown監聽埠的字串.該屬性必須設定 

<Service>元素
該元素由org.apache.catalina.Service介面定義,它包含一個<Engine>元素,以及一個或多個<Connector>,這些Connector元素共享用同一個Engine元素

<!-- 一個“Service”是一個或多個共用一個單獨“Container”(容器)的“Connectors”
       組合(因此,應用程式在容器中可見)。通常,這個容器是一個“Engine”
       (引擎),但這不是必須的。
       
       注意:一個“Service”自身不是一個容器,因此,在這個級別上你不可定義
       諸如“Valves”或“Loggers”子元件。
  -->

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

   
   <Service name="Catalina">
   <Service name="Apache">
   第一個<Service>處理所有直接由Tomcat伺服器接收的web客戶請求.
   第二個<Service>處理所有由Apahce伺服器轉發過來的Web客戶請求 .

1>className 指定實現org.apahce.catalina.Service介面的類.預設為org.apahce.catalina.core.StandardService
2>name定義Service的名字

<Connector>元素
由Connector介面定義.<Connector>元素代表與客戶程式實際互動的給件,它負責接收客戶請求,以及向客戶返回響應結果. 

<!-- 一個“Connector”(聯結器)代表一個請求被接收和應答所需要的端點。每個連
         接器通過相關的“Container”(容器)處理請求。
         
         預設情況下,一個非SSL的HTTP/1.1的聯結器被繫結在埠8080。你也可以通過
         根據後面的使用說明並取消第二個聯結器入口的註釋,在埠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”的口令值執行:
             %JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA (Windows)
             $JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA (UNIX)
           來生成它自己的證書私鑰。
           
         預設情況下,當一個web應用程式呼叫請求時,DNS查詢是可行的。這將對效能造
         成一些不利的影響,因此,你可以將“enableLookups”設定為“false”來關閉DNS
         查詢。當DNS查詢被關閉時,request.getRemoteHost()將返回包含遠端客戶IP地
         址的字串。
  -->

<!-- Coyote HTTP/1.1 Connector
className : 該Connector的實現類是org.apache.coyote.tomcat4.CoyoteConnector
port : 在埠號8080處偵聽來自客戶browser的HTTP1.1請求.如果把8080改成80,則只要輸入 http://localhost/即可
    protocol:設定Http協議,預設值為HTTP/1.1
minSpareThreads: 該Connector先建立5個執行緒等待客戶請求,每個請求由一個執行緒負責
maxSpareThread:設定在監聽埠的執行緒的最大數目,這個值也決定了伺服器可以同時響應客戶請求的最大數目.預設值為200
    acceptCount : 當現有執行緒已經達到最大數75時,為客戶請求排隊.當佇列中請求數超過100時,後來的請求返回Connection refused錯誤
redirectport : 當客戶請求是https時,把該請求轉發到埠8443去
   enableLookups:如果設為true,表示支援域名解析,可以把IP地址解析為主機名.WEB應用中呼叫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埠接收由其它伺服器轉發過來的請求.



<Engine>元素
每個Service元素只能有一個Engine元素.處理在同一個<Service>中所有<Connector>元素接收到的客戶請求.由org.apahce.catalina.Engine介面定義. 

<!-- 一個“Engine”(引擎)代表處理每個請求的入口點(在Catalina內)。這個Tomcat
         的標準獨立引擎實現分析包含在請求中的HTTP頭資訊,並將請求傳送到適當的主機
         或虛擬主機上。-->


<!-- Engine用來處理Connector收到的Http請求
         它將匹配請求和自己的虛擬主機,並把請求轉交給對應的Host來處理
         預設虛擬主機是localhost
         -->

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

1>className指定實現Engine介面的類,預設值為StandardEngine
2>defaultHost指定處理客戶的預設主機名,在<Engine>中的<Host>子元素中必須定義這一主機
3>name定義Engine的名字

在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>

<Host>元素
它由Host介面定義.一個Engine元素可以包含多個<Host>元素.每個<Host>的元素定義了一個虛擬主機.它包含了一個或多個Web應用.

 <!-- 定義預設的虛擬主機
           注意:XML模式確認將不能與Xerces 2.2同工作。
      -->


<!-- 虛擬主機localhost
           appBase : 指定虛擬主機的目錄,可以指定絕對目錄,也可以指定相對於<CATALINA_HOME>的相對目錄.如果沒有此項,預設為<CATALINA_HOME>/webapps. 它將匹配請求和自己的Context的路徑,並把請求轉交給對應的Context來處理
              autoDeploy:如果此項設為true,表示Tomcat服務處於執行狀態時,能夠監測appBase下的檔案,如果有新有web應用加入進來,會自運釋出這個WEB應用
              unpackWARs:如果此項設定為true,表示把WEB應用的WAR檔案先展開為開放目錄結構後再執行.如果設為false將直接執行為WAR檔案
              alias:指定主機別名,可以指定多個別名
              deployOnStartup:如果此項設為true,表示Tomcat伺服器啟動時會自動釋出appBase目錄下所有的Web應用.如果Web應用中的server.xml沒有相應的<Context>元素,將採用Tomcat預設的Context





           -->

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

在<Host>元素中可以包含如下子元素
<Logger>, <Realm>, <Value>, <Context>


<Context>元素
它由Context介面定義.是使用最頻繁的元素.每個<Context元素代表了執行在虛擬主機上的單個Web應用.一個<Host>可以包含多個<Context>元素.每個web應用有唯一
的一個相對應的Context代表web應用自身.servlet容器為第一個web應用建立一個

<!-- Context,對應於一個Web App
             path : 該Context的路徑名是"",故該Context是該Host的預設Context
             docBase : 該Context的根目錄是webapps/mycontext/
                reloadable:如果這個屬性設為true, Tomcat伺服器在執行狀態下會監視在WEB-INF/classes和Web-INF/lib目錄CLASS檔案的改運.如果監視到有class檔案被更新,伺服器自重新載入Web應用
                useNaming:指定是否支援JNDI,預設值為了true 
                cookies指定是否通過Cookies來支援Session,預設值為true

             -->

<Context path="" docBase="mycontext" debug="0"/>


Tomcat Server處理一個http請求的過程

假設來自客戶的請求為:
http://localhost:8080/wsota/wsota_index.jsp

1) 請求被髮送到本機埠8080,被在那裡偵聽的Coyote HTTP/1.1 Connector獲得
2) Connector把該請求交給它所在的Service的Engine來處理,並等待來自Engine的迴應
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中尋找對應的servlet
8) Context匹配到URL PATTERN為*.jsp的servlet,對應於JspServlet類
9) 構造HttpServletRequest物件和HttpServletResponse物件,作為引數呼叫JspServlet的doGet或doPost方法
10)Context把執行完了之後的HttpServletResponse物件返回給Host
11)Host把HttpServletResponse物件返回給Engine
12)Engine把HttpServletResponse物件返回給Connector
13)Connector把HttpServletResponse物件返回給客戶browser