tomcat 中的server.xml 元素詳解元素名 屬性 server portshutdown servicename portminProcessors maxProcessorsConnec

tomcat 中的server.xml 元素詳解

元素名 屬性 server port

shutdown service

name port

minProcessors maxProcessors

Connector (表示客戶端和enableLookups

service 之間的連接)

redirectPort

acceptCount

connectionTimeout

Engine (表示指定service 中的請(qǐng)求處理機(jī)，接收和

處理來(lái)自Connector 的請(qǐng)defaultHost

求)

docBase Context (表示一個(gè)web 應(yīng)path 用程序，通常為W AR 文件，關(guān)于W AR 的具體信

息見(jiàn)servlet 規(guī)范)

reloadable name host (表示一個(gè)虛擬主機(jī))

appBase unpackW ARs className

Logger (表示日志，調(diào)試和prefix

錯(cuò)誤信息)

suffix timestamp

Realm (表示存放用戶名，

密碼及role 的數(shù)據(jù)庫(kù))

className

Valve (功能與Logger 差不className

解釋

指定一個(gè)端口，這個(gè)端口負(fù)責(zé)監(jiān)聽(tīng)關(guān)閉tomcat 的請(qǐng)求 指定向端口發(fā)送的命令字符串 指定service 的名字

指定服務(wù)器端要?jiǎng)?chuàng)建的端口號(hào)，并在這個(gè)斷口監(jiān)聽(tīng)來(lái)自客戶端的請(qǐng)求

服務(wù)器啟動(dòng)時(shí)創(chuàng)建的處理請(qǐng)求的線程數(shù) 最大可以創(chuàng)建的處理請(qǐng)求的線程數(shù)

如果為true ，則可以通過(guò)調(diào)用request.getRemoteHost()進(jìn)行DNS 查詢來(lái)得到遠(yuǎn)程客戶端的實(shí)際主機(jī)名，若為false 則不進(jìn)行DNS 查詢，而是返回其ip 地址

指定服務(wù)器正在處理http 請(qǐng)求時(shí)收到了一個(gè)SSL 傳輸請(qǐng)求后重定向的端口號(hào)

指定當(dāng)所有可以使用的處理請(qǐng)求的線程數(shù)都被使用時(shí)，可以放到處理隊(duì)列中的請(qǐng)求數(shù)，超過(guò)這個(gè)數(shù)的請(qǐng)求將不予處理

指定超時(shí)的時(shí)間數(shù)(以毫秒為單位)

指定缺省的處理請(qǐng)求的主機(jī)名，它至少與其中的一個(gè)host 元素的name 屬性值是一樣的

應(yīng)用程序的路徑或者是W AR 文件存放的路徑

表示此web 應(yīng)用程序的url 的前綴，這樣請(qǐng)求的url 為****

這個(gè)屬性非常重要，如果為true ，則tomcat 會(huì)自動(dòng)檢測(cè)應(yīng)用程序的/WEB-INF/lib 和/WEB-INF/classes目錄的變化，自動(dòng)裝載新的應(yīng)用程序，我們可以在不重起tomcat 的情況下改變應(yīng)用程序 指定主機(jī)名

應(yīng)用程序基本目錄，即存放應(yīng)用程序的目錄

如果為true ，則tomcat 會(huì)自動(dòng)將W AR 文件解壓，否則不解壓，直接從WAR 文件中運(yùn)行應(yīng)用程序

指定logger 使用的類名，此類必須實(shí)現(xiàn)org.apache.catalina.Logger 接口 指定log 文件的前綴 指定log 文件的后綴

如果為true ，則log 文件名中要加入時(shí)間，如下例:localhost_log.2001-10-04.txt

指定Realm 使用的類名，此類必須實(shí)現(xiàn)org.apache.catalina.Realm 接口 指定Valve 使用的類名，如用

多，其prefix 和suffix 屬

性解釋和Logger 中的一

directory 樣)

pattern org.apache.catalina.valves.AccessLogValve 類可以記錄應(yīng)用程序的訪問(wèn)信息 指定log 文件存放的位置 有兩個(gè)值，common 方式記錄遠(yuǎn)程主機(jī)名或ip 地址，用戶名，日期，第一行請(qǐng)求的字符串，HTTP 響應(yīng)代碼，

