Tomcat中的Connector配置講解

2024-09-01 13:56:42

字體：大中小

來源：轉載

供稿：網友

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，由于篇幅原因，將其中的注釋都已經去掉了。

<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是根節點，一個Server就代表一個Servlet容器，因此在server.xml中，這個節點只能有一個，在Server節點下，可以存在一個或者多個Service節點。

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

HTTP/1.1 Connector的實例監聽在用戶配置的端口上，當應用服務器啟動時，HTTP/1.1 Connector負責創建若干線程，用于處理用戶請求，創建的線程數目取決于用戶配置的minThreads值，默認為5，當有更多的用戶請求到來時，HTTP/1.1 Connector將會創建更多的線程用于處理請求，創建線程的最大值由maxThreads定義，默認值為20，當所有的線程都在忙于處理用戶請求時，新到來的請求將會放入HTTP/1.1 Connector創建的Socket隊列中，隊列的長度由acceptCount屬性定義，當等待隊列也被占用滿了，新來的用戶請求將會收到connection refused錯誤。

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

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

Http/1.1 Connector提供的配置項：

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