Tomcat Server的結(jié)構(gòu)圖
該文件描述了如何啟動Tomcat Server

<Server>

<Listener />

<GlobaNamingResources>

</GlobaNamingResources

<Service>

<Connector />

<Engine>

<Logger />

<Realm />

<host>

<Logger />

<Context />

</host>

</Engine>

</Service>

</Server>
元素名
|
屬性
|
解釋
|
server
|
port
|
指定一個端口,這個端口負(fù)責(zé)監(jiān)聽關(guān)閉tomcat的請求
|
shutdown
|
指定向端口發(fā)送的命令字符串
|
service
|
name
|
指定service的名字
|
Connector(表示客戶端和service之間的連接)
|
port
|
指定服務(wù)器端要創(chuàng)建的端口號,并在這個斷口監(jiān)聽來自客戶端的請求
|
minProcessors
|
服務(wù)器啟動時創(chuàng)建的處理請求的線程數(shù)
|
maxProcessors
|
最大可以創(chuàng)建的處理請求的線程數(shù)
|
enableLookups
|
如果為true,則可以通過調(diào)用request.getRemoteHost()進(jìn)行DNS查詢來得到遠(yuǎn)程客戶端的實際主機(jī)名,若為false則不進(jìn)行DNS查詢,而是返回其ip地址
|
redirectPort
|
指定服務(wù)器正在處理http請求時收到了一個SSL傳輸請求后重定向的端口號
|
acceptCount
|
指定當(dāng)所有可以使用的處理請求的線程數(shù)都被使用時,可以放到處理隊列中的請求數(shù),超過這個數(shù)的請求將不予處理
|
connectionTimeout
|
指定超時的時間數(shù)(以毫秒為單位)
|
Engine(表示指定service中的請求處理機(jī),接收和處理來自Connector的請求)
|
defaultHost
|
指定缺省的處理請求的主機(jī)名,它至少與其中的一個host元素的name屬性值是一樣的
|
Context(表示一個web應(yīng)用程序,通常為WAR文件,關(guān)于WAR的具體信息見servlet規(guī)范)
|
docBase
|
應(yīng)用程序的路徑或者是WAR文件存放的路徑
|
path
|
表示此web應(yīng)用程序的url的前綴,這樣請求的url為http://localhost:8080/path/****
|
reloadable
|
這個屬性非常重要,如果為true,則tomcat會自動檢測應(yīng)用程序的/WEB-INF/lib 和/WEB-INF/classes目錄的變化,自動裝載新的應(yīng)用程序,我們可以在不重起tomcat的情況下改變應(yīng)用程序
|
host(表示一個虛擬主機(jī))
|
name
|
指定主機(jī)名
|
appBase
|
應(yīng)用程序基本目錄,即存放應(yīng)用程序的目錄
|
unpackWARs
|
如果為true,則tomcat會自動將WAR文件解壓,否則不解壓,直接從WAR文件中運(yùn)行應(yīng)用程序
|
Logger(表示日志,調(diào)試和錯誤信息)
|
className
|
指定logger使用的類名,此類必須實現(xiàn)org.apache.catalina.Logger 接口
|
prefix
|
指定log文件的前綴
|
suffix
|
指定log文件的后綴
|
timestamp
|
如果為true,則log文件名中要加入時間,如下例:localhost_log.001-10-04.txt
|
Realm(表示存放用戶名,密碼及role的數(shù)據(jù)庫)
|
className
|
指定Realm使用的類名,此類必須實現(xiàn)org.apache.catalina.Realm接口
|
Valve(功能與Logger差不多,其prefix和suffix屬性解釋和Logger 中的一樣)
|
className
|
指定Valve使用的類名,如用org.apache.catalina.valves.AccessLogValve類可以記錄應(yīng)用程序的訪問信息
|
directory
|
指定log文件存放的位置
|
pattern
|
有兩個值,common方式記錄遠(yuǎn)程主機(jī)名或ip地址,用戶名,日期,第一行請求的字符串,HTTP響應(yīng)代碼,發(fā)送的字節(jié)數(shù)。combined方式比common方式記錄的值更多
|
<Server>元素
它代表整個容器,是Tomcat實例的頂層元素.由org.apache.catalina.Server接口來定義.它包含一個<Service>元素.并且它不能做為任何元素的子元素.
<!-- 一個“Server”是一個提供完整的JVM的獨立組件,它可以包含一個或多個
“Service”實例。服務(wù)器在指定的端口上監(jiān)聽shutdown命令。
注意:一個“Server”自身不是一個“Container”(容器),因此在這里你
不可以定義諸如“Valves”或者“Loggers”子組件
-->

<!-- 啟動Server

在端口8005處等待關(guān)閉命令

如果接受到"SHUTDOWN"字符串則關(guān)閉服務(wù)器

-->

