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 中的請求處理機，接收和

處理來自Connector 的請defaultHost

求)

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

息見servlet 規(guī)范)

reloadable name host (表示一個虛擬主機)

appBase unpackW ARs className

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

錯誤信息)

suffix timestamp

Realm (表示存放用戶名，

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

className

Valve (功能與Logger 差不className

解釋

指定一個端口，這個端口負責監(jiān)聽關(guān)閉tomcat 的請求 指定向端口發(fā)送的命令字符串 指定service 的名字

指定服務器端要創(chuàng)建的端口號，并在這個斷口監(jiān)聽來自客戶端的請求

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

如果為true ，則可以通過調(diào)用request.getRemoteHost()進行DNS 查詢來得到遠程客戶端的實際主機名，若為false 則不進行DNS 查詢，而是返回其ip 地址

指定服務器正在處理http 請求時收到了一個SSL 傳輸請求后重定向的端口號

指定當所有可以使用的處理請求的線程數(shù)都被使用時，可以放到處理隊列中的請求數(shù)，超過這個數(shù)的請求將不予處理

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

指定缺省的處理請求的主機名，它至少與其中的一個host 元素的name 屬性值是一樣的

應用程序的路徑或者是W AR 文件存放的路徑

表示此web 應用程序的url 的前綴，這樣請求的url 為****

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

應用程序基本目錄，即存放應用程序的目錄

如果為true ，則tomcat 會自動將W AR 文件解壓，否則不解壓，直接從WAR 文件中運行應用程序

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

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

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

多，其prefix 和suffix 屬

性解釋和Logger 中的一

directory 樣)

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

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

更多

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

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

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

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

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

第一個處理所有直接由Tomcat 服務器接收的web 客戶請求.

第二個處理所有由Apahce 服務器轉(zhuǎn)發(fā)過來的Web 客戶請求

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

2>name定義Service 的名字

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

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

2>defaultHost指定處理客戶的默認主機名, 在中的子元素中必須定義這一主機

3>name定義Engine 的名字

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

元素它由Host 接口定義. 一個Engine 元素可以包含多個元素. 每個的元素定義了一個虛擬主機. 它包含了一個或多個Web 應用.

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

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

2>appBase指定虛擬主機的目錄, 可以指定絕對目錄, 也可以指定相對于的相對目錄. 如果沒有此項, 默認為/webapps

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

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

5>alias指定主機別名, 可以指定多個別名

6>deployOnStartup如果此項設(shè)為true, 表示Tomcat 服務器啟動時會自動發(fā)布appBase 目錄下所有的Web 應用. 如果Web 應用中的server.xml 沒有相應的元素, 將采用Tomcat 默認的Context

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

, , ,

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

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

2>path指定訪問Web 應用的URL 入口, 注意/myweb,而不是myweb 了事

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

3>cookies指定是否通過Cookies 來支持Session, 默認值為true

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

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

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

protocol ="AJP/1.3" />

第一個Connector 元素定義了一個HTTP Connector, 它通過8080端口接收HTTP 請求; 第二個Connector 元素定義了一個JD Connector,它通過8009端口接收由其它服務器轉(zhuǎn)發(fā)過來的請求. Connector 元素共用屬性

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

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

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

HttpConnector 元素的屬性

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

2>port設(shè)定Tcp/IP端口, 默認值為8080, 如果把8080改成80, 則只要輸入即可 因為TCP/IP的默認端口是80

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

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

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

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

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

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

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

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

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