元素名 |
屬性 |
解釋 |
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>元素
< Server port ="8005" shutdown ="SHUTDOWN" debug ="0" >
1>className指定實現org.apache.catalina.Server接口的類.默認值爲org.apache.catalina.core.StandardServer<Service>元素
< Service name ="Catalina" >
< Service name ="Apache" >
第一個<Service>處理所有直接由Tomcat服務器接收的web客戶請求.1>className 指定實現org.apahce.catalina.Service接口的類.默認爲org.apahce.catalina.core.StandardService
<Engine>元素
< Engine name ="Catalina" defaultHost ="localhost" debug ="0" >
2>defaultHost指定處理客戶的默認主機名,在<Engine>中的<Host>子元素中必須定義這一主機
3>name定義Engine的名字
在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>
<Host>元素
< Host name ="localhost" debug ="0" appBase ="webapps" unpackWARs ="true" autoDeploy ="true">
2>appBase指定虛擬主機的目錄,可以指定絕對目錄,也可以指定相對於<CATALINA_HOME>的相對目錄.如果沒有此項,默認爲<CATALINA_HOME>/webapps
6>deployOnStartup如果此項設爲true,表示Tomcat服務器啓動時會自動發佈appBase目錄下所有的Web應用.如果Web應用中的server.xml沒有相應的<Context>元素,將採用Tomcat默認的Context
在<Host>元素中可以包含如下子元素
<Logger>, <Realm>, <Value>, <Context>
<Context>元素
ServletContext對象.
< Context path ="/sample" docBase ="sample" debug ="0" reloadbale ="true" >
2>path指定訪問Web應用的URL入口,注意/myweb,而不是myweb了事
3>reloadable如果這個屬性設爲true, Tomcat服務器在運行狀態下會監視在WEB-INF/classes和Web-INF/lib目錄CLASS文件的改運.如果監視到有class文件被更新,服務器自重新加載Web應用
4>useNaming指定是否支持JNDI,默認值爲了true
<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元素共用屬性
1>className指定實現Connector接口的類2>enableLookups如果設爲true,表示支持域名解析,可以把IP地址解析爲主機名.WEB應用中調用request.getRemoteHost方法返回客戶機主機名.默認值爲true
HttpConnector元素的屬性
1>className實現Connector的類2>port設定Tcp/IP端口,默認值爲8080,如果把8080改成80,則只要輸入http://localhost 即可,因爲TCP/IP的默認端口是80
3>address如果服務器有二個以上ip地址,此屬性可以設定端口監聽的ip地址.默認情況下,端口會監聽服務器上所有的ip地址
5>protocol設定Http協議,默認值爲HTTP/1.1
6>maxThreads設定在監聽端口的線程的最大數目,這個值也決定了服務器可以同時響應客戶請求的最大數目.默認值爲200
8>connectionTimeout定義建立客戶連接超時的時間.如果爲-1,表示不限制建立客戶連接的時間
JkConnector的屬性
1>className實現Connector的類2>port設定AJP端口號
3>protocol必須設定爲AJP/1.3