tomcat

配置综述

对tomcat服务器的配置，主要是指tomcat主目录下面conf文件夹下对各个配置文件的配置，包括用户权限访问控制，安全配置，集群配置，与HTTP服务器进行集成（Apache服务器，Nginx服务器等），JNDI资源的设置与访问等。以下是我个人学习tomcat.apache.org官网的一些笔记，或者是翻译。
配置文件可以描述为以下几种主要的目录：
1. Server：顶层元素由一组Connector和一个Engine组成
2. Connectors：外部客户端发送请求到特定Service的中间接口
3. Containers：处理接受的请求并产生对应通信请求的部件，Engine为Service处理所有请求，Host处理请求到特定虚拟Host的请求，Context处理特定的webApplication工程。
4. Nested Component：可以内嵌到Container容器中的元素，有些元素可以内嵌到所有的Container容易，有些只能内嵌到Context中

Server

< Server >server.xml的顶层元素，由xml文件定义可以知道，server元素有且必须为一个，他的属性如下所示
1. className：须实现org.apache.catalina.Server接口，不写为默认
2. address：tomcat使用的ip地址，默认为localhost
3. port：设置为-1表示不允许使用bin目录下的关闭脚本，不推荐配置-1
4. shutdown：通过tcp/ip发送关闭的命令

Service

< Service >元素代表了一到多个Connectors共享一个Engine处理接受到的请求，Service必须内嵌到Server中，可以有多个
1. className：必须实现org.apache.catalina.Service接口，可默认不写
2. name：Service的名字，如果我们使用标准的Service会在log目录看到日志，且Service的名字必须是唯一的

Executor

Executor：代表的是可以在部件中共享使用的线程池，必须实现org.apache.catalina.Executor接口，所有的Executor都支持一下两种属性
1. className：需实现特定接口，如果实现了LifeCycle接口，可以被容器开启和关闭，默认的实现为org.apache.catalina.core.StandardThreadExecutor
2. name：代表该线程池的名字，其他部件可以通过name引用该线程池
org.apache.catalina.core.StandardThreadExecutor默认实现的属性如下所示：
1. threadPriority：优先级，默认为5，等价于Thread.NORM_PRIORITY常量
2. daemon：守护线程
3. namePrefix：线程前缀名
4. maxThreads：最大活跃线程数，默认为200
5. minSpareThreads：最小活跃线程数，默认为25
6. maxIdleTime：空闲线程经过maxIdleTime毫秒后销毁，默认为60000毫秒（1分钟）
7. maxQueueSize：等待被执行的最大任务数量，默认为Integer.MAX_VALUE
8. prestartminSpareThreads：是否立即生成minSpareThreads线程数，默认为false
9. threadRenewalDelay：

HTTP Connectors

HTTPConectors支持HTTP协议，一个HTTPConector在指定的tcp端口上监听请求，与之关联的Engine的负责请求的处理并产生相应的响应，一个Service可以支持多种Conector。

所有标准的Connector支持如下的属性：

1. allowTrace：是否可以追踪HTTP请求，默认为false
2. asyncTimeout： 异步请求超时时间设置，默认为10000毫秒
3. enableLookups：调用request.getRemoteHost()进行域名转换需设置为true，默认为false，直接返回ip
4. maxHeaderCount：最大header数量，小于0为没有限制，默认为10
5. maxParameterCount：get和post请求最多参数数量，默认为10000，小于0没有限制
6. maxPostSize：小于0没有限制，默认为2Mb
7. maxSavePostSize：表单验证或者证书验证时缓存的post数据最大值，-1位不限制大小，0在证书验证中不保存数据，默认为4096Kb
8. parseBodyMethods：默认为post
9. port： connector监听接受请求的端口号，0位随机选择
10. protocol：通信协议，默认为HTTP/1.1，自动选择BIO或者是APR/native方式，如果OS的path上存在APR的library，首先使用apr，不同通信方式为
    BIO：org.apache.coyote.http11.Http11Protocol
    NIO：org.apache.coyote.http11.Http11NioProtocol
    APR：org.apache.coyote.http11.Http11AprProtocol
    
    1. proxyName：代理服务器名字
    2. proxyPort：代理拂服务器端口
    3. redirectPort：如果本Connector不支持ssl请求，如果某个request符合< security-constraint >走https通道，Catalina将该请求重定向到redirectPort端口
    4. scheme：默认为http，ssl为https
    5. secure：默认为false，request.isSecure()返回值
    6. URIEncoding：默认为ISO-8859-1
    7. useBodyEncodingForURI：默认为false
    8. useIPVHosts：默认为false
    9. xpoweredBy：默认为false

BIO，NIO以及APR都支持的属性

