tomcat中的server.xml元素詳解 【Z】

liuchang0001發表於2011-01-13
TomcatServerXML

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

相關文章