0摘要
本文尝试翻译Tomcat官方文档Apache Tomcat 7连接器相关信息。
1 介绍
HTTP 连接器元素代表了支持HTTP/1.1协议的连接器组件,使Catalina成为一个能够执行servlet和JSP页面的独立的Web服务器。一个HTTP 连接器组件的实例监听服务器上一个特定的TCP端口号上的连接。一个或多个这样的连接器可以配置成一个单一Service的一部分,每个转发到相关联的Engine 处理请求,并创建响应。
如果你要配置的连接器,用于连接到Web服务器使用的的AJP协议(如 mod_jk的1.2.x的
连接器适用于Apache 1.3),请参阅 AJPConnector文档。
每个进入的请求需要一个线程处理。如果接收到比当前可用的请求处理线程可以处理更多的并发请求,将创建额外的线程直到达到所配置的最大线程数(maxThreads
值)。如果有超过处理能力的更多的请求到来,它们将被堆积在连接器创建的服务器套接字内,直到达到配置中acceptCount
的最大值。任何更多的同步请求将收到“连接被拒绝”的错误,直到有空闲线程来处理它们。
2 属性
2.1 公共属性
所有的连接器实现 支持以下属性:
属性 | 描述 |
| 一个布尔值,它可以用来启用或禁用跟踪HTTP方法。如果没有指定,该属性设置为false。 |
| 默认超时时间以毫秒为单位的异步请求。如果没有指定,该属性被设置为10000(10秒)。 |
| 如果你想 |
| 容器允许的请求头字段的最大数目。请求中包含比指定的限制更多的头字段将被拒绝。值小于0表示没有限制。如果没有指定,默认设置为100。 |
| 将被容器自动解析的最大数量的参数和值对(GET加上POST)。参数值对超出此限制将被忽略。值小于0表示没有限制。如果没有指定,默认为10000。请注意, |
| 将被容器以FORM URL参数形式处理的最大长度(以字节为单位)的POST。通过设置此属性的值小于或等于0可以禁用该限制。如果没有指定,该属性被设置为2097152(2兆字节)。 |
| 将被容器在FORM或CLIENT-CERT认证中保存/缓冲的POST的最大尺寸(以字节为单位)。对于这两种类型的身份验证,在用户身份验证之前,POST将被保存/缓冲。对于POST CLIENT-CERT认证,处理该请求的SSL握手和缓冲清空期间,POST将被缓存。对于Form认证,POST将被保存,同时用户将被重定向到登陆表单。POST将被一直保留直到用户成功认证或者认证请求关联的会话超时。将此属性设置为-1可以禁用此限制。将此属性设置为0,POST数据在身份验证过程中将不被保存。如果没有指定,该属性设置为4096(4千字节)。 |
| 以逗号分隔的HTTP方法列表,通过方法列表,等同于POST方法,request 正文将被解析成请求参数。这在RESTful应用程序要支持以POST式的语义解析PUT请求中是非常有用的。需要注意的是设置其他值(不是 |
| TCP端口号,连接器利用该端口号将创建一个服务器套接字,并等待传入的连接。你的操作系统将只允许一个服务器应用程序在一个特定的IP地址侦听特定的端口号。如果使用特殊值0(零),则Tomcat将为连接器随机选择一个空闲的端口。这是通常只用在嵌入式和测试应用程序。 |
protocol | 设置协议来处理传入流量。默认值是
也可以使用的用户自定义的实现。看一看在我们的连接器比较图。Java连接器,HTTP和HTTPS,配置是相同的。 APR连接器和APR特定的SSL设置的更多信息,请访问APR文档 |
| 如果这个连接正在使用的代理服务器配置,配置该属性指定的服务器的名称,可以调用 |
| 如果这个连接正在使用的代理服务器配置,配置该属性指定服务器端口,可以调用 |
| 如果该连接器支持非SSL请求,并且接收到的请求为满足 |
scheme | 将该属性设置为你想调用 |
secure | 如果你想调用 |
| 这将指定使用的字符编码,来解码URI字符。如果没有指定,ISO-8859-1将被使用。 |
| 这指定是否应该用于URI查询参数,而不是使用URIEncoding contentType中指定的编码。此设置兼容性Tomcat 4.1.x版(该版在contentType中指定编码,或者使用request.setCharacterEncoding的方法显式设置(参数为URL传来的值)。默认值false。 |
| 将该属性设置为 |
| 将此属性设置为 |