分享

http连接配置说明

 hh3755 2012-01-09
 HTTP connector使用sendfile处理大的静态文件(所有这些大文件都使用高性能的内核级调用通过异步方式发送),使用socket poller实现keepalive,提升服务器的扩展性。下面列出HTTP connector支持的属性: 

  acceptCount 

  当所有请求处理线程都被占用时,允许接收连接请求队列的最大长度。当队列已满时,任何收到的请求都将被拒绝。缺省值为 10. 

  address 

  对于有多个IP地址的服务器,该属性设置使用哪个地址监听指定的端口。缺省情况下,设置的端口用于绑定服务器的所有IP地址。 

  allowTrace 

  该布尔值用于启用或禁用HTTP协议的TRACE 方法。如果不设置,该属性值为false. 

  bufferSize 

  提供给连接器创建输入流所需的缓冲区大小(以字节计算)。缺省情况下,提供的缓冲区大小是2048 字节。 

  compressableMimeType 

  该属性值是采用HTTP压缩的、逗号隔开的MIME 类型列表。缺省值为 text/html,text/xml,text/plain. 

  compression 

  Connector可以使用HTTP/1.1 GZIP 压缩节省服务器带宽。该参数可以接受的值为"off" (禁用压缩), "on" (开启压缩, 但只压缩文本数据), "force" (强制压缩所有类型), 或者整数值(等价"on", 但是当输出的数据量超过指定的最小值时才压缩). 如果content-length 未知,并且compression 设为"on" 或者更强的值, 输出也将被压缩. 如果不设置, 该值为"off". 

  connectionLinger 

  当Connector使用的socket被关闭后,保留socket的时间,以毫秒计算. 缺省值为-1 (禁用socket linger). 

  connectionTimeout 

  Connector接收连接后,等待提供请求URI 的时间. 缺省值为60000 (等于 60 秒). 

  disableUploadTimeout 

  该标志位表明当执行servlet时,是否允许servlet容器使用一个不同的、更长的连接超时。启用该标志位将导致在上传数据时,要么使用更长的时间完成上传,要么出现更长的超时。如果不指定,该属性为"false"。 

  emptySessionPath 

  如果设为true,所有path的session cookie将设为/。这对portlet规范的实现非常有用,但是在服务器需要同时提供多个被访问的应用时,会对性能造成很大的影响。如果没有设置,该值为false。 

  enableLookups 

  该值为true时,调用request.getRemoteHost()将执行DNS查询返回远程客户端的实际主机名。该值为false,将略过DNS查询直接以字符串格式返回IP地址(因而能够提升性能)。缺省情况下,启用DNS查询。 

  firstReadTimeout 

  该属性值用于设置第一次读取request数据的超时时间。如果没有可读取的数据,socket将会被放入poller。该属性值设为0,将会提高扩展性,但是会对等待时间造成轻微的影响(查看相关的属性pollTime)。缺省值为100(100ms)。注意:在Windows系统中,firstReadTimeout的实际值为500 + 设置值。 

  maxHttpHeaderSize 

  Request和response的 HTTP header的最大长度,以字节计算。如果不设置,该属性为4096(4k) 

  maxKeepAliveRequests 

  在服务器关闭连接之前,能够pipelined的HTTP请求数量的最大值。该属性设置为1时将为禁用HTTP/1.0 keep-alive以及HTTP/1.1的 keep-alive和pipeline。该属性设置为-1时,将不会限制pipelined 或者 keep-alive请求的数量。如果不设置,该属性为100。 

  maxPostSize 

  容器在Form URL参数解析过程中能够处理的POST最大长度,以字节计算。该属性设置为小于或等于0,限制取消。如果不设置,该属性为2097152(2兆) 

  maxSavePostSize 

  在FORM或CLIENT-CERT认证期间,容器能够保存/缓存POST数据的最大长度。这两种认证方式在用户认证之前会保存或缓存POST数据。对于CLIENT-CERT认证,在SSL握手期间POST数据将被缓存,请求处理后缓存数据将被清空。对于FORM认证,当用户被重定向到login form时,POST数据被保存。该数据一直保存到用户成功认证,或者认证请求关联的session失效。该属性为-1时,限制取消。该属性设为0,在认证期间将不保存POST数据。如果不设置,该属性值为4096(4k) 

  maxThreads 

  Connector创建的请求处理线程的最大值,它决定了能够同时处理并发请求的最大值。如果不指定,该属性值为200。 

  noCompressionUserAgents 

  逗号分割的正则表达式列表,用于匹配那些不需要使用压缩的HTTP客户端的user-agent。因为这些客户端,尽管声称支持压缩特性,但是没有完整实现。缺省值为空字符串(禁用正则表达式匹配) 

  pollTime 

  Poll call间隔。降低该属性值将会轻微地减少连接保持存活的等待时间,但是更多的poll call,将会更多地占用CPU,缺省值为500(5ms) 

  pollerSize 

  负责轮询存活连接的poller在一给定时间内保持的socket数量。多的连接将立即被关闭。缺省值为768,对应768个存活的连接 

  port 

  该属性值设置Connector创建等待连接Socket的TCP端口号。操作系统仅允许一个服务器应用监听IP地址的一个端口。 

  protocol 

  缺省情况下,为了使用HTTP handler,该属性值必须为HTTP/1.1。 

  proxyName 

  当Connector用于代理配置环境,该属性值为调用request.getServerName()返回的服务器名。 

  proxyPort 

  当Connector用于代理配置环境,该属性值设为调用request.getServerPort()返回的服务器端口。 

  restrictedUserAgents 

  逗号分割的正则表达式列表,用于匹配那些即使支持也不需要使用HTTP/1.1 or HTTP/1.0存活特性的HTTP客户端user-agent。缺省值为空字符串(禁用正则表达式匹配) 

  scheme 

  该属性值为调用request.getScheme()返回的协议名称。例如,在SSL Connector中可以将该属性值设为https。缺省值为http。 

  secure 

  该属性为true时,对于Connector(假定为SSL Connector)接收的请求调用request.isSecure()将返回true。缺省值为false。 

  sendfileSize 

  在给定时间poller用于异步发送静态文件所需保持的socket数量。多的连接在没有发送任何数据的情况下立即被关闭(导致客户端收到一个0字节的文件)。注意在大多数情况下,sendfile调用会立即返回(好像kernel采用“同步”方式),不会使用sendfile poller,因此并发发送静态文件的数量要远大于该属性的指定值。该属性的缺省值为256。 

  server 

  设置用于http response的Server header。 

  tcpNoDelay 

  该值为true,服务器的socket将使用TCP_NO_DELAY选项,大部分情况下该选项可以提升性能。缺省值为true。 

  threadPriority 

  指定请求处理线程在JVM中的优先级,缺省值为java.lang.Thread#NORM_PRIORITY。关于该优先级更详细的说明,请参考java.lang.Thread 类的JavaDoc。 

  URIEncoding 

  设置用于URI解码的字符编码,如果不设置将使用ISO-8859-1 

  useBodyEncodingForURI 

  该标志表示是否使用contentType指定的编码代替URLEncoding作为URI查询参数的编码。该设置用于与Tomcat 4.1.x兼容,在Tomcat 4.1.x中,contentType指定的编码或者使用Request.setCharacterEncoding显式设置的编码也用于URL参数。缺省值为false。 

  useIPVHosts 

  该值为true时,JBoss Web使用request接收到的IP地址来确定将请求发送到哪个Host。缺省值为false。 

  useSendfile 

  使用内核级的sendfile来发送静态文件。缺省值为true。 

  xpoweredBy 

  该值为true时,JBoss Web将通过使用规范推荐的HTTP header发布支持Servlet规范的信息。缺省值为false

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多