Tomcat 7 HTTP 连接器（三）

2 属性

2.1 公共属性

2.2 标准实现

2.3 Java TCP套接字的属性

除了上文列出的通用的连接器和HTTP属性，BIO和NIO实现还支持下面的JavaTCP套接字属性。

属性	描述
socket.rxBufSize	（int）套接字接收缓冲区（SO_RCVBUF）大小（以字节为单位）。如果没有设置，JVM默认值将被使用。
socket.txBufSize	（int）套接字发送缓冲区（SO_SNDBUF）大小（以字节为单位）。如果没有设置，JVM默认值将被使用。
socket.tcpNoDelay	（bool）相当于到标准属性 tcpNoDelay。
socket.soKeepAlive	（bool）套接字的长连接（SO_KEEPALIVE）设置。如果没有设置，JVM默认值将被使用。
socket.ooBInline	（bool）套接字的OOBINLINE设置。如果没有设置，JVM默认值将被使用。
socket.soReuseAddress	（bool）套接字复用地址选项（SO_REUSEADDR）。如果没有设置，JVM默认值将被使用。
socket.soLingerOn	（bool）套接字的延迟关闭选项（SO_LINGER）。标准属性connectionLinger值> = 0 的时候，相当于将此项设置为true。标准属性connectionLinger值<0 的时候，相当于将此项设置为false。此属性和soLingerTime都必须被设置，否则JVM的预设值将被使用。
socket.soLingerTime	（int）套接字延时关闭选项（SO_LINGER）秒数。这相当于标准属性connectionLinger。此属性和soLingerOn都必须被设置，否则JVM的预设值将被使用。
socket.soTimeout	相当于标准属性 的connectionTimeout。
socket.performanceConnectionTime	（int）性能设置的第一个值。 所有这三个性能属性必须设置否则所有三个属性的JVM预设值将被使用，可查看套接字性能选项。
socket.performanceLatency	（int）性能设置的第二个值。 所有这三个性能属性必须设置否则所有三个属性的JVM预设值将被使用，可查看套接字性能选项。
socket.performanceBandwidth	（int）性能设置的第三个值。 所有这三个性能属性必须设置否则所有三个属性的JVM预设值将被使用，可查看套接字性能选项。
socket.unlockTimeout	（int）套接字解锁的超时时间。当一个连接器停止时，它会通过打开一个连接到本身的连接器来尝试释放acceptor 线程。默认值是250(以毫秒为单位)

2.4 BIO的具体配置

下面是BIO连接器的特定属性。

属性	描述
disableKeepAlivePercentage	为提高可扩展性，在长连接失效之前被使用的处理线程的百分比。小于0的值将被设为0，大于100的值将被设为100。如果没有指定，默认值是75。

 

2.5 NIO的具体配置

下面是NIO连接器的特定属性。