測試:
telnet localhost 8005
輸入:SHUTDOWN
結(jié)果:關(guān)閉tomcat
<Server port="8005" shutdown="SHUTDOWN" debug="0">
1>className指定實現(xiàn)org.apache.catalina.Server接口的類.默認(rèn)值為org.apache.catalina.core.StandardServer
2>port指定Tomcat監(jiān)聽shutdown命令端口.終止服務(wù)器運(yùn)行時,必須在Tomcat服務(wù)器所在的機(jī)器上發(fā)出shutdown命令.該屬性是必須的.
3>shutdown指定終止Tomcat服務(wù)器運(yùn)行時,發(fā)給Tomcat服務(wù)器的shutdown監(jiān)聽端口的字符串.該屬性必須設(shè)置
<Service>元素
該元素由org.apache.catalina.Service接口定義,它包含一個<Engine>元素,以及一個或多個<Connector>,這些Connector元素共享用同一個Engine元素
<!-- 一個“Service”是一個或多個共用一個單獨“Container”(容器)的“Connectors”
組合(因此,應(yīng)用程序在容器中可見)。通常,這個容器是一個“Engine”
(引擎),但這不是必須的。
注意:一個“Service”自身不是一個容器,因此,在這個級別上你不可定義
諸如“Valves”或“Loggers”子組件。
-->

<!-- Tomcat的Standalone Service

Service是一組Connector的集合

它們共用一個Engine來處理所有Connector收到的請求

-->
<Service name="Catalina">
<Service name="Apache">
第一個<Service>處理所有直接由Tomcat服務(wù)器接收的web客戶請求.
第二個<Service>處理所有由Apahce服務(wù)器轉(zhuǎn)發(fā)過來的Web客戶請求 .
1>className 指定實現(xiàn)org.apahce.catalina.Service接口的類.默認(rèn)為org.apahce.catalina.core.StandardService
2>name定義Service的名字
<Connector>元素
由Connector接口定義.<Connector>元素代表與客戶程序?qū)嶋H交互的給件,它負(fù)責(zé)接收客戶請求,以及向客戶返回響應(yīng)結(jié)果.
<!-- 一個“Connector”(連接器)代表一個請求被接收和應(yīng)答所需要的端點。每個連
接器通過相關(guān)的“Container”(容器)處理請求。
默認(rèn)情況下,一個非SSL的HTTP/1.1的連接器被綁定在端口8080。你也可以通過
根據(jù)后面的使用說明并取消第二個連接器入口的注釋,在端口8443上建立一個
SSL HTTP/1.1的連接器。開放SSL支持需要下面幾步(參見Tomcat 5文檔中怎樣
配置SSL的說明以取得更多的詳細(xì)信息):
* 如果你的JDK是1.3或1.3以前的版本,下載安裝JSSE 1.0.2或以后版本,并放
置JAR文件到“$JAVA_HOME/jre/lib/ext”目錄下。
* 帶一個“changeit”的口令值執(zhí)行:
%JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA (Windows)
$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA (UNIX)
來生成它自己的證書私鑰。
默認(rèn)情況下,當(dāng)一個web應(yīng)用程序調(diào)用請求時,DNS查詢是可行的。這將對性能造
成一些不利的影響,因此,你可以將“enableLookups”設(shè)置為“false”來關(guān)閉DNS
查詢。當(dāng)DNS查詢被關(guān)閉時,request.getRemoteHost()將返回包含遠(yuǎn)程客戶IP地
址的字符串。
-->

<!-- Coyote HTTP/1.1 Connector

className : 該Connector的實現(xiàn)類是org.apache.coyote.tomcat4.CoyoteConnector

port : 在端口號8080處偵聽來自客戶browser的HTTP1.1請求.如果把8080改成80,則只要輸入
http://localhost/即可
protocol:設(shè)定Http協(xié)議,默認(rèn)值為HTTP/1.1

minSpareThreads: 該Connector先創(chuàng)建5個線程等待客戶請求,每個請求由一個線程負(fù)責(zé)

maxSpareThread:設(shè)定在監(jiān)聽端口的線程的最大數(shù)目,這個值也決定了服務(wù)器可以同時響應(yīng)客戶請求的最大數(shù)目.默認(rèn)值為200

acceptCount : 當(dāng)現(xiàn)有線程已經(jīng)達(dá)到最大數(shù)75時,為客戶請求排隊.當(dāng)隊列中請求數(shù)超過100時,后來的請求返回Connection refused錯誤

redirectport : 當(dāng)客戶請求是https時,把該請求轉(zhuǎn)發(fā)到端口8443去
enableLookups:如果設(shè)為true,表示支持域名解析,可以把IP地址解析為主機(jī)名.WEB應(yīng)用中調(diào)用request.getRemoteHost方法返回客戶機(jī)主機(jī)名.默認(rèn)值為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端口接收由其它服務(wù)器轉(zhuǎn)發(fā)過來的請求.
<Engine>元素
每個Service元素只能有一個Engine元素.處理在同一個<Service>中所有<Connector>元素接收到的客戶請求.由org.apahce.catalina.Engine接口定義.
<!-- 一個“Engine”(引擎)代表處理每個請求的入口點(在Catalina內(nèi))。這個Tomcat
的標(biāo)準(zhǔn)獨立引擎實現(xiàn)分析包含在請求中的HTTP頭信息,并將請求傳送到適當(dāng)?shù)闹鳈C(jī)
或虛擬主機(jī)上。-->

