一、Tomcat 圖解
tomcat
二、server.xml樣例
<Server>
<Listener />
<GlobaNamingResources>
</GlobaNamingResources>
<Service>
<Connector />
<Engine>
<Logger />
<Realm />
<host>
<Logger />
<Context />
</host>
</Engine>
</Service>
</Server>
該文件描述了如何啟動(dòng)Tomcat Server
三、配置詳解
1、配置表
description1
description2
2、Tomcat Server處理一個(gè)http請(qǐng)求的過程
假設(shè)來自客戶的請(qǐng)求為：http://localhost:8080/wsota/wsota_index.jsp
- 請(qǐng)求被發(fā)送到本機(jī)端口8080，被在那里偵聽的Coyote HTTP/1.1 Connector獲得
- Connector把該請(qǐng)求交給它所在的Service的Engine來處理，并等待來自Engine的回應(yīng)
- Engine獲得請(qǐng)求localhost/wsota/wsota_index.jsp，匹配它所擁有的所有虛擬主機(jī)Host
- Engine匹配到名為localhost的Host（即使匹配不到也把請(qǐng)求交給該Host處理，因?yàn)樵揌ost被定義為該Engine的默認(rèn)主機(jī)）
- localhost Host獲得請(qǐng)求/wsota/wsota_index.jsp，匹配它所擁有的所有Context
- Host匹配到路徑為/wsota的Context（如果匹配不到就把該請(qǐng)求交給路徑名為""的Context去處理）
- path="/wsota"的Context獲得請(qǐng)求/wsota_index.jsp，在它的mapping table中尋找對(duì)應(yīng)的servlet
- Context匹配到URL PATTERN為*.jsp的servlet，對(duì)應(yīng)于JspServlet類
- 構(gòu)造HttpServletRequest對(duì)象和HttpServletResponse對(duì)象，作為參數(shù)調(diào)用JspServlet的doGet或doPost方法
- Context把執(zhí)行完了之后的HttpServletResponse對(duì)象返回給Host
- Host把HttpServletResponse對(duì)象返回給Engine
- Engine把HttpServletResponse對(duì)象返回給Connector
- Connector把HttpServletResponse對(duì)象返回給客戶browser
3、配置說明
<\Server>元素
它代表整個(gè)容器,是Tomcat實(shí)例的頂層元素.由org.apache.catalina.Server接口來定義.它包含一個(gè)元素.并且它不能做為任何元素的子元素.
一個(gè)“Server”是一個(gè)提供完整的JVM的獨(dú)立組件，它可以包含一個(gè)或多個(gè)“Service”實(shí)例
服務(wù)器在指定的端口上監(jiān)聽shutdown命令
一個(gè)“Server”自身不是一個(gè)“Container”（容器），因此不可以定義諸如“Valves”或者“Loggers”子組件
啟動(dòng)Server 在端口8005處等待關(guān)閉命令 如果接受到"SHUTDOWN"字符串則關(guān)閉服務(wù)器
<Server port="8005" shutdown="SHUTDOWN" debug="0">
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è)置
<\Service>元素
該元素由org.apache.catalina.Service接口定義,它包含一個(gè)元素,以及一個(gè)或多個(gè),這些Connector元素共享用同一個(gè)Engine元素
<!-- 一個(gè)“Service”是一個(gè)或多個(gè)共用一個(gè)單獨(dú)“Container”(容器)的“Connectors”組合（因此，應(yīng)用程序在容器中可見）。
通常，這個(gè)容器是一個(gè)“Engine”（引擎），但這不是必須的。-->
注意：一個(gè)“Service”自身不是一個(gè)容器，因此，在這個(gè)級(jí)別上你不可定義諸如“Valves”或“Loggers”子組件。
Tomcat的Standalone Service
Service是一組Connector的集合
它們共用一個(gè)Engine來處理所有Connector收到的請(qǐng)求
**<Service name="Catalina"\>**
**<Service name="Apache"\>**
第一個(gè)<Service>處理所有直接由Tomcat服務(wù)器接收的web客戶請(qǐng)求
第二個(gè)<Service>處理所有由Apahce服務(wù)器轉(zhuǎn)發(fā)過來的Web客戶請(qǐng)求
- className 指定實(shí)現(xiàn)org.apahce.catalina.Service接口的類.默認(rèn)為org.apahce.catalina.core.StandardService
- name定義Service的名字
<\Connector>元素
由Connector接口定義.元素代表與客戶程序?qū)嶋H交互的給件,它負(fù)責(zé)接收客戶請(qǐng)求,以及向客戶返回響應(yīng)結(jié)果
<!-- 一個(gè)“Connector”（連接器）代表一個(gè)請(qǐng)求被接收和應(yīng)答所需要的端點(diǎn)。每個(gè)連接器通過相關(guān)的“Container”（容器）處理請(qǐng)求。-->
<!-- 默認(rèn)情況下，一個(gè)非SSL的HTTP/1.1的連接器被綁定在端口8080。
你也可以通過根據(jù)后面的使用說明并取消第二個(gè)連接器入口的注釋，在端口8443上建立一個(gè)SSL HTTP/1.1的連接器。
開放SSL支持需要下面幾步（參見Tomcat 5文檔中怎樣配置SSL的說明以取得更多的詳細(xì)信息）：
* 如果你的JDK是1.3或1.3以前的版本，下載安裝JSSE 1.0.2或以后版本，并放置JAR文件到“$JAVA_HOME/jre/lib/ext”目錄下。
* 帶一個(gè)“changeit”的口令值執(zhí)行：
%JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA (Windows)
$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA (UNIX)
來生成它自己的證書私鑰。
默認(rèn)情況下，當(dāng)一個(gè)web應(yīng)用程序調(diào)用請(qǐng)求時(shí)，DNS查詢是可行的。
這將對(duì)性能造成一些不利的影響，因此，你可以將“enableLookups”設(shè)置為“false”來關(guān)閉DNS查詢。
當(dāng)DNS查詢被關(guān)閉時(shí)，request.getRemoteHost()將返回包含遠(yuǎn)程客戶IP地址的字符串。-->
Coyote HTTP/1.1 Connector
className : 該Connector的實(shí)現(xiàn)類是org.apache.coyote.tomcat4.CoyoteConnector
port : 在端口號(hào)8080處偵聽來自客戶browser的HTTP1.1請(qǐng)求.如果把8080改成80,則只要輸入http://localhost/即可
protocol:設(shè)定Http協(xié)議,默認(rèn)值為HTTP/1.1
minSpareThreads: 該Connector先創(chuàng)建5個(gè)線程等待客戶請(qǐng)求，每個(gè)請(qǐng)求由一個(gè)線程負(fù)責(zé)
maxSpareThread:設(shè)定在監(jiān)聽端口的線程的最大數(shù)目,這個(gè)值也決定了服務(wù)器可以同時(shí)響應(yīng)客戶請(qǐng)求的最大數(shù)目.默認(rèn)值為200
acceptCount : 當(dāng)現(xiàn)有線程已經(jīng)達(dá)到最大數(shù)75時(shí)，為客戶請(qǐng)求排隊(duì).當(dāng)隊(duì)列中請(qǐng)求數(shù)超過100時(shí)，后來的請(qǐng)求返回Connection refused錯(cuò)誤
redirectport : 當(dāng)客戶請(qǐng)求是https時(shí)，把該請(qǐng)求轉(zhuǎn)發(fā)到端口8443去
enableLookups:如果設(shè)為true,表示支持域名解析,可以把IP地址解析為主機(jī)名.WEB應(yīng)用中調(diào)用request.getRemoteHost方法返回客戶機(jī)主機(jī)名.默認(rèn)值為true
connectionTimeout:定義建立客戶連接超時(shí)的時(shí)間.如果為-1,表示不限制建立客戶連接的時(shí)間
allowTrace：是否允許HTTP的TRACE方法，默認(rèn)為false
emptySessionPath：如果設(shè)置為true，用戶的所有路徑都將設(shè)置為/，默認(rèn)為false。
enableLookups：調(diào)用request、getRemoteHost()執(zhí)行DNS查詢，以返回遠(yuǎn)程主機(jī)的主機(jī)名，如果設(shè)置為false，則直接返回IP地址。
maxPostSize：指定POST方式請(qǐng)求的最大量，沒有指定默認(rèn)為2097152。
protocol：值必須為HTTP1.1，如果使用AJP處理器，該值必須為AJP/1.3
proxyName：如這個(gè)連接器正在一個(gè)代理配置中被使用，指定這個(gè)屬性，在request.getServerName()時(shí)返回
redirectPort：如連接器不支持SSL請(qǐng)求，如收到SSL請(qǐng)求，Catalina容器將會(huì)自動(dòng)重定向指定的端口號(hào)，讓其進(jìn)行處理。
scheme：設(shè)置協(xié)議的名字，在request.getScheme()時(shí)返回，SSL連接器設(shè)為”https”，默認(rèn)為”http”
secure：在SSL連接器可將其設(shè)置為true，默認(rèn)為false
URIEncoding：用于解碼URL的字符編碼，沒有指定默認(rèn)值為ISO-8859-1
useBodyEncodingForURI：主要用于Tomcat4.1.x中，指示是否使用在contentType中指定的編碼來取代URIEncoding，用于解碼URI查詢參數(shù)，默認(rèn)為false
xpoweredBy：為true時(shí)，Tomcat使用規(guī)范建議的報(bào)頭表明支持Servlet的規(guī)范版本，默認(rèn)為false
acceptCount：當(dāng)所有的可能處理的線程都正在使用時(shí)，在隊(duì)列中排隊(duì)請(qǐng)求的最大數(shù)目。當(dāng)隊(duì)列已滿，任何接收到的請(qǐng)求都會(huì)被拒絕，默認(rèn)值為10
bufferSize：設(shè)由連接器創(chuàng)建輸入流緩沖區(qū)的大小，以字節(jié)為單位。默認(rèn)情況下，緩存區(qū)大的大小為2048字節(jié)
compressableMimeType：MIME的列表，默認(rèn)以逗號(hào)分隔。默認(rèn)值是text/html，text/xml，text/plain
compression：指定是否對(duì)響應(yīng)的數(shù)據(jù)進(jìn)行壓縮。off：表示禁止壓縮、on：表示允許壓縮（文本將被壓縮）、force：表示所有情況下都進(jìn)行壓縮，默認(rèn)值為off
connectionTimeout：設(shè)置連接的超時(shí)值，以毫秒為單位。默認(rèn)值為60000=60秒
disableUploadTimeOut：允許Servlet容器，正在執(zhí)行使用一個(gè)較長(zhǎng)的連接超時(shí)值，以使Servlet有較長(zhǎng)的時(shí)間來完成它的執(zhí)行，默認(rèn)值為false
maxHttpHeaderSize：HTTP請(qǐng)求和響應(yīng)頭的最大量，以字節(jié)為單位，默認(rèn)值為4096字節(jié)
maxKeepAliveRequest：服務(wù)器關(guān)閉之前，客戶端發(fā)送的流水線最大數(shù)目。默認(rèn)值為100
maxSpareThreads：允許存在空閑線程的最大數(shù)目，默認(rèn)值為50
minSpareThreads：設(shè)當(dāng)連接器第一次啟協(xié)創(chuàng)建線程的數(shù)目，確保至少有這么多的空閑線程可用。默認(rèn)值為4
port：服務(wù)端套接字監(jiān)聽的TCP端口號(hào)，默認(rèn)值為8080（必須）
socketBuffer：設(shè)Socket輸出緩沖區(qū)的大?。ㄒ宰止?jié)為單位），-1表示禁止緩沖，默認(rèn)值為9000字節(jié)
toNoDelay：為true時(shí)，可以提高性能。默認(rèn)值為true
threadPriority：設(shè)JVM中請(qǐng)求處理線程優(yōu)先級(jí)。默認(rèn)值為NORMAL-PRIORITY
AJP連接器：
用于將Apache與Tomcat集成在一起，當(dāng)Apache接收到動(dòng)態(tài)內(nèi)容請(qǐng)求時(shí)，通過在配置中指定的端口號(hào)將請(qǐng)求發(fā)送給在此端口號(hào)上監(jiān)聽的AJP連接器組件。
backlog：當(dāng)所有可能的請(qǐng)求處理線程都在使用時(shí)，隊(duì)列中排隊(duì)的請(qǐng)求最大數(shù)目。默認(rèn)為10，當(dāng)隊(duì)列已滿，任何請(qǐng)求都將被拒絕
maxSpareThread：允許存在空閑線程的最大數(shù)目，默認(rèn)值為50
maxThread：最大線程數(shù)，默認(rèn)值為200
minSpareThreads：設(shè)當(dāng)連接器第一次啟動(dòng)時(shí)創(chuàng)建線程的數(shù)目，確保至少有這么多的空閑線程可用，默認(rèn)值為4
port：服務(wù)端套接字的TCP端口號(hào)，默認(rèn)值為8089（必須）
topNoDelay：為true時(shí)，可以提高性能，默認(rèn)值為true
soTimeout：超時(shí)值
例如：
<!—Define an AJP1.3 Connector on port 8089-->
<Connector port=”8089” enableLookups=”false” redirectPort=”8443” protocol=”AJP/1.3” />
<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" />
- 第一個(gè)Connector元素定義了一個(gè)HTTP Connector,它通過8080端口接收HTTP請(qǐng)求;
- 第二個(gè)Connector元素定義了一個(gè)JD Connector,它通過8009端口接收由其它服務(wù)器轉(zhuǎn)發(fā)過來的請(qǐng)求.
<\Engine>元素
每個(gè)Service元素只能有一個(gè)Engine元素.處理在同一個(gè)中所有元素接收到的客戶請(qǐng)求
由org.apahce.catalina.Engine接口定義
<!-- 一個(gè)“Engine”（引擎）代表處理每個(gè)請(qǐng)求的入口點(diǎn)（在Catalina內(nèi)）。
這個(gè)Tomcat的標(biāo)準(zhǔn)獨(dú)立引擎實(shí)現(xiàn)分析包含在請(qǐng)求中的HTTP頭信息，
并將請(qǐng)求傳送到適當(dāng)?shù)闹鳈C(jī)或虛擬主機(jī)上 -->
<!-- Engine用來處理Connector收到的Http請(qǐng)求它將匹配請(qǐng)求和自己的虛擬主機(jī)，
并把請(qǐng)求轉(zhuǎn)交給對(duì)應(yīng)的Host來處理默認(rèn)虛擬主機(jī)是localhost -->
<Engine name="Catalina" defaultHost="localhost" debug="0">
1>className指定實(shí)現(xiàn)Engine接口的類,默認(rèn)值為StandardEngine
2>defaultHost指定處理客戶的默認(rèn)主機(jī)名,在<Engine>中的<Host>子元素中必須定義這一主機(jī)
3>name定義Engine的名字
在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>
<\Host>元素
它由Host接口定義.一個(gè)Engine元素可以包含多個(gè)元素.每個(gè)的元素定義了一個(gè)虛擬主機(jī)
它包含了一個(gè)或多個(gè)Web應(yīng)用
<!-- 定義默認(rèn)的虛擬主機(jī)
注意：XML模式確認(rèn)將不能與Xerces 2.2同工作。
-->
<!-- 虛擬主機(jī)localhost
appBase : 指定虛擬主機(jī)的目錄,可以指定絕對(duì)目錄,也可以指定相對(duì)于<CATALINA_HOME>的相對(duì)目錄
如果沒有此項(xiàng),默認(rèn)為<CATALINA_HOME>/webapps
它將匹配請(qǐng)求和自己的Context的路徑,并把請(qǐng)求轉(zhuǎn)交給對(duì)應(yīng)的Context來處理
autoDeploy:如果此項(xiàng)設(shè)為true,表示Tomcat服務(wù)處于運(yùn)行狀態(tài)時(shí),能夠監(jiān)測(cè)appBase下的文件,如果有新有web應(yīng)用加入進(jìn)來,會(huì)自運(yùn)發(fā)布這個(gè)WEB應(yīng)用
unpackWARs:如果此項(xiàng)設(shè)置為true,表示把WEB應(yīng)用的WAR文件先展開為開放目錄結(jié)構(gòu)后再運(yùn)行.如果設(shè)為false將直接運(yùn)行為WAR文件
alias:指定主機(jī)別名,可以指定多個(gè)別名
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)的<Context>元素,將采用Tomcat默認(rèn)的Context
-->
<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">
在<Host>元素中可以包含如下子元素<Logger>, <Realm>, <Value>, <Context>
<\Context>元素
它由Context接口定義.是使用最頻繁的元素
每個(gè)<context元素代表了運(yùn)行在虛擬主機(jī)上的單個(gè)web應(yīng)用
一個(gè)可以包含多個(gè)元素.每個(gè)web應(yīng)用有唯一的一個(gè)相對(duì)應(yīng)的Context代表web應(yīng)用自身
servlet容器為第一個(gè)web應(yīng)用創(chuàng)建一個(gè)
<!-- Context，對(duì)應(yīng)于一個(gè)Web App
path : 該Context的路徑名是""，故該Context是該Host的默認(rèn)Context
docBase : 該Context的根目錄是webapps/mycontext/
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)用
useNaming:指定是否支持JNDI,默認(rèn)值為了true
cookies指定是否通過Cookies來支持Session,默認(rèn)值為true
-->
<Context path="" docBase="mycontext" debug="0"/>
