Tomcat服務(wù)器配置參考

Coyote HTTP/1.1 Connector

Coyote HTTP/1.1 Connector元素是一個(gè)支持HTTP/1.1協(xié)議的Connector組件。它使Catalina除了能夠執(zhí)行servlet和JSP頁(yè)面外，還能夠作為一個(gè)單獨(dú)的web server運(yùn)行。Connector對(duì)象的實(shí)例在服務(wù)器上監(jiān)聽特定的TCP端口。一個(gè)Service可以配置一個(gè)或多個(gè)這樣的Connector，每個(gè)Connector都把請(qǐng)求轉(zhuǎn)發(fā)給對(duì)應(yīng)Engine進(jìn)行處理，并產(chǎn)生響應(yīng)。

在 服務(wù)器啟動(dòng)的時(shí)候，Connector會(huì)創(chuàng)建一些請(qǐng)求處理線程（基于minProcessors屬性值）。每個(gè)請(qǐng)求需要一個(gè)線程為其服務(wù)，直到服務(wù)完成。 如果同一時(shí)刻的請(qǐng)求數(shù)多于可用的請(qǐng)求處理線程，會(huì)創(chuàng)建額外的處理線程，線程數(shù)的上限是maxProcessors。如果已經(jīng)到達(dá)了最大請(qǐng)求數(shù)，仍然有請(qǐng)求 發(fā)生，它們被緩存在由Connector創(chuàng)建的server socket中，直到緩存的上限（由acceptCount屬性的值定義）。這以后所有的請(qǐng)求都會(huì)收到“拒絕連接”的錯(cuò)誤，直到有資源能夠處理它們。

公共屬性

所有Connector的實(shí)現(xiàn)支持如下屬性： 屬性 描述 enableLookups 如果希望調(diào)用request.getRemoteHost()進(jìn)行DNS查詢，以返回遠(yuǎn)程客戶的實(shí)際主機(jī)名，將enableLookups設(shè)為true。如果希望忽略DNS查詢，僅僅返回IP地址，設(shè)為false（這樣提高了性能）。缺省情況下，DNS查詢是使能的。 redirectPort 如果Connector支持非SSL請(qǐng)求，在收到一個(gè)要求使用SSL傳輸?shù)恼?qǐng)求以后，Catalina會(huì)自動(dòng)將該請(qǐng)求重定向到這里指定的端口號(hào)。 scheme 調(diào)用request.getScheme()時(shí)返回的協(xié)議名稱。比如，在SSL Connector上可能將這個(gè)屬性設(shè)為“https”。缺省值為“http”，更多信息，參考SSL支持 secure 如果希望在該Connector接收到的請(qǐng)求上調(diào)用request.isSecure()返回true，設(shè)置該屬性為true。缺省值為false。

標(biāo)準(zhǔn)實(shí)現(xiàn)

Coyote HTTP/1.1 Connector的標(biāo)準(zhǔn)實(shí)現(xiàn)是org.apache.coyote.tomcat5.CoyoteConnector。它還支持如下的附加屬性 屬性 描述 acceptCount 當(dāng)所有可能的請(qǐng)求處理線程都被使用的時(shí)候，連接請(qǐng)求隊(duì)列的最大長(zhǎng)度。如果該隊(duì)列為滿，所有的請(qǐng)求都被拒絕，缺省值為10。 address 對(duì)于具有多個(gè)IP地址的server，這個(gè)屬性指定了用于監(jiān)聽特定端口的地址。缺省情況下，端口作用于server的所有IP地址。 bufferSize connector創(chuàng)建的輸入流緩沖區(qū)的大?。ㄒ宰止?jié)為單位）。缺省情況下，bufferSize=2048。 compression 為 了節(jié)省服務(wù)器帶寬，Connector可能使用HTTP/1.1 GZIP壓縮。這個(gè)參數(shù)的可接受值為“off”（不使用壓縮），“on”（壓縮文本數(shù)據(jù)），“force”（在所有的情況下強(qiáng)制壓縮），或者使用一個(gè)數(shù)值 整數(shù)（等價(jià)于“on”，但是指定了輸出被壓縮是的最小的數(shù)據(jù)數(shù)）。如果content-length未知， 而compression設(shè)置成“on”或者 更強(qiáng)，輸出也會(huì)被壓縮。如果沒有指定，這個(gè)屬性被設(shè)成“off” connectionLinger 當(dāng)Connector使用的socket被關(guān)閉的時(shí)候，保留該socket的時(shí)間，以毫秒為單位。缺省值為－1（不使用socket linger） connectionTimeout 在Connector接受一個(gè)連接以后，等待發(fā)生第一個(gè)請(qǐng)求的時(shí)間，以毫秒為單位。缺省值為60000（60秒） debug 日志消息的詳細(xì)程度，數(shù)字越大，輸出越詳細(xì)，如果沒有指定，使用缺省值0。 disableUploadTimeout 這個(gè)標(biāo)志允許servlet container在一個(gè)servlet執(zhí)行的時(shí)候，使用一個(gè)不同的，更長(zhǎng)的連接超時(shí)。最終的結(jié)果是給servlet更長(zhǎng)的時(shí)間以便完成其執(zhí)行，或者在數(shù)據(jù)上載的時(shí)候更長(zhǎng)的超時(shí)時(shí)間。如果沒有指定，設(shè)為false。 maxKeepAliveRequests 在server關(guān)閉連接之前，接受的HTTP請(qǐng)求的最大數(shù)目。如果該值設(shè)為1，會(huì)禁止HTTP/1.0?；睿瑫r(shí)也會(huì)禁止HTTP/1.1?；詈蚿ipelining。如果沒有指定，設(shè)為100。 maxSpareThreads 在線程池開始停止不必要的線程之前，允許存在的最大未使用的請(qǐng)求處理線程。缺省值為50。   maxThreads Connector能夠創(chuàng)建的最大請(qǐng)求處理線程數(shù)，這個(gè)值決定了同時(shí)能夠處理的最大請(qǐng)求數(shù)。如果沒有指定，缺省值為200。 minSpareThreads 當(dāng)Connector第一次啟動(dòng)時(shí)，創(chuàng)建的請(qǐng)求處理線程數(shù)。connector同時(shí)必須保證指定數(shù)目的空閑處理線程。這個(gè)值應(yīng)該設(shè)置成比maxThreads小的數(shù)值，缺省值為4。 port Connector創(chuàng)建server socket并等待連接的TCP端口號(hào)。操作系統(tǒng)在特定的IP地址上只允許一個(gè)服務(wù)器應(yīng)用程序監(jiān)聽特定的端口。 protocol 為了使用HTTP處理器，該屬性值必須為HTTP/1.1（缺省值） proxyName 如果connector在代理配置中使用，將這個(gè)屬性設(shè)置成調(diào)用request.getServerName()時(shí)返回的服務(wù)器名稱。更多信息參考代理支持。 proxyPort 如果Connector在代理配置中使用，這個(gè)屬性指定了調(diào)用request.getServerPort()返回的端口值。更多信息參考代理支持。 socketBuffer socket輸出緩沖區(qū)的大小。如果為－1，不使用緩沖。缺省值為9000字節(jié)。 tcpNoDelay 如果為true，服務(wù)器socket會(huì)設(shè)置TCP_NO_DELAY選項(xiàng)，在大多數(shù)情況下可以提高性能。缺省情況下設(shè)為true。

