配置Jetty Maven插件
Jetty Maven插件用于快速开发和测试。你可以将它添加到任何Maven Web项目。插件会定期扫描你项目的变化,并在检测到变化后自动重新部署应用。这种通过消除构建和部署步骤的方式使得开发周期更有效率：您使用IDE来编辑项目，运行中的jetty容器会自动编译它们，你可以立即进行测试。
快速开始：启动并运行
首先,添加 jetty-maven-plugin到pom.xml配置文件：
org.eclipse.jetty jetty-maven-plugin 9.3.1-SNAPSHOT
然后在项目根目录下运行命令：
mvn jetty:run
就可以启动jetty，你通过通过在http://localhost:8080访问你的web项目。
Jetty继续运行直到你停止它。当它运行时,它会周期性地扫描您的项目文件的更改，如果您保存更改并重编译类文件,Jetty重部署你的应用，你可以立即测试所做的更改。
你可以终止的插件
ctrl-c在终端窗口中运行。
支持的目标
Jetty Maven插件有许多不同的Maven目标。最有用的是
run目标，通过它可以快速启动你的web项目。还有其他的目标，可以帮助你完成不同的任务。例如，您可能需要运行你的应用在一个分叉的Jetty实例,而不是正在运行Maven进程；或者你可能需要更细粒度的控制Maven生命周期阶段，按您希望的那样部署你的web应用。有不同的目标来完成这些任务。查看所Maven插件的所有目标,你可以执行：
mvn jetty:help
查看特定目标更详细的参数列表，执行如下命令：
mvn jetty:help -Ddetail=true -Dgoal=goal-name
配置Jetty容器
这些配置元素用于设置jetty运行环境。他们被大部分目标共用：
httpConnector 可选的。如果没有指定，jetty将创建一个监听端口8080的ServerConnector实例。你可以使用命令行通过系统属性
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配置https连接器，你必须使用jetty配置文件。jettyXml 可选的。一个逗号分隔的列表的位置
jetty xml文件除了应用于任何插件配置参数。您可以使用它如果你有其他webapps,处理程序,特定类型的连接器等,部署,或者你有其他码头的对象不能从插件配置。scanIntervalSeconds 之间的停顿在几秒钟内扫描的webapp检查更改,如果检测到任何自动热部署。 在默认情况下这是0,禁用热部署扫描。使其数量大于0。
重新加载 默认值是“自动”,用于与一个非零
scanIntervalSeconds当检测到变化导致自动热部署。设置为“手动”而不是触发扫描输入换行符在控制台运行插件。这可能是有用的,当你在做一系列的变化,你想忽略,直到你做完了。在使用,使用reload参数。dumpOnStart 可选的。默认值是错误的。如果这是真的,那么码头将倾倒服务器结构开始。
loginServices 可选的。的列表
org.eclipse.jetty.security.LoginService实现。请注意,没有默认域。如果你用在你的领域web.xml你可以在这里指定相应的领域。你可以在jetty中配置登录服务的xml文件,并将它的位置添加到jettyXml参数。requestLog 可选的。的实现
org.eclipse.jetty.server.RequestLog请求日志界面。一个实现这方面的机子格式是可用的org.eclipse.jetty.server.NCSARequestLog。其他方法来配置RequestLog有三种:
在jetty xml配置文件,如中指定
jettyXml参数。在一个上下文xml配置文件,如中指定
contextXml参数。在
webApp元素。
See Configuring Request Logs for more information.服务器 自jetty-9.3.1可选。这将配置的一个实例
org.eclipse.jetty.server.Server插件的使用,但是它通常没有必要配置,插件会自动为你配置一个。特别是,如果你使用jettyXml元素,那么你一般不想定义这个元素,正如你可能使用jettyXml文件来配置一个服务器与一种特殊的构造函数参数,如自定义threadpool。如果您定义一个服务器元素,并使用一个jettyXml元素指向一个配置文件,一行像“<配置id =“服务器”class = " org.eclipse.jetty.server。服务器”>“xml配置会覆盖你在pom为服务器配置。stopPort 可选的。端口监听停止命令。有用的使用结合停止或run-forked的目标。
stopKey 可选的。结合stopPort用于阻止jetty。有用的结合使用时停止或run-forked目标。
systemProperties 可选的。允许您配置系统属性执行的插件。有关更多信息,请参见设置系统属性.
systemPropertiesFile 可选的。包含系统属性设置的文件执行的插件。默认情况下,设置在这里 不覆盖任何命令行上已经设置系统属性,由JVM,或者在POM通过
systemProperties。读设置系统属性如何强制覆盖。跳过 默认是假的。如果这是真的,这个插件的执行退出。设置SystemProperty一样
-Djetty.skip在命令行上。这是最有用的,当配置Jetty执行集成测试期间和你想跳过测试useProvidedScope 默认值是
false。如果这是真的,依赖项被放置在 容器类路径。请注意,这不是应用类路径,作为“提供”表明,这些依赖关系通常会将容器提供的。你应该很少需要使用这个。相反,你应该复制依赖提供显式的依赖关系provided plugin代替。excludedGoals 可选的。jetty插件的目标名单,将导致插件打印一条消息并退出。有用的,如果你想防止用户执行,你知道不能处理您的项目的目标。
配置一个Https连接器
为了配置https连接器,您需要使用jetty xml配置文件。这个示例使用文件直接从jetty分布等/目录复制,尽管你当然可以弥补自己的xml文件或文件。我们将使用以下文件:
jetty.xml 设置不同的特点
org.eclipse.jetty.server.Server实例的插件使用。重要的是,它的设置org.eclipse.jetty.server.HttpConfiguration元素,我们可以参考在随后的xml文件配置连接器。相关部门:
<Newid="httpConfig"class="org.eclipse.jetty.server.HttpConfiguration"><Setname="secureScheme">httpsSet><Setname="securePort"><Propertyname="jetty.secure.port"default="8443"/>Set><Setname="outputBufferSize">32768Set><Setname="requestHeaderSize">8192Set><Setname="responseHeaderSize">8192Set><Setname="sendServerVersion">trueSet><Setname="sendDateHeader">falseSet><Setname="headerCacheSize">512Set>New>jetty-ssl.xml 建立ssl将使用https连接器。这是
jetty-ssl.xml文件从jetty-distribution:
xmlversion="1.0"?><Configureid="Server"class="org.eclipse.jetty.server.Server"><Callname="addConnector"><Arg><Newid="sslConnector"class="org.eclipse.jetty.server.ServerConnector"><Argname="server"><Refrefid="Server"/>Arg><Argname="acceptors"type="int"><Propertyname="jetty.ssl.acceptors"deprecated="ssl.acceptors"default="-1"/>Arg><Argname="selectors"type="int"><Propertyname="jetty.ssl.selectors"deprecated="ssl.selectors"default="-1"/>Arg><Argname="factories"><Arraytype="org.eclipse.jetty.server.ConnectionFactory">Array>Arg><Setname="host"><Propertyname="jetty.ssl.host"deprecated="jetty.host"/>Set><Setname="port"><Propertyname="jetty.ssl.port"deprecated="ssl.port"default="8443"/>Set><Setname="idleTimeout"><Propertyname="jetty.ssl.idleTimeout"deprecated="ssl.timeout"default="30000"/>Set><Setname="soLingerTime"><Propertyname="jetty.ssl.soLingerTime"deprecated="ssl.soLingerTime"default="-1"/>Set><Setname="acceptorPriorityDelta"><Propertyname="jetty.ssl.acceptorPriorityDelta"deprecated="ssl.acceptorPriorityDelta"default="0"/>Set><Setname="acceptQueueSize"><Propertyname="jetty.ssl.acceptQueueSize"deprecated="ssl.acceptQueueSize"default="0"/>Set>New>Arg>Call><Newid="sslHttpConfig"class="org.eclipse.jetty.server.HttpConfiguration"><Arg><Refrefid="httpConfig"/>Arg><Callname="addCustomizer"><Arg><Newclass="org.eclipse.jetty.server.SecureRequestCustomizer"><Argtype="boolean"><Propertyname="jetty.ssl.sniHostCheck"default="true"/>Arg>New>Arg>Call>New>Configure>jetty-https.xml 设置使用HttpConfiguration从https连接器
jetty.xml和ssl配置jetty-ssl.xml:
xmlversion="1.0"?><Configureid="sslConnector"class="org.eclipse.jetty.server.ServerConnector"><Callname="addIfAbsentConnectionFactory"><Arg><Newclass="org.eclipse.jetty.server.SslConnectionFactory"><Argname="next">http/1.1Arg><Argname="sslContextFactory"><Refrefid="sslContextFactory"/>Arg>New>Arg>Call><Callname="addConnectionFactory"><Arg><Newclass="org.eclipse.jetty.server.HttpConnectionFactory"><Argname="config"><Refrefid="sslHttpConfig"/>Arg>New>Arg>Call>Configure>现在你需要告诉插件应用上面的文件:
<plugin><groupId>org.eclipse.jettygroupId><artifactId>jetty-maven-pluginartifactId><version>9.3.1-SNAPSHOTversion><configuration><jettyXml>jetty.xml,jetty-ssl.xml,jetty-https.xmljettyXml>configuration>plugin>谨慎
就像Jetty的安装分布,xml文件的顺序是重要的。
您还可以使用jetty xml文件配置http连接器插件使用。我们使用相同的
jetty-http.xml文件从码头地理分布:
xmlversion="1.0"?><Configureid="Server"class="org.eclipse.jetty.server.Server"><Callname="addConnector"><Arg><Newid="httpConnector"class="org.eclipse.jetty.server.ServerConnector"><Argname="server"><Refrefid="Server"/>Arg><Argname="acceptors"type="int"><Propertyname="jetty.http.acceptors"deprecated="http.acceptors"default="-1"/>Arg><Argname="selectors"type="int"><Propertyname="jetty.http.selectors"deprecated="http.selectors"default="-1"/>Arg><Argname="factories"><Arraytype="org.eclipse.jetty.server.ConnectionFactory"><Item><Newclass="org.eclipse.jetty.server.HttpConnectionFactory"><Argname="config"><Refrefid="httpConfig"/>Arg>New>Item>Array>Arg><Setname="host"><Propertyname="jetty.http.host"deprecated="jetty.host"/>Set><Setname="port"><Propertyname="jetty.http.port"deprecated="jetty.port"default="8080"/>Set><Setname="idleTimeout"><Propertyname="jetty.http.idleTimeout"deprecated="http.timeout"default="30000"/>Set><Setname="soLingerTime"><Propertyname="jetty.http.soLingerTime"deprecated="http.soLingerTime"default="-1"/>Set><Setname="acceptorPriorityDelta"><Propertyname="jetty.http.acceptorPriorityDelta"deprecated="http.acceptorPriorityDelta"default="0"/>Set><Setname="acceptQueueSize"><Propertyname="jetty.http.acceptQueueSize"deprecated="http.acceptQueueSize"default="0"/>Set>New>Arg>Call>Configure>现在我们将其添加到插件的配置列表应用:
<plugin><groupId>org.eclipse.jettygroupId><artifactId>jetty-maven-pluginartifactId><version>9.3.1-SNAPSHOTversion><configuration><jettyXml>jetty.xml,jetty-http.xml,jetty-ssl.xml,jetty-https.xmljettyXml>configuration>plugin>或者,您可以使用 httpConnector配置元素在pom而不是如上所述。