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