Tomcat Server的結構圖
該檔案描述了如何啟動Tomcat Server
<Server>
<Listener />
<GlobaNamingResources> </GlobaNamingResources>
<Service>
<Connector />
<Engine>
<Logger />
<Realm />
<host>
<Logger />
<Context />
</host>
</Engine>
</Service>
</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”子元件 –>
<!– 啟動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