23.2.3 配置Jetty容器
下面这些Jetty环境属性的设置在你的web应用中执行,最常用的配置如下:
httpConnector
可选择的配置,如果没有设置,Jetty将创建ServerConnector实例来监听8080端口。你可以在命令行上使用系统属性jetty.http.port来
修改默认的端口配置,例如mvn -Djetty.http.port=9999 jetty:run,
当然你可以通过配置下面的属性来配置ServerConnector。可以配置的属性如下:
port:连接监听的端口,默认8080;
host:监听的主机,默认监听所有主机,即所有主机都可以访问;
name:连接器的名称,在配置指定连接器来处理指定请求时有用;
idleTimeout:连接超时时间;
soLinger:socket连接时间;
你同样可以在一个标准的Jetty xml配置文件中配置连接,并把配置文件的路径赋值给jettyXml参数。jetty-9.0以后已经不需要把连接信息配置在pom.xml中了;你可以使用Jetty的xml进行配置。
jettyXml
可选择的配置,通常,可以把以逗号分割的Jetty xml配置文件的地址字符串增加到任何插件的配置参数中。如果你有另一个web应用、处理器、特别是连接器,你就可以使用它,但是若你有另外一个Jetty对象,则不能通过插件得到配置信息。
scanIntervalSeconds
自动扫描文件改变并进行热部署的时间间隔,单位为秒。默认值为0,这代表着禁用扫描并热部署,只有一个大于0的配置可以使它生效。
reload
重新加载选项,默认值是"automatic"(自动),一般用来和配置不为0的scanIntervalSeconds一同使用。默认配置下当发现有文件改变会自动进行热部署。如果设置为"manual" (手动),这样设置的话,部署将会通过插件被手动触发,这在当你频繁改动文件时比较有用,这样会忽略你的改动,直到你做完所有改变。
dumpOnStart
可选择的配置,默认为false,如果设置为true。那么Jetty会在启动时打印出server的结构。
loginServices
可选择的配置。是一系列org.eclipse.jetty.security.LoginService的实现类。注意,没有指定默认的域,如果你需要在web.xml中配置域,那么就可以配置一个统一的域。当然也可以在Jetty的xml里面进行配置。并把配置文件的地址增加到`jettyXml中。`
requestLog
可选择的配置。一个实现了org.eclipse.jetty.server.RequestLog接口的请求日志记录。有三种方式配置请求日志:
- 在Jetty xml配置文件,并加到jettyXML参数中。
- 在context xml配置文件中,并加到contextXml参数中。
- 在webAPP元素中
server
jetty-9.3.1以后是可选择配置。这可以配置org.eclipse.jetty.server.Server 实例用来支持插件的使用,然而通常是不需要配置的,因为插件会自动为你配置。特别是你在使用jettyXml的时候你通常不愿意使用这个元素。如果你同时定义了server元素和在xml文件中进行了包含“
stopPort
可选择配置。一个用来监听停止命令的端口。
stopKey
可选择的配置。和stopPort结合使用。
systemProperties
可选择的配置。允许你为了执行插件而配置系统参数。
systemPropertiesFile
可选择的配置。一个包含执行插件系统参数的文件。默认情况你在文件中设置的参数不会覆盖在命令行中写的参数,不管通过JVM还是通过POM的systemProperties。
skip
默认为false。如果为true的话,插件的执行会退出。同样可以使用命令-Djetty.skip
进行设置。这在一体化测试你可以通过配置取消执行时非常有用。
useProvidedScope
默认为false。如果为true的话,
excludedGoals
可选择的配置。一系列Jetty插件的名称可以使插件打印出有效的信息并退出。这在你想禁止用户使用指定功能的时候很有用。
23.2.3.1 配置https连接器
为了配置https连接器,你需要使用Jetty xml配置文件。下面的例子是直接拷贝 etc/文件夹下的文件,当然你也可以自己编写你自己xml文件。我们将使用下面的文件:
jetty.xml
设置 org.eclipse.jetty.server.Server 实例的各种属性,为了让插件可以使用。重点提示,下面设置了org.eclipse.jetty.server.HttpConfiguration元素,我们也可以使用一个字xml文件来配置它。这是一个相关的部分:
jetty-ssl.xml
为https连接配置ssl。下面一个jetty-ssl.xml
例子来自jetty-distribution:
<Set name="host"><Property name="jetty.ssl.host" deprecated="jetty.host" /></Set>
<Set name="port"><Property name="jetty.ssl.port" deprecated="ssl.port" default="8443" /></Set>
<Set name="idleTimeout"><Property name="jetty.ssl.idleTimeout" deprecated="ssl.timeout" default="30000"/></Set>
<Set name="soLingerTime"><Property name="jetty.ssl.soLingerTime" deprecated="ssl.soLingerTime" default="-1"/></Set>
<Set name="acceptorPriorityDelta"><Property name="jetty.ssl.acceptorPriorityDelta" deprecated="ssl.acceptorPriorityDelta" default="0"/></Set>
<Set name="acceptQueueSize"><Property name="jetty.ssl.acceptQueueSize" deprecated="ssl.acceptQueueSize" default="0"/></Set>
</New>
</Arg>
现在你需要让插件来应用上面的这个文件:
!警告
对于Jetty的安装来说,xml配置文件的顺序是很重要的。
你也可以使用jetty xml文件来配置http连接供插件使用。在这我们使用Jetty程序包中的jetty-http.xml文件:
现在讲这个文件添加到文件列表中:
当然也可以使用httpConnector元素来配置同上面的例子一样。
23.2.4 配置你的WebApp
这些配置参数应用到你的webapp中。它们可以实现所有的要求。
webApp
这是一个继承了org.eclipse.jetty.webapp.WebAppContext的org.eclipse.jetty.maven.plugin.JettyWebAppContext实例。你可以使用这个对象上所有的方法来配置你的webapp。下面几个是最常用的:
contextPath
你web应用的根路径。默认设置为“/”,如果你可以设置一个路径在“/”下面,例如/mycontext
descriptor
当前web应用的web.xml路径
defaultsDescriptor
webdefault.xml的路径,会在web.xml之前应用这个文件内容。如果你不指定一个,那么Jetty会使用一个在jetty-webapp.jar里面的webdefault.xml。
overrideDescriptor
当Jetty读取web.xml后要覆盖的配置文件。你可以用这个文件来覆盖或者增加配置。
tempDirectory
在web应用运行时,Jetty用来扩展或者拷贝jar文件和JSP编译后类的文件夹路径,默认路径是${project.build.outputDirectory}/tmp
baseResource
Jetty静态资源的根目录,默认为src/main/webapp
resourceBases
用来替代baseResource,如果你有多个静态目录。这是一个地址名字的数组。
baseAppFirst
默认为true。控制是否要在web应用的原始资源加载前或者加载后覆盖war包。
containerIncludeJarPattern
默认为".**/javax.servlet-[^/]\.jar$|./servlet-api-[^/]**\.jar$|.**javax.servlet.jsp.jstl-[^/]**\.jar|.**taglibs-standard-impl-.**\.jar"。这是一个匹配规则,用来匹配容器classpath(注意:是容器的classpath不是web应用的classpath)里jar包的名字中应该被扫描的fragments,tlds和annotations 。这和context中org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern 属性比较相似。用户也可以定义额外的需要被扫描的jar包。
contextXml
应用到web应用的context的xml的路径,在元素webApp
以后。