Tomcat中的Connector配置

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

Xml代码

1.<Server>  
2.   <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />  
3.   <Listener className="org.apache.catalina.core.JasperListener" />  
4.   <Service name="jboss.web">  
5.      <Connector protocol="HTTP/1.1" port="8080" address="${jboss.bind.address}"    
6.               connectionTimeout="20000" redirectPort="8443" compression="on"    
7.               compressionMinSize="1" compressableMimeType="text/html,text/xml" />  
8.      <Engine name="jboss.web" defaultHost="localhost">  
9.         <Realm className="org.jboss.web.tomcat.security.JBossWebRealm"  
10.            certificatePrincipal="org.jboss.security.auth.certs.SubjectDNMapping"  
11.            allRolesMode="authOnly"  
12.            />  
13.         <Host name="localhost">    
14.            <Valve className="org.jboss.web.tomcat.service.jca.CachedConnectionValve"  
15.            cachedConnectionManagerObjectName="jboss.jca:service=CachedConnectionManager"  
16.            transactionManagerObjectName="jboss:service=TransactionManager" />  
17.         </Host>  
18.      </Engine>  
19.   </Service>  
20.</Server>  
<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错误。

[b]所有的Connector提供的配置项（不完全版scheme, isSecure, xpoweredBy, useIPVHosts ）：[/b]
[color=blue]• allowTrace[/color]
如果需要服务器能够处理用户的HAED/TRACE请求，这个值应该设置为true，默认值是false;

[color=blue]• emptySessionPath[/color]
如果设置为true，所有session,cookie的path将会被设置为/，这种设置通常是在portlet中比较有用，默认值是false；

[color=blue]• enableLookups[/color]
如果需要在调用request.getRemoteHost()方法时获取到客户端的机器名，则需要配置为true,如果配置为false，将会跳过DNS查询直接返回客户端机器的IP地址，通常为了提高性能，将此值设置为false，默认值是true;

[color=blue]• maxPostSize[/color]
POST方法能够提交的数据的最大大小，如果没有声明或者设置为小于等于0，则表示POST提交的数据大小是不限制的，默认值是2Megabytes.

[color=blue]• protocol[/color]
设置处理请求的协议，默认是HTTP/1.1，即org.apache.coyote.http11.Http11Protocol，此外还支持的协议有：org.apache.coyote.http11.Http11NioProtocol（通过NIO处理用户请求，可以提高系统性能）， org.apache.coyote.http11.HttpAprProtocol。

[color=blue]• proxyName/proxyPort[/color]
如果Web服务器使用了代理服务器，配置此参数意味着在调用request.getServerName的时候将会获取代理服务器的名称，getServerPort()将会返回proxyPort。

[color=blue]• redirectPort[/color]
如果Connector的配置是支持非SSL的请求，当一个SSL请求到来时，服务器会自动的将请求重定位到redirectPort。

[color=blue]• URIEncoding[/color]
URI字节转化成String的时候的编码方式，默认为ISO-8859-1，如果页面需要支持中文，一般可以将其设置为UTF-8或者GBK,GB2312。

[color=blue]• useBodyEncodingForURI[/color]
如果设置为true,则会根据页面的编码决定URI的编码方式，默认是false。

[b]Http/1.1 Connector提供的配置项：[/b]
[color=blue]• acceptCount[/color]
等待队列的长度，默认值是100。

[color=blue]• address[/color]
如果Tomcat所在的主机有多个IP，这个值声明了用于监听HTTP请求的IP地址。

[color=blue]• bufferSize[/color]
Connector创建的输入流的大小，默认值是2048 bytes，提高这个值可以提升性能，增加内存消耗。

[color=blue]• compressableMimeType[/color]
使用HTTP压缩的MIME类型，使用逗号分割，默认值是 text/html,text/xml,text/plain。

[color=blue]• compression[/color]
为了节省带宽，可以将这个值设置为on，从而启用HTTP/1.1 GZIP压缩。off关闭压缩，forces强制使用压缩，默认值是off。

[color=blue]• connectionTimeout[/color]
Connector接受一个连接后等待的时间(milliseconds)，默认值是60000。

[color=blue]• executor[/color]
在Service节点下，Connector节点前可以配置一个Executor节点用于管理线程，这个属性的值是配置的Executor的名称，如果应用了此属性且executor存在，那么任何其他的关于thread的配置将会被忽略。

[color=blue]• keepAliveTimeout[/color]
在Connector关闭连接前，Connector为另外一个请求Keep Alive所等待的微妙数，默认值和 connectionTimeout一样。

[color=blue]• maxHttpHeaderSize[/color]
HTTP请求、响应头信息的最大大小，默认是8192bytes。

[color=blue]• maxKeepAliveRequests[/color]
HTTP/1.0 Keep Alive 和HTTP/1.1 Keep Alive / Pipeline的最大请求数目，如果设置为1，将会禁用掉Keep Alive和Pipeline，如果设置为小于0的数，Keep Alive的最大请求数将没有限制。默认为100。

[color=blue]• maxThreads [/color]
用于处理用户请求的最大线程数，默认值是20。

[color=blue]• noCompressionUserAgents: [/color]
设置不使用HTTP GZIP压缩的客户端，使用逗号分隔，在某些浏览器不支持压缩的时候可以使用此属性。

[color=blue]• port [/color]
Connector监听的端口。

[color=blue]• restrictedUserAgents[/color]
设置不使用Keep Alive的客户端代理名称，使用逗号分割，默认值是空字符串。

[color=blue]• server [/color]
覆盖HTTP响应的serve头信息，如果不设置的话，默认值是 Apache-Coyote/1.1。一般情况下不需要关注此属性。

[color=blue]• socketBuffer [/color]
Socket输出流缓冲区的大小，默认是9000bytes,如果设置为小于0的值，则表示不使用此缓冲区。

[color=blue]• tcpNoDelay [/color]
默认值是true，设置为true可以提高系统性能。

[color=blue]• threadPriority[/color]
请求处理线程的优先级，默认的优先级是NORMAL。