1. 程式人生 > >tomcat中server.xml配置詳解

tomcat中server.xml配置詳解

連接超時 兩個 數據大小 value soc 訪客 ace sed 器)

  Tomcat Server的結構圖如下:該文件描述了如何啟動Tomcat Server。

<Server port="8005" shutdown="SHUTDOWN">
    <Listener />
    <GlobaNamingResources></GlobaNamingResources>
    <Service name="Catalina">
    <Executor ...... />
    <Connector />     <Engine name="Catalina" ... >
      <Logger />       <Realm />       <host name="localhost" ...>         <Logger />         <Context />       </host>     </Engine>   </Service> </Server>

  即一個由 Server->Service->Engine->Host->Context 組成的四層結構,從裏層向外層分別是:

Context: 即 Web 應用程序,一個 Context 即對於一個 Web 應用程序。
Host:即虛擬主機,比如 www.dog.com 對應一個虛擬主機,api.dog.com 對於另一個虛擬主機。一個 Host 用於定義一個虛擬主機。(所謂的”一個虛擬主機”可簡單理解為”一個網站”)
Engine:一組虛擬主機的集合。比如www.dog.com 和 api.dog.com 可以組成一組虛擬主機集合。
Service:一組 Engine 的集合,包括線程池 Executor 和連接器 Connector 的定義。

<\Server>

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

<!--一個“Server”是一個提供完整的JVM的獨立組件,它可以包含一個或多個“Service”實例。服務器在指定的端口上監聽shutdown命令。--> 
註意:一個“Server”自身不是一個“Container”(容器),因此在這裏你 不可以定義諸如“Valves”或者“Loggers”子組件--> 
<!-- 啟動Server 在端口8005處等待關閉命令 如果接受到"SHUTDOWN"字符串則關閉服務器
-->

  測試: telnet localhost 8005

  輸入:SHUTDOWN

  結果:關閉tomcat

  結果:關閉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接口定義,它包含一個元素,以及一個或多個,這些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接口定義.元素代表與客戶程序實際交互的給件,它負責接收客戶請求,以及向客戶返回響應結果。

<!-- 一個“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的名字

Coyote HTTP/1.1 Connector

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

port : 在端口號8080處偵聽來自客戶browser的HTTP1.1請求.如果把8080改成80,則只要輸入http://localhost/即可。
adress:連接器所綁定的IP地址,當一臺服務器存在多個ip地址時可以指定其中的需要綁定的一個,默認不設置該屬性的值表示綁定當前服務器的所有ip地址。 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地址。
  (default=true) 是否
允許反向解析訪客的IP地址,當你的應用程序使用 request.getRemoteHost() 時如果只需要IP地址,建議禁用此項,這樣能節省反向域名解析的時間。 maxPostSize:指定POST方式請求的最大量,沒有指定默認default(default=2097152 即2MB)最大允許POST上傳的數據大小(單位為:字節),
  對於一般網站來說,比如有寫評論寫文章的網站,默認的2MB已經足夠,不過如果網站帶有圖片甚至文件上傳功能,則需要根據具體情況來定。
protocol:連接器的類型,值必須為HTTP1.1,如果使用AJP處理器,該值必須為AJP/1.3。
  tomcat 6 有如下幾種選擇:
  
org.apache.coyote.http11.Http11Protocol:簡寫為 “HTTP/1.1″,這是默認的連接器,一個訪客網絡連接需要一個線程,並發性能比較低。

   org.apache.coyote.http11.Http11NioProtocol:NIO連接器,一個由非阻塞的socket工作模式構成的連接器,並發性能良好,純Java實現。

   org.apache.coyote.http11.Http11AprProtocol:APR連接器,所謂APR就是網絡上最多服務器使用的 Web 服務程序Apache Http Server所使用的庫,Tomcat 建議在生產環境使用

proxyName:如這個連接器正在一個代理配置中被使用,指定這個屬性,在request.getServerName()時返回
redirectPort:如連接器不支持SSL請求,如收到SSL請求,Catalina容器將會自動重定向指定的端口號,讓其進行處理。
  用戶訪問非https的資源而該資源又需要https方式訪問時,tomcat會自動重定向到https端口,一般https使用 TCP 443端口,所以一般取值”443″。

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

  多站點的配置:設置多個HOST節點
  有時我們需要在一臺服務器上跑多個站點,通過 Tomcat 很容易實現這點,下面假設我們要搭建 www.dog.com 和 www.cat.com 這兩個站點。
  首先要確定你的兩個域名的 DNS 已經能正確解析到你的服務器,因為這裏我們是做實驗,所以可以在本機添加域名解析。修改 /etc/hosts 文件,加入如下兩行:

127.0.0.1    www.cat.com
127.0.0.1    www.dog.com

  然後在 /var/lib/tomcat6 目錄裏分別創建名字為 cat 和 dog 的兩個目錄,然後在每個目錄裏都創建名字為 ROOT 的目錄,並在 ROOT 裏面創建名字為 index.html 文件(內容隨便)。然後將目錄 cat 和 dog 的所有者和所有組都更改為 tomcat。
  現在編輯 Tomcat 的主配置文件 server.xml,在默認的 Host 節點下面再加入如下兩個新的 Host 節點:

<Host name="www.dog.com" appBase="/var/lib/tomcat6/dog" autoDeploy="true" unpackWARs="true"></Host>  
<Host name="www.cat.com" appBase="/var/lib/tomcat6/cat" autoDeploy="true" unpackWARs="true"></Host> 

<\Context>元素

  它由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對象返回給客戶browse

tomcat中server.xml配置詳解