<!-- Engine用來處理Connector收到的Http請求

它將匹配請求和自己的虛擬主機(jī),并把請求轉(zhuǎn)交給對應(yīng)的Host來處理

默認(rèn)虛擬主機(jī)是localhost

-->

<Engine name="Catalina" defaultHost="localhost" debug="0">
1>className指定實現(xiàn)Engine接口的類,默認(rèn)值為StandardEngine
2>defaultHost指定處理客戶的默認(rèn)主機(jī)名,在<Engine>中的<Host>子元素中必須定義這一主機(jī)
3>name定義Engine的名字
在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>
<Host>元素
它由Host接口定義.一個Engine元素可以包含多個<Host>元素.每個<Host>的元素定義了一個虛擬主機(jī).它包含了一個或多個Web應(yīng)用.
<!-- 定義默認(rèn)的虛擬主機(jī)
注意:XML模式確認(rèn)將不能與Xerces 2.2同工作。
-->

<!-- 虛擬主機(jī)localhost

appBase : 指定虛擬主機(jī)的目錄,可以指定絕對目錄,也可以指定相對于<CATALINA_HOME>的相對目錄.如果沒有此項,默認(rèn)為<CATALINA_HOME>/webapps. 它將匹配請求和自己的Context的路徑,并把請求轉(zhuǎn)交給對應(yīng)的Context來處理
autoDeploy:如果此項設(shè)為true,表示Tomcat服務(wù)處于運(yùn)行狀態(tài)時,能夠監(jiān)測appBase下的文件,如果有新有web應(yīng)用加入進(jìn)來,會自運(yùn)發(fā)布這個WEB應(yīng)用
unpackWARs:如果此項設(shè)置為true,表示把WEB應(yīng)用的WAR文件先展開為開放目錄結(jié)構(gòu)后再運(yùn)行.如果設(shè)為false將直接運(yùn)行為WAR文件
alias:指定主機(jī)別名,可以指定多個別名
deployOnStartup:如果此項設(shè)為true,表示Tomcat服務(wù)器啟動時會自動發(fā)布appBase目錄下所有的Web應(yīng)用.如果Web應(yīng)用中的server.xml沒有相應(yīng)的<Context>元素,將采用Tomcat默認(rèn)的Context

-->

<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">
在<Host>元素中可以包含如下子元素
<Logger>, <Realm>, <Value>, <Context>
<Context>元素
它由Context接口定義.是使用最頻繁的元素.每個<Context元素代表了運(yùn)行在虛擬主機(jī)上的單個Web應(yīng)用.一個<Host>可以包含多個<Context>元素.每個web應(yīng)用有唯一
的一個相對應(yīng)的Context代表web應(yīng)用自身.servlet容器為第一個web應(yīng)用創(chuàng)建一個

<!-- Context,對應(yīng)于一個Web App

path : 該Context的路徑名是"",故該Context是該Host的默認(rèn)Context

docBase : 該Context的根目錄是webapps/mycontext/
reloadable:如果這個屬性設(shè)為true, Tomcat服務(wù)器在運(yùn)行狀態(tài)下會監(jiān)視在WEB-INF/classes和Web-INF/lib目錄CLASS文件的改運(yùn).如果監(jiān)視到有class文件被更新,服務(wù)器自重新加載Web應(yīng)用
useNaming:指定是否支持JNDI,默認(rèn)值為了true
cookies指定是否通過Cookies來支持Session,默認(rèn)值為true

-->

<Context path="" docBase="mycontext" debug="0"/>
Tomcat Server處理一個http請求的過程
假設(shè)來自客戶的請求為:
http://localhost:8080/wsota/wsota_index.jsp
1) 請求被發(fā)送到本機(jī)端口8080,被在那里偵聽的Coyote HTTP/1.1 Connector獲得
2) Connector把該請求交給它所在的Service的Engine來處理,并等待來自Engine的回應(yīng)
3) Engine獲得請求localhost/wsota/wsota_index.jsp,匹配它所擁有的所有虛擬主機(jī)Host
4) Engine匹配到名為localhost的Host(即使匹配不到也把請求交給該Host處理,因為該Host被定義為該Engine的默認(rèn)主機(jī))
5) localhost Host獲得請求/wsota/wsota_index.jsp,匹配它所擁有的所有Context
6) Host匹配到路徑為/wsota的Context(如果匹配不到就把該請求交給路徑名為""的Context去處理)
7) path="/wsota"的Context獲得請求/wsota_index.jsp,在它的mapping table中尋找對應(yīng)的servlet
8) Context匹配到URL PATTERN為*.jsp的servlet,對應(yīng)于JspServlet類
9) 構(gòu)造HttpServletRequest對象和HttpServletResponse對象,作為參數(shù)調(diào)用JspServlet的doGet或doPost方法
10)Context把執(zhí)行完了之后的HttpServletResponse對象返回給Host
11)Host把HttpServletResponse對象返回給Engine
12)Engine把HttpServletResponse對象返回給Connector
13)Connector把HttpServletResponse對象返回給客戶browser