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

<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。