1. acceptCount：最大接受request数，默认为100，超过此数目后新连接将被拒接
2. acceptorThreadCount：接受简历连接的线程数量，默认为1，对于非持久链接，可以增大
3. acceptorThreadPriority：acceptor线程的优先级，默认为5等价于Thread.NORM_PRIORITY
4. address：默认将会使用该server的所有服务器
5. allowedTrailerHeaders：
6. bindOnInit：默认为true
7. compressableMimeType：默认为text/html,text/xml,text/plain,text/css
8. compression：Connector可以使用HTTP/1.1GZIP压缩技术去节省服务器的流量，这个的可能取值是on允许压缩文本数据，off不允许压缩，force压缩所有情景，或者取值一个整数作为是否压缩的阈值，默认为off
9. compressionMinSize：压缩阈值，默认为2048
10. connectionLinger：被Connector使用的socket在关闭后将会停留多少秒，默认为-1，表示不允许socket逗留
11. connectionTimeout： Connector在建立连接后等待请求到达的超时阈值，-1表示不存在超时连接，默认为60000毫秒，需注意，在标准的server.xml中的设置为20000毫秒；除非disableuploadtimeout设置为false，这个时间也将被用于读取请求报文时
12. connectionUploadTimeout：仅当disableuploadtimeout设置为false才生效，单位为毫秒
13. disableUploadTimeout：默认为false，表示不允许更长的超时
14. executor：引用Executor元素的名字，如果该executor存在，配置的线程相关属性将无效，如果不存在，使用一个内部线程池
15. executorTerminationTimeoutMillis：内部线程池在Connector处理请求钱等待时间，默认BIO为0，NIO和APR为5000毫秒
16. keepAliveTimeout：默认使用connectionTimeOut属性，表示connector在处理完一个http请求了等待多少毫秒就会关闭连接
17. maxConnections：服务器在任何时刻可以接收并处理的连接数，连接数达到时，服务器可以继续建立连接，但是并不处理。需注意，一旦达到maxConnections数量，服务器依旧可以接收连接达到acceptCount，maxConnection根据Connector的不同而不同，BIO连接数为maxThread线程数，NIO为1000，APR/native为8192。如果值为-1，表示不计算不启用连接数限制
18. maxExtensionSize：限制httpRequest的报文长度，默认为8192，值为-1表示没有限制
19. maxHttpHeaderSize：报文头长度，默认为8192kb
20. maxKeepAliveRequests：保持长连接的http请求，设置为1表示不启用长连接，-1表示为无限制，默认为100
21. maxSwallowSize：最大可上传的报文数大小，默认为2097152 kb，负数表示不限制
22. maxThreads：该Connector的线程数量，默认为200
23. maxTrailerSize：-1为不限制，默认为8291kb
24. minSpareThreads：默认为10，最小在运行线程
25. noCompressionUserAgents：符合该正则表达式的连接将不使用压缩
26. processorCache：可以被缓存的对象的数量，-1表示不限制，默认为200，低于Servlet3.0版本，使其等于maxThreads的属性，如果为Servlet3.0或更高，可以大于maxThread
27. restrictedUserAgents：符合该正则表达式的将不能使用keepalive保持长连接
28. server：响应报文头的server属性，默认为Apache-Coyote/1.1
29. socketBuffer：socket输出缓冲区，-1不启用缓冲区，默认为9000byte
30. SSLEnabled：默认为false，启用ssl协议
31. tcpNoDelay：默认为true
32. threadPriority：默认为java.lang.Thread.NORM_PRIORITY，对应jdk中线程的优先级
33. upgradeAsyncWriteBufferSize：异步写缓冲区大小，单位为byte，默认为8192

Java Tcp Socket属性

以下属性BIO跟NIO都有的Socket属性（默认为jdk原始值）
1. socket.rxBufSize：接受缓冲区大小(int)
2. socket.txBufSize：发送缓冲区大小(int)
3. socket.tcpNoDelay：等价于tcpNoDelay(boolean)
4. socket.soKeepAlive：持久连接(boolean)
5. socket.ooBInline：紧急发送(boolean)
6. socket.soReuseAddress：重用地址(boolean)
7. socket.soLingerOn：(boolean)
8. socket.soTimeout：等价于connectionTime
9. socket.performanceConnectionTime：(int)
10. socket.performanceLatency：
11. socket.performanceBandwidth：
12. socket.unlockTimeout：处理完完成后释放连接间隔，单位毫秒，默认为250

BIO特有属性

1. disableKeepAlivePercentage：不允许保持持久连接的百分比，默认为75，取值为0~100

NIO特有属性

1. pollerThreadCount：pool事件的处理线程数量，默认为1
2. pollerThreadPriority：默认为5，对应于java.lang.Thread.NORM_PRIORITY
3. selectorTimeout：默认为1000毫秒，不要设置过大
4. useComet：默认为true
5. useSendfile：默认为true
6. socket.directBuffer：默认为false，是否使用java的ByteBuffers，在Sun’sJDK中需要在tomcat启动脚本中加入-XX:MaxDirectMemorySize=256m.
7. socket.appWriteBufSize：tomcat中关联writeByteBuffer，默认为8192，并发连接数如果不高，可以适当提高该属性值
8. socket.bufferPool：NIO使用NioChannel 类缓存socket，默认为500，-1表示没有限制，0表示不缓存任何socket
9. socket.processorCache：默认为500，-1表示无限制，0不缓存
10. socket.keyCache：默认为500，-1表示无限制，0不缓存
11. socket.eventCache：默认为500，-1表示无限制，0不缓存
12. selectorPool.maxSelectors：减少对selector的争夺，默认为200，org.apache.tomcat.util.net.NioSelectorShared属性设置为false时将会启用该属性
13. selectorPool.maxSpareSelectors：减少selector争夺，默认为-1表示没有上限，当org.apache.tomcat.util.net.NioSelectorShared设置为false时启用该属性
14. command-line-options：该-Dorg.apache.tomcat.util.net.NioSelectorShared=true|false对于NIO connector是有效的，默认为true，设置为false表示为每个线程拥有一个selector
15. oomParachute：