Tomcat Server.xml詳解

原文地址:http://www.blogjava.net/baoyaer/articles/107278.html

Tomcat Server的結構圖

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

 


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

 

 

屬性

 

 

解釋

 

 

serverport指定一個端口,這個端口負責監聽關閉tomcat的請求
shutdown指定向端口發送的命令字符串
servicename指定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,表示不限制建立客戶連接的時間其它屬性略 –>

<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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章