port
指定一個(gè)端口,這個(gè)端口負(fù)責(zé)監(jiān)聽關(guān)閉tomcat的請求
shutdown
指定向端口發(fā)送的命令字符串
service
name
指定service的名字
Connector(表示客戶端和service之間的連接)
port
指定服務(wù)器端要?jiǎng)?chuàng)建的端口號(hào),并在這個(gè)端口監(jiān)聽來自客戶端的請求
minProcessors
服務(wù)器啟動(dòng)時(shí)創(chuàng)建的處理請求的線程數(shù)
maxProcessors
最大可以創(chuàng)建的處理請求的線程數(shù)
enableLookups
如果為true,則可以通過調(diào)用request.getRemoteHost()進(jìn)行DNS查詢來得到遠(yuǎn)程客戶端的實(shí)際主機(jī)名,若為false則不進(jìn)行DNS查詢,而是返回其ip地址
redirectPort
指定服務(wù)器正在處理http請求時(shí)收到了一個(gè)SSL傳輸請求后重定向的端口號(hào)
acceptCount
指定當(dāng)所有可以使用的處理請求的線程數(shù)都被使用時(shí),可以放到處理隊(duì)列中的請求數(shù),超過這個(gè)數(shù)的請求將不予處理
connectionTimeout
指定超時(shí)的時(shí)間數(shù)(以毫秒為單位)
Engine(表示指定service中的請求處理機(jī),接收和處理來自Connector的請求)
defaultHost
指定缺省的處理請求的主機(jī)名,它至少與其中的一個(gè)host元素的name屬性值是一樣的
Context(表示一個(gè)web應(yīng)用程序,通常為WAR文件,關(guān)于WAR的具體信息見servlet規(guī)范)
docBase
應(yīng)用程序的路徑或者是WAR文件存放的路徑
path
表示此web應(yīng)用程序的url的前綴,這樣請求的url為http://localhost:8080/path/****
reloadable
這個(gè)屬性非常重要,如果為true,則tomcat會(huì)自動(dòng)檢測應(yīng)用程序的/WEB-INF/lib 和/WEB-INF/classes目錄的變化,自動(dòng)裝載新的應(yīng)用程序,我們可以在不重起tomcat的情況下改變應(yīng)用程序
host(表示一個(gè)虛擬主機(jī))
name
指定主機(jī)名
appBase
應(yīng)用程序基本目錄,即存放應(yīng)用程序的目錄
unpackWARs
如果為true,則tomcat會(huì)自動(dòng)將WAR文件解壓,否則不解壓,直接從WAR文件中運(yùn)行應(yīng)用程序
Logger(表示日志,調(diào)試和錯(cuò)誤信息)
className
指定logger使用的類名,此類必須實(shí)現(xiàn)org.apache.catalina.Logger 接口
prefix
指定log文件的前綴
suffix
指定log文件的后綴
timestamp
如果為true,則log文件名中要加入時(shí)間,如下例:localhost_log.2001-10-04.txt
Realm(表示存放用戶名,密碼及role的數(shù)據(jù)庫)
className
指定Realm使用的類名,此類必須實(shí)現(xiàn)org.apache.catalina.Realm接口
Valve(功能與Logger差不多,其prefix和suffix屬性解釋和Logger 中的一樣)
className
指定Valve使用的類名,如用org.apache.catalina.valves.AccessLogValve類可以記錄應(yīng)用程序的訪問信息
directory
指定log文件存放的位置
pattern
有兩個(gè)值,common方式記錄遠(yuǎn)程主機(jī)名或ip地址,用戶名,日期,第一行請求的字符串,HTTP響應(yīng)代碼,發(fā)送的字節(jié)數(shù)。combined方式比common方式記錄的值更多
元素
它代表整個(gè)容器,是Tomcat實(shí)例的頂層元素.由org.apache.catalina.Server接口來定義.它包含一個(gè)元素.并且它不能做為任何元素的子元素.
1>className指定實(shí)現(xiàn)org.apache.catalina.Server接口的類.默認(rèn)值為org.apache.catalina.core.StandardServer
2>port指定Tomcat監(jiān)聽shutdown命令端口.終止服務(wù)器運(yùn)行時(shí),必須在Tomcat服務(wù)器所在的機(jī)器上發(fā)出shutdown命令.該屬性是必須的.
3>shutdown指定終止Tomcat服務(wù)器運(yùn)行時(shí),發(fā)給Tomcat服務(wù)器的shutdown監(jiān)聽端口的字符串.該屬性必須設(shè)置
元素
該元素由org.apache.catalina.Service接口定義,它包含一個(gè)元素,以及一個(gè)或多個(gè),這些Connector元素共享用同一個(gè)Engine元素
第一個(gè)處理所有直接由Tomcat服務(wù)器接收的web客戶請求.
第二個(gè)處理所有由Apahce服務(wù)器轉(zhuǎn)發(fā)過來的Web客戶請求
1>className 指定實(shí)現(xiàn)org.apahce.catalina.Service接口的類.默認(rèn)為org.apahce.catalina.core.StandardService
2>name定義Service的名字
元素
每個(gè)Service元素只能有一個(gè)Engine元素.元素處理在同一個(gè)中所有元素接收到的客戶請求.由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)用.
1>className指定實(shí)現(xiàn)Host接口的類.默認(rèn)值為StandardHost
2>appBase指定虛擬主機(jī)的目錄,可以指定絕對目錄,也可以指定相對于的相對目錄.如果沒有此項(xiàng),默認(rèn)為/webapps
3>autoDeploy如果此項(xiàng)設(shè)為true,表示Tomcat服務(wù)處于運(yùn)行狀態(tài)時(shí),能夠監(jiān)測appBase下的文件,如果有新有web應(yīng)用加入進(jìn)來,會(huì)自運(yùn)發(fā)布這個(gè)WEB應(yīng)用
4>unpackWARs如果此項(xiàng)設(shè)置為true,表示把WEB應(yīng)用的WAR文件先展開為開放目錄結(jié)構(gòu)后再運(yùn)行.如果設(shè)為false將直接運(yùn)行為WAR文件
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沒有相應(yīng)的元素,將采用Tomcat默認(rèn)的Context
7>name定義虛擬主機(jī)的名字
在元素中可以包含如下子元素
, , ,
元素
它由Context接口定義.是使用最頻繁的元素.每個(gè)可以包含多個(gè)元素.每個(gè)web應(yīng)用有唯一
的一個(gè)相對應(yīng)的Context代表web應(yīng)用自身.servlet容器為第一個(gè)web應(yīng)用創(chuàng)建一個(gè)
ServletContext對象.
1>className指定實(shí)現(xiàn)Context的類,默認(rèn)為StandardContext類
2>path指定訪問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指定是否通過Cookies來支持Session,默認(rèn)值為true
4>useNaming指定是否支持JNDI,默認(rèn)值為了true
在元素中可以包含如下元素
, , ,
Connector元素
由Connector接口定義.元素代表與客戶程序?qū)嶋H交互的給件,它負(fù)責(zé)接收客戶請求,以及向客戶返回響應(yīng)結(jié)果.
第一個(gè)Connector元素定義了一個(gè)HTTP Connector,它通過8080端口接收HTTP請求;第二個(gè)Connector元素定義了一個(gè)JD Connector,它通過8009端口接收由其它服務(wù)器轉(zhuǎn)發(fā)過來的請求.
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請求,在需要安全通信的場命,將把客戶請求轉(zhuǎn)發(fā)至SSL的redirectPort端口
HttpConnector元素的屬性
1>className實(shí)現(xiàn)Connector的類
2>port設(shè)定Tcp/IP端口,默認(rèn)值為8080,如果把8080改成80,則只要輸入http://localhost即可
因?yàn)門CP/IP的默認(rèn)端口是80
3>address如果服務(wù)器有二個(gè)以上ip地址,此屬性可以設(shè)定端口監(jiān)聽的ip地址.默認(rèn)情況下,端口會(huì)監(jiān)聽服務(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)聽端口的線程的最大數(shù)目,這個(gè)值也決定了服務(wù)器可以同時(shí)響應(yīng)客戶請求的最大數(shù)目.默認(rèn)值為200
7>acceptCount設(shè)定在監(jiān)聽端口隊(duì)列的最大客戶請求數(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