發(fā)送的字節(jié)數(shù)。combined 方式比common 方式記錄的值

更多

元素它代表整個(gè)容器, 是Tomcat 實(shí)例的頂層元素. 由org.apache.catalina.Server 接口來(lái)定義. 它包含一個(gè)元素. 并且它不能做為任何元素的子元素.

1>className指定實(shí)現(xiàn)org.apache.catalina.Server 接口的類. 默認(rèn)值為org.apache.catalina.core.StandardServer

2>port指定Tomcat 監(jiān)聽(tīng)shutdown 命令端口. 終止服務(wù)器運(yùn)行時(shí), 必須在Tomcat 服務(wù)器所在的機(jī)器上發(fā)出shutdown 命令. 該屬性是必須的.

3>shutdown指定終止Tomcat 服務(wù)器運(yùn)行時(shí), 發(fā)給Tomcat 服務(wù)器的shutdown 監(jiān)聽(tīng)端口的字符串. 該屬性必須設(shè)置

元素該元素由org.apache.catalina.Service 接口定義, 它包含一個(gè)元素, 以及一個(gè)或多個(gè),這些Connector 元素共享用同一個(gè)Engine 元素

第一個(gè)處理所有直接由Tomcat 服務(wù)器接收的web 客戶請(qǐng)求.

第二個(gè)處理所有由Apahce 服務(wù)器轉(zhuǎn)發(fā)過(guò)來(lái)的Web 客戶請(qǐng)求

1>className 指定實(shí)現(xiàn)org.apahce.catalina.Service 接口的類. 默認(rèn)為org.apahce.catalina.core.StandardService

2>name定義Service 的名字

元素每個(gè)Service 元素只能有一個(gè)Engine 元素. 元素處理在同一個(gè)中所有元素接收到的客戶請(qǐng)求. 由org.apahce.catalina.Engine 接口定義.

1>className指定實(shí)現(xiàn)Engine 接口的類, 默認(rèn)值為StandardEngine

2>defaultHost指定處理客戶的默認(rèn)主機(jī)名, 在中的子元素中必須定義這一主機(jī)

3>name定義Engine 的名字

在可以包含如下元素, , ,

元素它由Host 接口定義. 一個(gè)Engine 元素可以包含多個(gè)元素. 每個(gè)的元素定義了一個(gè)虛擬主機(jī). 它包含了一個(gè)或多個(gè)Web 應(yīng)用.

autoDeploy ="true"> debug ="0" appBase ="webapps" unpackWARs ="true"

1>className指定實(shí)現(xiàn)Host 接口的類. 默認(rèn)值為StandardHost

2>appBase指定虛擬主機(jī)的目錄, 可以指定絕對(duì)目錄, 也可以指定相對(duì)于的相對(duì)目錄. 如果沒(méi)有此項(xiàng), 默認(rèn)為/webapps

3>autoDeploy如果此項(xiàng)設(shè)為true, 表示Tomcat 服務(wù)處于運(yùn)行狀態(tài)時(shí), 能夠監(jiān)測(cè)appBase 下的文件, 如果有新有web 應(yīng)用加入進(jìn)來(lái), 會(huì)自運(yùn)發(fā)布這個(gè)WEB 應(yīng)用

4>unpackWARs 如果此項(xiàng)設(shè)置為true, 表示把WEB 應(yīng)用的W AR 文件先展開(kāi)為開(kāi)放目錄結(jié)構(gòu)后再運(yùn)行. 如果設(shè)為false 將直接運(yùn)行為W AR 文件

5>alias指定主機(jī)別名, 可以指定多個(gè)別名

6>deployOnStartup如果此項(xiàng)設(shè)為true, 表示Tomcat 服務(wù)器啟動(dòng)時(shí)會(huì)自動(dòng)發(fā)布appBase 目錄下所有的Web 應(yīng)用. 如果Web 應(yīng)用中的server.xml 沒(méi)有相應(yīng)的元素, 將采用Tomcat 默認(rèn)的Context