可以嵌套在Connector中的唯一元素是Factory，用來配置服務(wù)器套接口工廠組件。這個(gè)組件從來都不需要，現(xiàn)在支持這個(gè)組件是為了與Tomcat的早期版本兼容。

HTTP/1.1 和HTTP/1.0 支持

Connector 支持HTTP/1.1協(xié)議的所有必需特征（如RFC2616所描述的），包括永久性連接，流水線，expectations and chunked encoding。如果客戶端（通常是一個(gè)瀏覽器）只支持HTTP/1.0，Connector會(huì)自動(dòng)跳回到HTTP/1.0。不需要特殊的配置來使能這 個(gè)支持。Connector也支持HTTP/1.0?；顧C(jī)制。 RFC2616要求HTTP服務(wù)器的響應(yīng)總是以它們宣稱支持的最高HTTP版本開始。因此，這個(gè)Connector在它的響應(yīng)的開始總是返回HTTP/1.1。

日志輸出

Connector產(chǎn)生的任何調(diào)試或者異常信息都會(huì)被自動(dòng)路由到與Connector所屬的Engine的Logger。不需要特殊的配置來使能這個(gè)支持。

代理支持

在Tomcat位于代理服務(wù)器后面時(shí)，可以使用proxyName和proxyPort屬性。這些屬性修改了調(diào)用 requset.getServerName()和request.getServerPort()的返回值，用來構(gòu)造重定向的絕對(duì)URL。如果不設(shè)置這 些值，返回值反映了代理服務(wù)器收到的連接的服務(wù)器名稱和端口號(hào)，而不是客戶端發(fā)起的服務(wù)器名稱和端口號(hào)。 更多信息，參考代理支持HOW-TO

SSL支持

對(duì)Connector的特定實(shí)例，可以將secure屬性設(shè)為true，來使能SSL支持。另外，可以配置如下屬性：   屬性 描述 algorithm 使用的認(rèn)證編碼算法。缺省值為SunX509。   clientAuth 如果在接受某個(gè)連接之前，需要客戶端發(fā)送有效證書鏈，將該值設(shè)為true。如果為false（缺省值），不需要使用證書鏈。除非客戶端請(qǐng)求被CLIENT-CERT認(rèn)證保護(hù)的資源。   keystoreFile 存儲(chǔ)服務(wù)器證書的keystore文件路徑。缺省情況下，路徑指向運(yùn)行Tomcat的用戶主目錄下的".keystore"。   keystorePass 用來訪問服務(wù)器證書的密碼，缺省值未"changeit"   keystoreType 用于存儲(chǔ)服務(wù)器證書的keystore文件的類型。缺省值未"JKS"   sslProtocol SSL協(xié)議的版本號(hào)，缺省值是TLS   ciphers 可以使用的加密算法列表，用逗號(hào)分開。如果沒有指定，可以使用任何算法。   更多信息，參考SSL Configuration HOW-TO.