tomcat配置文件server.xml詳解

元素名	屬性	解釋
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.StandardService
2>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>/webapps
3>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默認的Context
7>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方法返回客戶機主機名.默認值爲true
3>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設定在監聽端口的線程的最大數目,這個值也決定了服務器能夠同時響應客戶請求的最大數目.默認值爲200
7>acceptCount設定在監聽端口隊列的最大客戶請求數量,默認值爲10.若是隊列已滿,客戶必須等待.
8>connectionTimeout定義創建客戶鏈接超時的時間.若是爲-1,表示不限制創建客戶鏈接的時間
JkConnector的屬性
1>className實現Connector的類
2>port設定AJP端口號
3>protocol必須設定爲AJP/1.3 ========================================================================================  

<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.StandardService
2> 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>/webapps
3> 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默認的Context
7> 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方法返回客戶機主機名.默認值爲true
3> 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設定在監聽端口的線程的最大數目,這個值也決定了服務器能夠同時響應客戶請求的最大數目.默認值爲200
7> acceptCount設定在監聽端口隊列的最大客戶請求數量,默認值爲10.若是隊列已滿,客戶必須等待.
8> connectionTimeout定義創建客戶鏈接超時的時間.若是爲-1,表示不限制創建客戶鏈接的時間

JkConnector的屬性 
1> className實現Connector的類
2> port設定AJP端口號
3> protocol必須設定爲AJP/1.3