7>name定義虛擬主機(jī)的名字, 在元素中可以包含如下子元素.

, , ,

元素它由Context 接口定義. 是使用最頻繁的元素. 每個(gè)可以包含多個(gè)元素. 每個(gè)web 應(yīng)用有唯一的一個(gè)相對(duì)應(yīng)的Context 代表web 應(yīng)用自身.servlet 容器為第一個(gè)web 應(yīng)用創(chuàng)建一個(gè)ServletContext 對(duì)象.

1>className指定實(shí)現(xiàn)Context 的類, 默認(rèn)為StandardContext 類

2>path指定訪問(wèn)Web 應(yīng)用的URL 入口, 注意/myweb,而不是myweb 了事

3>reloadable如果這個(gè)屬性設(shè)為true, Tomcat服務(wù)器在運(yùn)行狀態(tài)下會(huì)監(jiān)視在WEB-INF/classes和Web-INF/lib目錄CLASS 文件的改運(yùn). 如果監(jiān)視到有class 文件被更新, 服務(wù)器自重新加載Web 應(yīng)用

3>cookies指定是否通過(guò)Cookies 來(lái)支持Session, 默認(rèn)值為true

4>useNaming指定是否支持JNDI, 默認(rèn)值為了true, 在元素中可以包含如下元素 , , ,

元素由Connector 接口定義.元素代表與客戶程序?qū)嶋H交互的給件, 它負(fù)責(zé)接收客戶請(qǐng)求, 以及向客戶返回響應(yīng)結(jié)果.

connectionTimeout ="20000" disableUploadTimeout="true" />

protocol ="AJP/1.3" />

第一個(gè)Connector 元素定義了一個(gè)HTTP Connector, 它通過(guò)8080端口接收HTTP 請(qǐng)求; 第二個(gè)Connector 元素定義了一個(gè)JD Connector,它通過(guò)8009端口接收由其它服務(wù)器轉(zhuǎn)發(fā)過(guò)來(lái)的請(qǐng)求. Connector 元素共用屬性

1>className指定實(shí)現(xiàn)Connector 接口的類

2>enableLookups如果設(shè)為true, 表示支持域名解析, 可以把IP 地址解析為主機(jī)名.WEB 應(yīng)用中調(diào)用request.getRemoteHost 方法返回客戶機(jī)主機(jī)名. 默認(rèn)值為true

3>redirectPort指定轉(zhuǎn)發(fā)端口. 如果當(dāng)前端口只支持non-SSL 請(qǐng)求, 在需要安全通信的場(chǎng)命, 將把客戶請(qǐng)求轉(zhuǎn)發(fā)至SSL 的redirectPort 端口

HttpConnector 元素的屬性

1>className實(shí)現(xiàn)Connector 的類

2>port設(shè)定Tcp/IP端口, 默認(rèn)值為8080, 如果把8080改成80, 則只要輸入即可 因?yàn)門(mén)CP/IP的默認(rèn)端口是80

3>address如果服務(wù)器有二個(gè)以上ip 地址, 此屬性可以設(shè)定端口監(jiān)聽(tīng)的ip 地址. 默認(rèn)情況下, 端口會(huì)監(jiān)聽(tīng)服務(wù)器上所有的ip 地址

4>bufferSize設(shè)定由端口創(chuàng)建的輸入流的緩存大小. 默認(rèn)值為2048byte

5>protocol設(shè)定Http 協(xié)議, 默認(rèn)值為HTTP/1.1

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

7>acceptCount設(shè)定在監(jiān)聽(tīng)端口隊(duì)列的最大客戶請(qǐng)求數(shù)量, 默認(rèn)值為10. 如果隊(duì)列已滿, 客戶必須等待.

8>connectionTimeout定義建立客戶連接超時(shí)的時(shí)間. 如果為-1, 表示不限制建立客戶連接的時(shí)間JkConnector 的屬性

1>className實(shí)現(xiàn)Connector 的類

2>port設(shè)定AJP 端口號(hào)

3>protocol必須設(shè)定為AJP/1.3