Tomcat中的Connector配置講解

2024-09-01 13:56:42

字體：大中小

供稿：網(wǎng)友

JBoss使用Tomcat作為Web容器，因此在JBoss中對于Web容器的配置也類似于在Tomcat中的配置，主要就是對于 server.xml文件的編輯，在JBoss 5.x中，這個文件位于${JBOSS.HOME}/server/${confifure}/deploy/jbossweb.sar下，其中 configure的值可以是all, default,web，standard, minimal等。下面的代碼展示了一個JBoss default配置下的server.xml，由于篇幅原因，將其中的注釋都已經(jīng)去掉了。

<Server>   <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />   <Listener className="org.apache.catalina.core.JasperListener" />   <Service name="jboss.web">    <Connector protocol="HTTP/1.1" port="8080" address="${jboss.bind.address}"          connectionTimeout="20000" redirectPort="8443" compression="on"          compressionMinSize="1" compressableMimeType="text/html,text/xml" />    <Engine name="jboss.web" defaultHost="localhost">      <Realm className="org.jboss.web.tomcat.security.JBossWebRealm"       certificatePrincipal="org.jboss.security.auth.certs.SubjectDNMapping"       allRolesMode="authOnly"       />      <Host name="localhost">        <Valve className="org.jboss.web.tomcat.service.jca.CachedConnectionValve"       cachedConnectionManagerObjectName="jboss.jca:service=CachedConnectionManager"       transactionManagerObjectName="jboss:service=TransactionManager" />      Host>    Engine>   Service> Server>

在上面的配置文件中，Server是根節(jié)點，一個Server就代表一個Servlet容器，因此在server.xml中，這個節(jié)點只能有一個，在Server節(jié)點下，可以存在一個或者多個Service節(jié)點。

一個Service節(jié)點代表了一個或者多個Connector和一個Engine，而Connector和Engine是在server.xml中兩個重要的配置項，Connector的主要功能是接受、響應(yīng)用戶請求。常用的Connector有HTTP/1.1 Connector和AJP Connector，HTTP/1.1 Connector主要用于處理用戶的HTTP請求，需要注意的是雖然它名叫HTTP/1.1 Connector，但是是完全兼容HTTP/1.0協(xié)議的。AJP Connector主要使用AJP協(xié)議和Web Connector通信，通常用于集群中。

HTTP/1.1 Connector的實例監(jiān)聽在用戶配置的端口上，當(dāng)應(yīng)用服務(wù)器啟動時，HTTP/1.1 Connector負責(zé)創(chuàng)建若干線程，用于處理用戶請求，創(chuàng)建的線程數(shù)目取決于用戶配置的minThreads值，默認為5，當(dāng)有更多的用戶請求到來時，HTTP/1.1 Connector將會創(chuàng)建更多的線程用于處理請求，創(chuàng)建線程的最大值由maxThreads定義，默認值為20，當(dāng)所有的線程都在忙于處理用戶請求時，新到來的請求將會放入HTTP/1.1 Connector創(chuàng)建的Socket隊列中，隊列的長度由acceptCount屬性定義，當(dāng)?shù)却犃幸脖徽加脻M了，新來的用戶請求將會收到connection refused錯誤。

所有的Connector提供的配置項（不完全版scheme, isSecure, xpoweredBy, useIPVHosts ）：

