Tomcat中server.xml配置詳解

時間 2019-12-13

標籤 tomcat server.xml server xml 配置詳解欄目 Tomcat 简体版

原文原文鏈接

tomcat中server.xml配置詳解

Tomcat Server的結構圖以下：html

該文件描述瞭如何啓動Tomcat Serverweb

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

<\Server>元素apache

它表明整個容器,是Tomcat實例的頂層元素.由org.apache.catalina.Server接口來定義.它包含一個元素.而且它不能作爲任何元素的子元素. 緩存

<!--一個「Server」是一個提供完整的JVM的獨立組件，它能夠包含一個或多個「Service」實例。服務器在指定的端口上監聽shutdown命令。-->

 注意：一個「Server」自身不是一個「Container」（容器），所以在這裏你
 不能夠定義諸如「Valves」或者「Loggers」子組件-->

<!-- 啓動Server
 在端口8005處等待關閉命令
 若是接受到"SHUTDOWN"字符串則關閉服務器-->

測試：
telnet localhost 8005
輸入：SHUTDOWN
結果：關閉tomcattomcat

<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接口定義,它包含一個元素,以及一個或多個 ,這些Connector元素共享用同一個Engine元素 cookie

<!-- 一個「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>元素app

由Connector接口定義. 元素表明與客戶程序實際交互的給件,它負責接收客戶請求,以及向客戶返回響應結果. webapp

<!-- 一個「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 Connectorsocket

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元素.處理在同一個中全部元素接收到的客戶請求.由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元素能夠包含多個元素.每一個的元素定義了一個虛擬主機.它包含了一個或多個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應用.一個能夠包含多個元素.每一個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