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,表示不限制創建客戶鏈接的時間
allowTrace：是否容許HTTP的TRACE方法，默認爲false
emptySessionPath：若是設置爲true，用戶的全部路徑都將設置爲/，默認爲false。
enableLookups：調用request、getRemoteHost()執行DNS查詢，以返回遠程主機的主機名，若是設置爲false，則直接返回IP地址。
maxPostSize：指定POST方式請求的最大量，沒有指定默認爲2097152。
protocol：值必須爲HTTP1.1，若是使用AJP處理器，該值必須爲AJP/1.3
proxyName：如這個鏈接器正在一個代理配置中被使用，指定這個屬性，在request.getServerName()時返回
redirectPort：如鏈接器不支持SSL請求，如收到SSL請求，Catalina容器將會自動重定向指定的端口號，讓其進行處理。
scheme：設置協議的名字，在request.getScheme()時返回，SSL鏈接器設爲」https」，默認爲」http」
secure：在SSL鏈接器可將其設置爲true，默認爲false
URIEncoding：用於解碼URL的字符編碼，沒有指定默認值爲ISO-8859-1
useBodyEncodingForURI：主要用於Tomcat4.1.x中，指示是否使用在contentType中指定的編碼來取代URIEncoding，用於解碼URI查詢參數，默認爲false
xpoweredBy：爲true時，Tomcat使用規範建議的報頭代表支持Servlet的規範版本，默認爲false
acceptCount：當全部的可能處理的線程都正在使用時，在隊列中排隊請求的最大數目。當隊列已滿，任何接收到的請求都會被拒絕，默認值爲10
bufferSize：設由鏈接器建立輸入流緩衝區的大小，以字節爲單位。默認狀況下，緩存區大的大小爲2048字節
compressableMimeType：MIME的列表，默認以逗號分隔。默認值是text/html，text/xml，text/plain
compression：指定是否對響應的數據進行壓縮。off：表示禁止壓縮、on：表示容許壓縮（文本將被壓縮）、force：表示全部狀況下都進行壓縮，默認值爲off
connectionTimeout：設置鏈接的超時值，以毫秒爲單位。默認值爲60000=60秒
disableUploadTimeOut：容許Servlet容器，正在執行使用一個較長的鏈接超時值，以使Servlet有較長的時間來完成它的執行，默認值爲false
maxHttpHeaderSize：HTTP請求和響應頭的最大量，以字節爲單位，默認值爲4096字節
maxKeepAliveRequest：服務器關閉以前，客戶端發送的流水線最大數目。默認值爲100
maxSpareThreads：容許存在空閒線程的最大數目，默認值爲50
minSpareThreads：設當鏈接器第一次啓協建立線程的數目，確保至少有這麼多的空閒線程可用。默認值爲4
port：服務端套接字監聽的TCP端口號，默認值爲8080（必須）
socketBuffer：設Socket輸出緩衝區的大小（以字節爲單位），-1表示禁止緩衝，默認值爲9000字節
toNoDelay：爲true時，能夠提升性能。默認值爲true
threadPriority：設JVM中請求處理線程優先級。默認值爲NORMAL-PRIORITY
例：
<Connector
port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false"
redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />

AJP鏈接器：
用於將Apache與Tomcat集成在一塊兒，當Apache接收到動態內容請求時，經過在配置中指定的端口號將請求發送給在此端口號上監聽的AJP鏈接器組件。
屬性：
backlog：當全部可能的請求處理線程都在使用時，隊列中排隊的請求最大數目。默認爲10，當隊列已滿，任何請求都將被拒絕
maxSpareThread：容許存在空閒線程的最大數目，默認值爲50
maxThread：最大線程數，默認值爲200
minSpareThreads：設當鏈接器第一次啓動時建立線程的數目，確保至少有這麼多的空閒線程可用，默認值爲4
port：服務端套接字的TCP端口號，默認值爲8089（必須）
topNoDelay：爲true時，能夠提升性能，默認值爲true
soTimeout：超時值
例：
<!—Define an AJP1.3 Connector on port 8089-->
<Connector port=」8089」 enableLookups=」false」 redirectPort=」8443」 protocol=」AJP/1.3」 />

-->

<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