allowTrace 如果需要服務(wù)器能夠處理用戶的HAED/TRACE請求，這個值應(yīng)該設(shè)置為true，默認值是false;
emptySessionPath 如果設(shè)置為true，所有session,cookie的path將會被設(shè)置為/，這種設(shè)置通常是在portlet中比較有用，默認值是false；
enableLookups 如果需要在調(diào)用request.getRemoteHost()方法時獲取到客戶端的機器名，則需要配置為true,如果配置為false，將會跳過DNS查詢直接返回客戶端機器的IP地址，通常為了提高性能，將此值設(shè)置為false，默認值是true;
maxPostSize POST方法能夠提交的數(shù)據(jù)的最大大小，如果沒有聲明或者設(shè)置為小于等于0，則表示POST提交的數(shù)據(jù)大小是不限制的，默認值是2Megabytes.
protocol 設(shè)置處理請求的協(xié)議，默認是HTTP/1.1，即org.apache.coyote.http11.Http11Protocol，此外還支持的協(xié)議有：org.apache.coyote.http11.Http11NioProtocol（通過NIO處理用戶請求，可以提高系統(tǒng)性能）， org.apache.coyote.http11.HttpAprProtocol。
proxyName/proxyPort 如果Web服務(wù)器使用了代理服務(wù)器，配置此參數(shù)意味著在調(diào)用request.getServerName的時候?qū)@取代理服務(wù)器的名稱，getServerPort()將會返回proxyPort。
redirectPort 如果Connector的配置是支持非SSL的請求，當(dāng)一個SSL請求到來時，服務(wù)器會自動的將請求重定位到redirectPort。
URIEncoding URI字節(jié)轉(zhuǎn)化成String的時候的編碼方式，默認為ISO-8859-1，如果頁面需要支持中文，一般可以將其設(shè)置為UTF-8或者GBK,GB2312。
useBodyEncodingForURI 如果設(shè)置為true,則會根據(jù)頁面的編碼決定URI的編碼方式，默認是false。

Http/1.1 Connector提供的配置項：

acceptCount 等待隊列的長度，默認值是100。
address 如果Tomcat所在的主機有多個IP，這個值聲明了用于監(jiān)聽HTTP請求的IP地址。
bufferSize Connector創(chuàng)建的輸入流的大小，默認值是2048 bytes，提高這個值可以提升性能，增加內(nèi)存消耗。
compressableMimeType 使用HTTP壓縮的MIME類型，使用逗號分割，默認值是 text/html,text/xml,text/plain。
compression 為了節(jié)省帶寬，可以將這個值設(shè)置為on，從而啟用HTTP/1.1 GZIP壓縮。off關(guān)閉壓縮，forces強制使用壓縮，默認值是off。
connectionTimeout Connector接受一個連接后等待的時間(milliseconds)，默認值是60000。
executor 在Service節(jié)點下，Connector節(jié)點前可以配置一個Executor節(jié)點用于管理線程，這個屬性的值是配置的Executor的名稱，如果應(yīng)用了此屬性且executor存在，那么任何其他的關(guān)于thread的配置將會被忽略。
keepAliveTimeout 在Connector關(guān)閉連接前，Connector為另外一個請求Keep Alive所等待的微妙數(shù)，默認值和 connectionTimeout 一樣。
maxHttpHeaderSize HTTP請求、響應(yīng)頭信息的最大大小，默認是8192bytes。
maxKeepAliveRequests HTTP/1.0 Keep Alive 和HTTP/1.1 Keep Alive / Pipeline的最大請求數(shù)目，如果設(shè)置為1，將會禁用掉Keep Alive和Pipeline，如果設(shè)置為小于0的數(shù)，Keep Alive的最大請求數(shù)將沒有限制。默認為100。
maxThreads 用于處理用戶請求的最大線程數(shù)，默認值是20。
noCompressionUserAgents: 設(shè)置不使用HTTP GZIP壓縮的客戶端，使用逗號分隔，在某些瀏覽器不支持壓縮的時候可以使用此屬性。
port Connector監(jiān)聽的端口。
restrictedUserAgents 設(shè)置不使用Keep Alive的客戶端代理名稱，使用逗號分割，默認值是空字符串。
server 覆蓋HTTP響應(yīng)的serve頭信息，如果不設(shè)置的話，默認值是 Apache-Coyote/1.1。一般情況下不需要關(guān)注此屬性。
socketBuffer Socket輸出流緩沖區(qū)的大小，默認是9000bytes,如果設(shè)置為小于0的值，則表示不使用此緩沖區(qū)。
tcpNoDelay 默認值是true，設(shè)置為true可以提高系統(tǒng)性能。
threadPriority 請求處理線程的優(yōu)先級，默認的優(yōu)先級是NORMAL。