https://blog.csdn.net/elinespace/article/details/72864550
2.2. Jetty配置方式
除了Jetty配置及部署(一)介绍的命令行参数、ini和XML(Jetty IoC)文件的默认配置方式外,Jetty也为我们提供了其它灵活的配置方案。
由于Jetty的服务器对象(如Server、链接器、Context等)都是POJO,因此从理论上讲,我们可以采用编程的方式配置Jetty,这便是嵌入式Jetty所完成的工作。不仅如此,我们还可以采用其它IoC框架配置Jetty服务器。例如官方即支持通过Spring容器进行配置及实例化Jetty服务器。只要启动模块中包含了spring(模块名),我们就可以直接使用Spring的Bean配置文件来替代Jetty IoC文件。在讲解Web应用部署时,你将会看到一个采用Spring进行部署配置的示例。
总之,Jetty对IoC框架集成的机制非常灵活,只要愿意,我们可以非常容易的实现自己的替代方案,具体实现方式可以参见“扩展篇”。
注意:与Tomcat相比,Jetty的可扩展性做的非常出色。除了它的模块化架构,各个组件的可扩展性也充分说明了这一点。这也是Jetty进行嵌入式开发如此便捷的原因,而Tomcat的服务器生命周期处理,有部分是与其Catalina容器配置解析耦合在一起的,因此如果要进行嵌入式开发,则需要做额外的适配工作。
2.3. Jetty配置方式
本节主要讲解Jetty相关的启动配置,包括加载规则和常见的启动参数。
2.3.1. 加载规则
从前面的讲解我们知道,Jetty有三种方式添加命令行启动参数:命令行添加、start.ini、start.d/*.ini(大多数情况下,start.ini和start.d不必两者都保留,只需要两者择其一即可)。对于这三种方式,如果存在重复的配置,Jetty将自行进行覆盖。其具体规则是命令行的优先级最高,start.d目录次之,start.ini文件最低。这也符合我们对配置灵活性的要求,保证最灵活的方式优先级最高。
2.3.2. 常见启动参数
下面我们整理了部分常用的Jetty启动参数及其用途说明,你可以根据需要采用任意一种方式配置使用,如表2-1所示。
注意:所有JVM相关的参数也可以直接通过ini文件设置,此处不再赘述。
表2-1 Jetty常见启动参数
参数 | 所属模块 | 说明 |
---|---|---|
jetty.http.host | http | HTTP链接器绑定的主机地址,默认本机所有有效IP地址。 |
jetty.http.port | http | HTTP链接器监听的端口号,默认为8080。 |
jetty.http.idleTimeout | http | HTTP链接的最大空闲时间,单位为毫秒,默认为30000。 |
jetty.http.soLingerTime | http | HTTP链接器Socket Linger时间,默认为-1,即禁用。 |
jetty.http.acceptors | http | HTTP链接器用于接收请求的线程数量,默认为-1,Jetty基于处理器核数选择一个值,具体规则是低于16核为1,低于24核为2,低于32核为3,32核以上为4。 |
jetty.http.selectors | http | Socket selector的数量,默认为-1,Jetty基于处理器核数选择一个值,具体规则是低于4核为1,低于8核为3,8核以上为4。 |
jetty.http.acceptorQueueSize | http | 用于设置ServerSocket绑定时的backlog值,输入连接指示(对连接的请求)的最大队列长度。如果队列满时收到连接指示,则拒绝该连接。 |
jetty.threadPool.minThreads | server | Jetty线程池最小线程数,默认为10。 |
jetty.threadPool.maxThreads | server | Jetty线程池最大线程数,默认为200。 |
jetty.threadPool.idleTimeout | server | Jetty线程池线程空闲超时时间,单位为毫秒,默认为60000。 |
jetty.httpConfig.secureScheme | server | HTTP安全重定向时,URI的Scheme,默认为https。 |
jetty.httpConfig.securePort | server | HTTP安全重定向端口,默认为8443。 |
jetty.httpConfig.outputBufferSize | server | HTTP响应内容缓冲大小,单位为字节,默认为32768。 |
jetty.httpConfig.outputAggregationSize | server | 可以缓冲的响应内容最大写入长度,单位为字节,默认为8192。 |
jetty.httpConfig.requestHeaderSize | server | HTTP请求头的最大值,单位为字节,默认为8192。 |
jetty.httpConfig.responseHeaderSize | server | HTTP响应头的最大值,单位为字节,默认为8192。 |
jetty.server.stopAtShutdown | server | 在控制台按下ctrl+c停止Jetty服务器。 |
jetty.server.stopTimeout | server | Jetty优雅停止的超时时间,单位为毫秒,默认5000。 |
jetty.server.dumpAfterStart | server | Jetty启动之后,输出服务器、组件以及Web应用的状态。 |
jetty.server.dumpBeforeStop | server | Jetty关闭之前,输出服务器、组件以及Web应用的状态。 |
jetty.ssl.host | ssl | TLS/SSL链接器绑定的主机地址,默认本机所有有效的IP地址。 |
jetty.ssl.port | ssl | TLS/SSL链接器监听的端口,默认为8443。 |
jetty.ssl.idleTimeout | ssl | TLS/SSL链接器空闲超时时间,单位为毫秒,默认30000。 |
jetty.ssl.soLingerTime | ssl | TLS/SSL链接器Socket Linger时间,默认为-1,即禁用。 |
jetty.ssl.acceptors | ssl | TLS/SSL链接器用于接收请求的线程数量。 |
jetty.ssl.selectors | ssl | TLS/SSL链接器Socket selector的数量。 |
jetty.ssl.acceptorQueueSize | ssl | 设置TLS/SSL链接器ServerSocket绑定时的backlog值 |
jetty.ssl.sniHostCheck | ssl | 是否检查请求主机名是否匹配SNI 名称。 |
jetty.ssl.stsMaxAgeSeconds | ssl | 设置Strict-Transport-Security 响应头的过期时间,单位为秒,默认为3153600。 |
jetty.sslContext.keyStorePath | ssl | 密钥库文件路径,相对于$JETTY_BASE。 |
jetty.sslContext.trustStorePath | ssl | 信任库文件路径,相对于$JETTY_BASE。 |
jetty.sslContext.keyStorePassword | ssl | 密钥库密码。 |
jetty.sslContext.keyStoreType | ssl | 密钥库类型(JCEKS、JKS、DKS、PKCS11、PKCS12)。 |
jetty.sslContext.keyStoreProvider | ssl | 密钥库提供者。 |
jetty.sslContext.keyManagerPassword | ssl | KeyManager密码。 |
jetty.sslContext.trustStorePassword | ssl | 信任库密码。 |
jetty.sslContext.trustStoreType | ssl | 信任库类型(JCEKS、JKS、DKS、PKCS11、PKCS12)。 |
jetty.sslContext.trustStoreProvider | ssl | 信任库提供者。 |
jetty.sslContext.needClientAuth | ssl | 是否要求客户端证书认证,如果为true并且客户端选择不提供自身的验证信息,则协商将会停止。 |
jetty.sslContext.wantClientAuth | ssl | 是否请求客户端证书认证,如果为true并且客户端选择不提供其自身的验证信息,则协商将会继续。 |
jetty.sslContext.sslSessionCacheSize | ssl | SSL会话缓存大小。 |
jetty.sslContext.sslSessionTimeout | ssl | SSL会话缓存超时时间,单位为秒。 |
jetty.gzip.minGzipSize | ssl | 指定一个HTTP响应内容长度的限制,当超过该值时,Jetty启动GZIP压缩。 |
jetty.gzip.compressionLevel | ssl | GZIP压缩级别。 |
jetty.gzip.excludedUserAgent | ssl | 正则表达式,用于指定禁用GZIP的User Agent。如果请求的User Agent匹配该表达式,则将不启用GZIP压缩。默认为.MSIE.6.0.,即IE6不支持GZIP压缩。 |
jetty.deploy.monitoredDir | deploy | Jetty部署模块监控目录,相对于$JETTY_BASE,用于热部署监控文件变更。 |
jetty.deploy.monitoredPath | deploy | Jetty部署模块监控路径(绝对目录),用于热部署监控文件变更。 |
jetty.deploy.defaultsDescriptorPath | deploy | Web应用使用的默认部署描述文件,该文件中的配置信息将会被所有Web应用继承,默认为/etc/webdefault.xml。 |
jetty.deploy.scanInterval | deploy | Jetty部署模块扫描监控目录的时间间隔,单位为秒,默认为1秒。 |
jetty.deploy.extractWars | deploy | 是否解压WAR包,默认为true。 |
jetty.jmxremote.rmihost | jmx-remote | JMX远程访问绑定的RMI主机地址。 |
jetty.jmxremote.rmiport | jmx-remote | JMX远程访问RMI监听的端口,默认为1999。 |
Jetty在启动时,会自动获取参数的键值对,并在加载各个模块时,将参数值以IoC的方式注入到各个组件对象。这是Jetty与Tomcat在参数处理方面的一大区别,Tomcat参数均以硬编码的方式进行读取,即便我们可以通过参数去控制Tomcat组件的行为,但是对于参数本身我们却无法控制。而Jetty则是在用IoC的方式构造组件对象时动态注入,因此方案更加灵活。我们完全可以通过更改IoC文件来增加、修改甚至删除相关参数,Tomcat则无法做到这一点。