天天看點

【Tomcat】tomcat中server.xml配置詳解

Tomcat Server的結構圖如下:

【Tomcat】tomcat中server.xml配置詳解
該檔案描述了如何啟動Tomcat Server 
【Tomcat】tomcat中server.xml配置詳解
<Server>
【Tomcat】tomcat中server.xml配置詳解
    <Listener />
【Tomcat】tomcat中server.xml配置詳解
    <GlobaNamingResources>
【Tomcat】tomcat中server.xml配置詳解
    </GlobaNamingResources
【Tomcat】tomcat中server.xml配置詳解
    <Service>
【Tomcat】tomcat中server.xml配置詳解
        <Connector />
【Tomcat】tomcat中server.xml配置詳解
        <Engine>
【Tomcat】tomcat中server.xml配置詳解
            <Logger />
【Tomcat】tomcat中server.xml配置詳解
            <Realm />
【Tomcat】tomcat中server.xml配置詳解
               <host>
【Tomcat】tomcat中server.xml配置詳解
                   <Logger />
【Tomcat】tomcat中server.xml配置詳解
                   <Context />
【Tomcat】tomcat中server.xml配置詳解
               </host>
【Tomcat】tomcat中server.xml配置詳解
        </Engine>
【Tomcat】tomcat中server.xml配置詳解
    </Service>
【Tomcat】tomcat中server.xml配置詳解
</Server>

元素名 屬性 解釋
server port 指定一個端口,這個端口負責監聽關閉tomcat的請求
shutdown 指定向端口發送的指令字元串
service name 指定service的名字
Connector(表示用戶端和service之間的連接配接) 指定伺服器端要建立的端口号,并在這個斷口監聽來自用戶端的請求
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(表示一個虛拟主機) 指定主機名
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的資料庫) 指定Realm使用的類名,此類必須實作org.apache.catalina.Realm接口
Valve(功能與Logger差不多,其prefix和suffix屬性解釋和Logger 中的一樣) 指定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”子元件

-->

【Tomcat】tomcat中server.xml配置詳解

<!-- 啟動Server

【Tomcat】tomcat中server.xml配置詳解

     在端口8005處等待關閉指令

【Tomcat】tomcat中server.xml配置詳解

     如果接受到"SHUTDOWN"字元串則關閉伺服器

【Tomcat】tomcat中server.xml配置詳解

 -->

【Tomcat】tomcat中server.xml配置詳解

測試:

 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】tomcat中server.xml配置詳解

<!-- Tomcat的Standalone Service

【Tomcat】tomcat中server.xml配置詳解

Service是一組Connector的集合

【Tomcat】tomcat中server.xml配置詳解

它們共用一個Engine來處理所有Connector收到的請求

【Tomcat】tomcat中server.xml配置詳解

   <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地

         址的字元串。

【Tomcat】tomcat中server.xml配置詳解

<!-- Coyote HTTP/1.1 Connector

【Tomcat】tomcat中server.xml配置詳解

className : 該Connector的實作類是org.apache.coyote.tomcat4.CoyoteConnector

【Tomcat】tomcat中server.xml配置詳解

port : 在端口号8080處偵聽來自客戶browser的HTTP1.1請求.如果把8080改成80,則隻要輸入http://localhost/即可

    protocol:設定Http協定,預設值為HTTP/1.1

【Tomcat】tomcat中server.xml配置詳解

minSpareThreads: 該Connector先建立5個線程等待客戶請求,每個請求由一個線程負責

【Tomcat】tomcat中server.xml配置詳解

maxSpareThread:設定在監聽端口的線程的最大數目,這個值也決定了伺服器可以同時響應客戶請求的最大數目.預設值為200

【Tomcat】tomcat中server.xml配置詳解

    acceptCount : 當現有線程已經達到最大數75時,為客戶請求排隊.當隊列中請求數超過100時,後來的請求傳回Connection refused錯誤

【Tomcat】tomcat中server.xml配置詳解

redirectport : 當客戶請求是https時,把該請求轉發到端口8443去

   enableLookups:如果設為true,表示支援域名解析,可以把IP位址解析為主機名.WEB應用中調用request.getRemoteHost方法傳回客戶機主機名.預設值為true

   connectionTimeout:定義建立客戶連接配接逾時的時間.如果為-1,表示不限制建立客戶連接配接的時間

【Tomcat】tomcat中server.xml配置詳解

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” />

【Tomcat】tomcat中server.xml配置詳解

<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頭資訊,并将請求傳送到适當的主機

         或虛拟主機上。-->

【Tomcat】tomcat中server.xml配置詳解

<!-- Engine用來處理Connector收到的Http請求

【Tomcat】tomcat中server.xml配置詳解

         它将比對請求和自己的虛拟主機,并把請求轉交給對應的Host來處理

【Tomcat】tomcat中server.xml配置詳解

         預設虛拟主機是localhost

【Tomcat】tomcat中server.xml配置詳解

         -->

<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同工作。

      -->

【Tomcat】tomcat中server.xml配置詳解

<!-- 虛拟主機localhost

【Tomcat】tomcat中server.xml配置詳解

           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

【Tomcat】tomcat中server.xml配置詳解

           -->

【Tomcat】tomcat中server.xml配置詳解

<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應用建立一個

【Tomcat】tomcat中server.xml配置詳解

<!-- Context,對應于一個Web App

【Tomcat】tomcat中server.xml配置詳解

             path : 該Context的路徑名是"",故該Context是該Host的預設Context

【Tomcat】tomcat中server.xml配置詳解

             docBase : 該Context的根目錄是webapps/mycontext/

                reloadable:如果這個屬性設為true, Tomcat伺服器在運作狀态下會監視在WEB-INF/classes和Web-INF/lib目錄CLASS檔案的改運.如果監視到有class檔案 被更新,伺服器自重新加載Web應用

                useNaming:指定是否支援JNDI,預設值為了true 

                cookies指定是否通過Cookies來支援Session,預設值為true

【Tomcat】tomcat中server.xml配置詳解

             -->

【Tomcat】tomcat中server.xml配置詳解

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

補充:

  context元素有一個crossContext屬性,如果配置為true,則可以實作在同一個tomcat下的多個web應用之間實作ServletContext對象通路。該屬性主要用于跨應用通路資料。

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

【當你用心寫完每一篇部落格之後,你會發現它比你用代碼實作功能更有成就感!】

xml