属性	描述
pollerThreadCount	（int）用来处理轮询事件的线程的数量。在版本7.0.27及以前版本，默认值是每个处理器1个。版本7.0.28的默认值是每个处理器1个，但不超过2个。 当接受一个套接字，操作系统拥有全局的锁。所以超过2个线程的好处而迅速减小。有一个以上的线程是因为系统需要非常迅速地接受连接。但通常只要增加acceptCount值就可以解决这个问题。增加该值也可能是有用的，当大量发送文件操作发生的时候。
pollerThreadPriority	（int）轮询线程的优先级。默认值是5（java.lang.Thread.NORM_PRIORITY常量值）。优先级的更多详细信息，可以查考java.lang.Thread类的JavaDoc 。
selectorTimeout	（int）选择轮询器select（）的超时时间（以毫秒为单位）。这个值非常重要，因为连接清理工作也是在同一个线程里的，所以不要将此值设置为一个非常高的。默认值是1000毫秒。
useComet	（bool）是否允许Comet servlet。默认值是 true。
useSendfile	（bool）使用此属性来启用或禁用sendfile的能力。默认值是true。
socket.directBuffer	（bool）选择使​​用直接ByteBuffers或Java映射的ByteBuffers。默认是false。 当您使用直接ByteBuffers，请确保你分配适当的内存量给直接内存空间。在Sun的JDK中，配置如-XX：MaxDirectMemorySize = 256M。
socket.appReadBufSize	（int）在Tomcat中每个连接的开辟连接一个读ByteBuffer。此属性控制这个缓冲区的大小。默认情况下，这个读缓冲区大小为8192字节。对于较低的并发，你可以增加这个值以缓冲更多的数据。对于长连接数很多的情况，你需要降低这个数值或者增加堆大小。
socket.appWriteBufSize	（int）在Tomcat中每个连接的开辟连接一个写ByteBuffer。此属性控制这个缓冲区的大小。默认情况下，这个写缓冲区大小为8192字节。对于较低的并发，你可以增加这个值以缓冲更多的响应数据。对于长连接数很多的情况，你需要降低这个数值或者增加堆大小。 这里的默认值是相当低的，如果面对的不是几万并发连接，你应该增大该值。
socket.bufferPool	（int）NIO连接器使用NioChannel这个类来持有链接到一个套接字的元素。为了减少垃圾收集，NIO连接器缓存这些通道的对象。此值指定这个缓存的大小。默认值是500，表示缓存将持有500个 NioChannel的对象。-1表示不限制缓存大小，0表示不缓存。
socket.bufferPoolSize	（int）NioChannel池，也可以是基于尺寸大小，而不是基于对象数的。该大小的计算如下： NioChannel的缓冲区大小=读取缓冲区大小+写入缓冲区大小 SecureNioChannel的缓冲区大小=应用程序读取缓冲区大小+应用程序写入缓冲区的大小+网络读取缓冲区大小+网络写入缓冲区的大小 值（以字节为单位），默认值1024 * 1024 * 100 （100MB）。
socket.processorCache	（int）以减少垃圾收集，Tomcat缓存SocketProcessor对象。该值指定保持在缓存中最多有多少个对象。默认值是500。-1表示不限制缓存大小，0表示不缓存。
socket.keyCache	（int）以减少垃圾收集，Tomcat缓存KeyAttachment对象。该值指定保持在缓存中最多有多少个对象。默认值是500。-1表示不限制缓存大小，0表示不缓存。
socket.eventCache	（int）以减少垃圾收集，Tomcat缓存PollerEvent对象。该值指定保持在缓存中最多有多少个对象。默认值是500。-1表示不限制缓存大小，0表示不缓存。
selectorPool.maxSelectors	（int）以减少选择器的争用，在池中使用的选择器最大个数。命令行org.apache.tomcat.util.net.NioSelectorShared值设置为false时，使用此选项。默认值是200。
selectorPool.maxSpareSelectors	（int）以减少选择器的争用，在池中使用的最大备用选择器个数。当选择器返回到池中时，系统可以决定保留它或者让他垃圾回收。当org.apache.tomcat.util.net.NioSelectorShared 值设置为false时，使用此选项。默认值是-1（无限制）。
命令行选项	下面的命令行选项可用于NIO连接器：-Dorg.apache.tomcat.util.net.NioSelectorShared=true|false  默认情况下是true。如果你想每个线程使用一个选择器，将此值设置为false。当你将它设置为false，你可以通过使用selectorPool.maxSelectors属性控制选择器池的大小。
oomParachute	（int）NIO连接器实现了一个名叫parachute的OutOfMemoryError错误的策略。它拥有一个块的数据作为一个字节数组。在一个OOM的情况下，这个数据块被释放，并报告错误。这会给VM足够的空间来清理。oomParachute代表parachute（字节数组）的大小（以字节为单位）。默认值是 1024 * 1024（1MB）。请注意，这仅适用于关于Java堆空间的OOM错误，也不是绝对保证，你将能够恢复所有。如果你有一个Java堆之外OOM的，那么这个parachute也无济于事。

2.6 APR /Native 的具体配置

下面是APR/Native 连接器的特定属性。

属性	描述
deferAccept	在连接器的监听套接字上设置TCP_DEFER_ACCEPT标志。当操作系统支持TCP_DEFER_ACCEPT时默认值是true，否则它是false。
pollerSize	在一个给定的时间内,负责长连接轮询的轮询器能够持有的线程数。额外的连接将被马上关闭。默认值是8192，与8192个长连接数一致。是maxConnections的一个代名词。
pollerThreadCount	用于轮询长连接的线程数。Windows系统默认选择，每个线程管理的套接字数小于1024。对于Linux的默认值是1。更改Windows下的默认值可能有负面的性能影响。
pollTime	轮询调用持续的时间（以微秒为单位）。在某些情况下，降低该值将略微减少潜在的连接数，但随着增加的轮询调用会使用更多的CPU。默认值是2000（毫秒）。
sendfileSize	在给定时间内，负责异步发送静态文件的轮询器可以持有的套接字数。额外的连接将被马上关闭，没有任何数据被发送（在客户端产生一个长度为零的文件）。请注意，在大多数情况下，的sendfile是一个立刻返回的调用（被内核照顾的“同步”），而且sendfile轮询器将不会被使用，所以可以同时发送的静态文件的数量大于指定的值。默认值是1024。
sendfileThreadCount	服务于sendfile套接字的线程数。由于Windows系统默认选择，每个线程管理的套接字小于1024。Linux系统的默认值是1。更改Windows系统下的默认值可能有负面的性能影响。
threadPriority	（int）接收器和轮询器线程的优先级。默认值是5（java.lang.Thread.NORM_PRIORITY常量值）。优先级的详细信息请查看java.lang.Thread类的JavaDoc 。
useComet	（bool）允许或禁止Comet servlet。默认值是 true。
useSendfile	（bool）使用此属性来启用或禁用sendfile的能力。默认值是true。