元素名 |
屬性 |
解釋 |
server |
port |
指定一個連接埠,這個連接埠負責監聽關閉tomcat 的請求 |
shutdown |
指定向連接埠發送的命令字串 |
service |
name |
指定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.2001-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 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 name ="Catalina" > < Service name ="Apache" >
第一個<Service>處理所有直接由Tomcat伺服器接收的web客戶請求.
第二個<Service>處理所有由Apahce伺服器轉寄過來的Web客戶請求
1>className 指定實現org.apahce.catalina.Service介面的類.預設為org.apahce.catalina.core.StandardService2>name定義Service的名字<Engine>元素每個Service元素只能有一個Engine元素.元素處理在同一個<Service>中所有<Connector>元素接收到的客戶請求.由org.apahce.catalina.Engine介面定義.
< 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應用.
< Host name ="localhost" debug ="0" appBase ="webapps" unpackWARs ="true" autoDeploy ="true">
1>className指定實現Host介面的類.預設值為StandardHost
2>appBase指定虛擬機器主機的目錄,可以指定絕對目錄,也可以指定相對於<CATALINA_HOME>的相對目錄.如果沒有此項,預設為<CATALINA_HOME>/webapps3>autoDeploy如果此項設為true,表示Tomcat服務處於運行狀態時,能夠監測appBase下的檔案,如果有新有web應用加入進來,會自運發布這個WEB應用4>unpackWARs如果此項設定為true,表示把WEB應用的WAR檔案先展開為開放目錄結構後再運行.如果設為false將直接運行為WAR檔案5>alias指定主機別名,可以指定多個別名
6>deployOnStartup如果此項設為true,表示Tomcat伺服器啟動時會自動發布appBase目錄下所有的Web應用.如果Web應用中的server.xml沒有相應的<Context>元素,將採用Tomcat預設的Context7>name定義虛擬機器主機的名字
在<Host>元素中可以包含如下子項目
<Logger>, <Realm>, <Value>, <Context><Context>元素它由Context介面定義.是使用最頻繁的元素.每個<Context元素代表了運行在虛擬機器主機上的單個Web應用.一個<Host>可以包含多個<Context>元素.每個web應用有唯一的一個相對應的Context代表web應用自身.servlet容器為第一個web應用建立一個
ServletContext對象.
< Context path ="/sample" docBase ="sample" debug ="0" reloadbale ="true" >
1>className指定實現Context的類,預設為StandardContext類
2>path指定訪問Web應用的URL入口,注意/myweb,而不是myweb了事
3>reloadable如果這個屬性設為true, Tomcat伺服器在運行狀態下會監視在WEB-INF/classes和Web-INF/lib目錄CLASS檔案的改運.如果監視到有class檔案被更新,伺服器自重新載入Web應用3>cookies指定是否通過Cookies來支援Session,預設值為true
4>useNaming指定是否支援JNDI,預設值為了true在<Context>元素中可以包含如下元素<Logger>, <Realm>, <Resource>, <ResourceParams><Connector>元素
由Connector介面定義.<Connector>元素代表與客戶程式實際互動的給件,它負責接收客戶請求,以及向客戶返迴響應結果.
< 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連接埠接收由其它伺服器轉寄過來的請求.Connector元素共用屬性
1>className指定實現Connector介面的類
2>enableLookups如果設為true,表示支援網域名稱解析,可以把IP位址解析為主機名稱.WEB應用中調用request.getRemoteHost方法返回客戶機主機名稱.預設值為true3>redirectPort指定轉送連接埠.如果當前連接埠只支援non-SSL請求,在需要安全通訊的場命,將把客戶請求轉寄至SSL的redirectPort連接埠HttpConnector元素的屬性
1>className實現Connector的類
2>port設定Tcp/IP連接埠,預設值為8080,如果把8080改成80,則只要輸入http://localhost 即可,因為TCP/IP的預設連接埠是80
3>address如果伺服器有二個以上ip地址,此屬性可以設定連接埠監聽的ip地址.預設情況下,連接埠會監聽伺服器上所有的ip地址4>bufferSize設定由連接埠建立的輸入資料流的緩衝大小.預設值為2048byte
5>protocol設定Http協議,預設值為HTTP/1.1
6>maxThreads設定在監聽連接埠的線程的最大數目,這個值也決定了伺服器可以同時響應客戶請求的最大數目.預設值為2007>acceptCount設定在監聽連接埠隊列的最大客戶請求數量,預設值為10.如果隊列已滿,客戶必須等待.
8>connectionTimeout定義建立客戶連線逾時的時間.如果為-1,表示不限制建立客戶串連的時間
JkConnector的屬性
1>className實現Connector的類
2>port設定AJP連接埠號碼
3>protocol必須設定為AJP/1.3