Jetty学习四：部署到Jetty

Web应用的框架

标准Jetty发布版本能部署标准servlet Spec Web应用和Jetty内部ContextHandler部署描述符，或者两者的一个混合。 

Web应用是可部署的动态（servlets、filters、jsps、等等）和静态内容、支持库、和绑定到特定上下文路径的描写性的元数据的集合。 

格式和布局最终都是通过Servlet Spec定义，你可以查阅官方Servlet Spec文档获取关于Web应用布局和结构的更多细节，这里将给出一个基本的轮廓。 

Web应用能被捆绑到一个单个的Web文件（WAR文件）或者作为一个文件夹树： 

 1）/WEB-INF/ 

 专门的Servlet API定义文件夹，通常存储和Web应用相关但不为外部访问的任何东西。 

 如果你有内容被你的Web应用内部访问，但不会被web浏览器直接地访问，你就应该把他们放在这里。 

 2）/WEB-INF/web.xml 

 必须的部署描述符，用于定义你的Web应用的各种行为。 

 3）/WEB-INF/classes/ 

 Web应用的java classes文件放置目录。 

 4）/WEB-INF/lib/ 

 JAR文件放置的目录。

自动的Web应用部署

为了部署Web应用，最简单的方式就是放置你的WAR文件或者解压后的WAR文件夹到${jetty.home}/webapps/，Jetty的部署扫描器将发现它，并部署它到同名的Context路径下。 

上下文路径基于你的WAR的文件名（或文件夹名）。下面是一些例子（文件或文件夹名->上下文路径）： 

/webapps/footrope.war -> http://host/footrope/ 

/webapps/baggywrinkle-1.0.war -> http://host/baggywrinkle-1.0/ 

/webapps/lazaret-2.1.3-SNAPSHOT.war -> http://host/lazaret-2.1.3-SNAPSHOT/ 

/webapps/belaying-pins/WEB-INF/web.xml -> http://host/belaying-pins/ 

/webapps/root.war (special name) -> http://host/ 

/webapps/root/WEB-INF/web.xml (special name) -> http://host/

配置特定的Web应用部署

用自动的Web应用部署方式是快速和简单的，但有时你也许需要调整一些部署属性（例如，你想指定一个上下文路径而不是使用文件名，或者你想为这个Web应用指定一个特定的数据库连接池），你可以使用Jetty Deployable Descriptor XML文件来实现。 

Jetty支持通过XML文件部署Web应用，这些XML文件将构建一个Jetty能部署的ContextHandler实例。

使用基本的描述符文件

在默认的Jetty安装中，Jetty扫描他的$JETTY_HOME/webapps文件夹查找上下文部署描述符文件，为了用这个文件部署一个web应用，只需要放置这个文件在那个文件夹中。 

部署描述符文件自己是一个配置了一个WebAppContext类的XML文件。为了一个基本的安装，你需要设置仅两个属性： 

     war：web应用文件（或文件夹）的文件路径； 

     contextPath：web应用使用的上下文路径。 

例如，下面是是一个描述符文件，将/opt/myapp/myapp.war部署到上下文路径/wiki：

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/wiki</Set>
<Set name="war">/opt/myapp/myapp.war</Set>
</Configure>

或者你可以使用SystemProperty和Property元素在你的描述
4000
符文件中，如果你设置了系统属性myapp.home=/opt/myapp，你能重写上面的例子：

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/wiki</Set>
<Set name="war"><SystemProperty name="myapp.home"/>/myapp.war</Set>
</Configure>

如果你需要为你的应用修改home路径，你仅需要改变系统属性，这在有些场合非常有用。

配置高级描述符文件

如果你看WebAppContext类的文档，你会发现它有许多属性而不是仅仅有上面提到的两项，下面是一些为你的描述符文件配置高级属性的例子。 

第一个例子告诉Jetty在部署WAR文件的时候不要解压。这能帮助用户避免修改解压后的WAR，导致web应用下次部署的时候修改被还原。

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/wiki</Set>
<Set name="war"><SystemProperty name="myapp.home"/>/myapp.war</Set>
<Set name="extractWAR">false</Set>
</Configure>

下面的例子是获取JavaEE Servlet上下文，并为它设置初始化参数。你也能使用setAttribute方法设置Servlet上下文属性。然而，由于web应用的web.xml在部署描述符之后处理，web.xml值可能覆盖你设置的属性值。

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/wiki</Set>
<Set name="war"><SystemProperty name="myapp.home"/>/myapp.war</Set>
<Get name="ServletContext">
<Call name="setInitParameter">
<Arg>myapp.config</Arg>
<Arg><SystemProperty name="myapp.home">/config/app-config.xml</Arg>
</Call>
</Get>
</Configure>

下面是设置一个指定的web.xml的覆盖描述符的例子，该描述符在web应用的web.xml之后处理，因此它可以覆盖web.xml中设置的同名属性。当你想添加参数或者额外的附加Servlet mappings又不想修改压缩的WAR文件的时候，可以采用这种方式。

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/wiki</Set>
<Set name="war"><SystemProperty name="myapp.home"/>/myapp.war</Set>
<Set name="overrideDescriptor">/opt/myapp/overlay-web.xml</Set>
</Configure>

下面的例子不仅配置web应用上下文，而且配置一个数据库连接池。

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/wiki</Set>
<Set name="war"><SystemProperty name="myapp.home"/>/myapp.war</Set>
</Configure>

<New id="DSTest" class="org.eclipse.jetty.plus.jndi.Resource">
<Arg></Arg>
<Arg>jdbc/DSTest</Arg>
<Arg>
<New class="org.apache.commons.dbcp.BasicDataSource">
<Set name="driverClassName">org.some.Driver</Set>
<Set name="url">jdbc.url</Set>
<Set name="username">jdbc.user</Set>
<Set name="password">jdbc.pass</Set>
</New>
</Arg>
</New>

WebAppContext还有许多其它的设置项，具体可以参看WebAppContext的javadoc文档。

部署WebAppContexts的处理

web应用在进入service之前，需要一些处理：解压、为它们的jar指定classloader、web.xml和web-fragment.xml描述符处理、类的注释扫描。当web应用变得更加复杂时，我们增加方法帮助你在部署时添加或者减少处理的数量。在这节我们将学习部署处理和你怎么裁剪它。

Jetty的配置类

当一个webapp正在被部署时，一系列org.eclipse.jetty.webapp.Configuration类将被应用到它，它们中的每一个都履行一个特定的功能。这些配置的顺序是有意义的，后续的配置在先前的配置基础上处理。下面是被应用到每一个org.eclipse.jetty.webapp.WebAppContext的配置列表，按顺序：

org.eclipse.jetty.webapp.WebInfConfiguration -> 抽取war，整理jars和定义classpath 

org.eclipse.jetty.webapp.WebXmlConfiguration -> 处理WEB-INF/web.xml文件 

org.eclipse.jetty.webapp.MetaInfConfiguration -> 为META-INF/resources和META-INF/web-fragment.xml查看container和webapp jars 

org.eclipse.jetty.webapp.FragmentConfiguration -> 处理所有的发现的META-INF/web-fragment.xml文件 

org.eclipse.jetty.webapp.JettyWebXmlConfiguration -> 处理WEB-INF/jetty-web.xml文件

一个配置类的结构

一个配置类在WebAppContext的生命周期中有五个阶段： 

 1）preConfigure：在WebAppContext启动时执行。配置应该发现它在后续的阶段需要的所有资源； 

 2）configure：这个阶段将执行配置类的工作，通常会使用在preConfigure阶段发现的资源； 

 3）postConfigure：这个阶段配置将清理上一个阶段创建的一些资源，这些资源在WebAppContext的生命周期中将不再需要； 

 4）deconfigure：这个阶段在WebAppContext被停止时出现，允许配置撤销它创建的资源/元数据； 

 5）destroy：这个阶段在WebAppContext从service移除时调用，例如：和它相关的war文件将从$JETTY_HOME/webapps文件夹中删除。 

每个配置类的每个阶段都按照配置类的配置顺序被调用，例如，用默认配置类作为例子，preConfigure()被调用的顺序依照WebInfConfiguration、WebXmlConfiguration、MetaInfConfiguration、FragmentConfiguration、最后JettyWebXmlConfiguration，这个循环又开始在configure()阶段，然后是postConfigure()阶段，循环再次重复在deconfigure()，最终在destroy()阶段。

通过创建额外的配置扩展容器支持

由上所述，有一个默认的配置集合支持基本的webapp部署。你将注意到我们没有提到一些JavaEE特征，例如JNDI，也没有提到高级servlet spec特征，例如注释。那是因为Jetty的哲学是允许用户按照自己的需要裁剪容器。如果你不需要这些特征，那么你不需要为它们付出代价 - 一个重要的考虑是因为这些特征例如注释需要大量的和耗时的WEB-INF/lib包的扫描，这些都可能成为部署延迟的源头。我们将在下面的“其它配置”中看到另一个Jetty提供的webapp工具，可以帮助削减分析jar包的时间消耗。 

Jetty采用插件的方式提供对JNDI和注释的支持。

首先，让我们看看怎么支持JNDI。 

我们需要用到两个额外的配置：

org.eclipse.jetty.plus.webapp.EnvConfiguration -> 创建java:comp/env为webapp，应用WEB-INF/jetty-env.xml文件 

org.eclipse.jetty.plus.webapp.PlusConfiguration -> 处理JNDI关联的WEB-INF/web.xml标记，并且与名目挂钩

这些配置必须按照上面的顺序添加，并且应该在配置列表中的org.eclipse.jetty.webapp.JettyWebXmlConfiguration前被插入。支持JNDI的细节将在后面用一个单独的章节讲解。

下面来看看怎么注释。我们需要仅一个额外的配置类帮助提供servlet注释扫描：

org.eclipse.jetty.annotations.AnnotationConfiguration -> 扫描容器和web app jars查找@WebServlet、@WebFilter、@WebListener等

上面的配置必须在org.eclipse.jetty.webapp.JettyWebXmlConfiguration之前插入。注释的配置细节也将在后面用一个单独的章节讲解。

怎么设置配置列表

你可以为Jetty指定一个不同的配置列表，通过下面的方式。 

 1）直接在WebAppContext中设置配置列表 

如果你仅希望影响一个webapp，这可能是最容易的方式。你可以通过上下文配置文件或者代码来设置配置列表，下面是一个例子怎么为JNDI和注释添加配置：

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">

<Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/my-cool-webapp</Set>

<Set name="configurationClasses">
<Array type="java.lang.String">
<Item>org.eclipse.jetty.webapp.WebInfConfiguration</Item>
<Item>org.eclipse.jetty.webapp.WebXmlConfiguration</Item>
<Item>org.eclipse.jetty.webapp.MetaInfConfiguration</Item>
<Item>org.eclipse.jetty.webapp.FragmentConfiguration</Item>
<Item>org.eclipse.jetty.plus.webapp.EnvConfiguration</Item>
<Item>org.eclipse.jetty.plus.webapp.PlusConfiguration</Item>
<Item>org.eclipse.jetty.annotations.AnnotationConfiguration</Item>
<Item>org.eclipse.jetty.webapp.JettyWebXmlConfiguration</Item>
</Array>
</Set>

</Configure>

 2）通过部署器为所有的webapp设置配置列表 

如果你用部署器（deployer），你能在WebAppProvider设置配置列表，它们将被应用到每一个被部署器部署的WebAppContext。

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure id="Server" class="org.eclipse.jetty.server.Server">

<Call name="addBean">
<Arg>
<New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
<Set name="contexts">
<Ref refid="Contexts" />
</Set>
<Call id="webappprovider" name="addAppProvider">
<Arg>
<New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
<Set name="monitoredDirName"><Property name="jetty.home" default="." />/webapps</Set>
<Set name="configurationClasses">
<Array type="java.lang.String">
<Item>org.eclipse.jetty.webapp.WebInfConfiguration</Item>
<Item>org.eclipse.jetty.webapp.WebXmlConfiguration</Item>
<Item>org.eclipse.jetty.webapp.MetaInfConfiguration</Item>
<Item>org.eclipse.jetty.webapp.FragmentConfiguration</Item>
<Item>org.eclipse.jetty.plus.webapp.EnvConfiguration</Item>
<Item>org.eclipse.jetty.plus.webapp.PlusConfiguration</Item>
<Item>org.eclipse.jetty.annotations.AnnotationConfiguration</Item>
<Item>org.eclipse.jetty.webapp.JettyWebXmlConfiguration</Item>
</Array>
</Set>
</New>
</Arg>
</Call>
</New>
</Arg>
</Call>
</Configure>

3）添加或者插入到一个存在的列表 

你可以将配置类添加或者插入一个已经存在的配置列表，下面是一个例子，它实现了为JNDI添加一个配置支持 - 你可以通过xml配置文件按，或者通过代码，这里使用配置文件，实际上它是Jetty发布版本的$JETTY_HOME/etc/jetty-plus.xml：

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure id="Server" class="org.eclipse.jetty.server.Server">

<!-- =========================================================== -->
<!-- Add plus Configuring classes to all webapps for this Server -->
<!-- =========================================================== -->
<Call class="org.eclipse.jetty.webapp.Configuration$ClassList" name="setServerDefault">
<Arg><Ref refid="Server" /></Arg>
<Call name="addAfter">
<Arg name="afterClass">org.eclipse.jetty.webapp.FragmentConfiguration</Arg>
<Arg>
<Array type="String">
<Item>org.eclipse.jetty.plus.webapp.EnvConfiguration</Item>
<Item>org.eclipse.jetty.plus.webapp.PlusConfiguration</Item>
</Array>
</Arg>
</Call>
</Call>

</Configure>

org.eclipse.jetty.webapp.Configuration.ClassList类提供了下面的方法： 

 1）addAfter：在给出的配置类名的后面插入提供的配置类列表； 

 2）addBefore：在给出的配置类名之前插入提供的配置类列表。

其它配置

org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern

这是一个上下文属性，用于设置在an org.eclipse.jetty.webapp.WebAppContext，控制容器的classpath的哪些部分应该为一些特性做处理，这些特性包括：注释、META-INF/resources、META-INF/web-fragment.xml等。 

属性的值是一个正则表达式，下面是一个例子，使用xml文件（也可以用代码），指定匹配任何名字以“foo-”或者“bar-”开始的jar，或者名字为classes的文件夹：

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">

<Call name="setContextAttribute">
<Arg>org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern</Arg>
<Arg>.*/foo-[^/]*\.jar$|.*/bar-[^/]*\.jar$|.*/classes/.*</Arg>
</Call>

</Configure>

注意配置的顺序决定了jar或者class文件夹扫描的顺序。

org.eclipse.jetty.server.webapp.WebInfIncludeJarPattern

和上面类似，这个属性控制哪个jar因为注释和META-INF下的资源被处理。然而，这个属性只处理webapp的classpath（通常是WEB-INF/lib）下的jar。当你有许多jar在WEB-INF/lib中，但你知道只有少数的jar需要被扫描的时候特别有用。 

下面是一个例子，这里只匹配以“spring-”开头的jar：

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Configure class="org.eclipse.jetty.webapp.WebAppContext">

<Call name="setContextAttribute">
<Arg>org.eclipse.jetty.server.webapp.WebInfIncludeJarPattern</Arg>
<Arg>.*/spring-[^/]*\.jar$</Arg>
</Call>

</Configure>

注意配置的顺序决定了jar扫描的顺序。

配置静态内容部署

你可以用Jetty部署描述符文件和内部的ResourceHandler设置简单的静态内容服务。仅需要在${jetty.home}/webapps文件夹中创建一个文件scratch.xml，然后粘贴这些文件内容在它里面。

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure class="org.eclipse.jetty.server.handler.ContextHandler">
<Set name="contextPath">/scratch</Set>
<Set name="handler">
<New class="org.eclipse.jetty.server.handler.ResourceHandler">
<Set name="resourceBase">/home/jesse/scratch</Set>
<Set name="directoriesListed">true</Set>
</New>
</Set>
</Configure>

这是一个很基本的静态文件服务设置，如果你想要你写高级设置，可以使用DefaultServlet。

热部署

Jetty可以通过监听一个文件改变来部署任意的上下文或者web应用。如果你增加一个web应用或一个上下文描述符到这个文件夹，Jetty的DeploymentManager（DM）将部署一个新的上下文。如果你接触或者更新一个上下文描述符，DM停止、重配置、并重新部署它的上下文。如果你移除一个上下文，DM停止它，并从server移除它。 

为了控制这个行为，你将需要配置一些WebAppProvider属性。 

 1）monitoredDirName：需要扫描的可能部署web应用（或部署描述符xml文件）的文件夹； 

 2）scanInterval：提供的monitoredDirName的扫描周期，单位秒；0表示不支持热部署。 

这个配置默认的位置是在${jetty.home}/etc/jetty-deploy.xml文件中。

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">
<Configure id="Server" class="org.eclipse.jetty.server.Server">

<Call name="addBean">
<Arg>
<New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
<Set name="contexts">
<Ref refid="Contexts" />
</Set>
<Call name="setContextAttribute">
<Arg>org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern</Arg>
<Arg>.*/servlet-api-[^/]*\.jar$</Arg>
</Call>

<Call id="webappprovider" name="addAppProvider">
<Arg>
<New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
<Set name="monitoredDirName"><Property name="jetty.home" default="." />/webapps</Set>
<Set name="defaultsDescriptor"><Property name="jetty.home" default="." />/etc/webdefault.xml</Set>
<Set name="scanInterval">1</Set>
<Set name="extractWars">true</Set>
</New>
</Arg>
</Call>
</New>
</Arg>
</Call>
</Configure>

更多的细节将在“部署架构”中讲解。

部署架构

Jetty围绕一个可扩展的部署管理器架构构建，这个架构包括它内部的Web应用的生命周期。 

为了让Jetty提供内容服务（静态或动态），你需要创建一个ContextHandler，并在适当的位置添加它到Jetty。在Jetty 7增加的可插拔的DeploymentManager使这个过程变得更加容易。Jetty发布中包含了DeploymentManager的例子，部署WAR文件并部署Jetty context.xml文件到Jetty。 

DeploymentManager是webapp部署机制的核心；它包含一个应用生命周期图（Application LifeCycle Graph），应用提供者（Application Provider），和在图中的一组绑定。应用提供者负责发现和提供应用到应用生命周期图，图中的绑定用于控制部署过程。

应用提供者（Application Providers）

Jetty部署一个应用前，一个AppProvider标识这个APP，然后提供它到DeploymentManager。Jetty发布中主要的AppProvider是WebAppProvider。

应用生命周期图（Application LifeCycle Graph）

DeploymentManager的核心特征是应用生命周期图。



图的节点和边在Jetty中是预定义的，根据最通常的行为和状态发现，但它们并不是硬编码的，你能根据你的需要调整和添加它们。 

新的应用在Undeployed节点进入这个图，然后java.lang.String DeploymentManager.requestAppGoal(App,String)方法推动他们通过整个图。

生命周期绑定（LifeCycle Bindings）

一组默认的AppLifeCycle.Bindings定义标准行为，并处理部署、启动、停止和卸载应用。你能写你自己的AppLifeCycle.Bindings，然后分配它们到应用生命周期图的任何地方。 

你写的AppLifeCycle.Binding可以包括： 

 1）验证进入的应用； 

 2）阻止已知的被禁止的应用的部署； 

 3）在一个协作的环境中，提交安装到应用审计服务； 

 4）分发应用到在蔟（cluster）或云（cloud）中的其它节点； 

 5）通知应用状态改变的owner/admin。 

有四个默认的绑定： 

 1）StandardDeployer：在合适的位置部署ContextHandler进入Jetty； 

 2）StandardStarter：设置ContextHandler到started，开始接收输入请求； 

 3）StandardStopper：停止ContextHandler，停止接收输入请求； 

 4）StandardUndeployer：从Jetty中移除ContextHandler。



还有一个非标准的绑定，叫Debug Binding，用于debugging，它为通过应用生命周期的各种转换记录日志。

理解默认的WebAppProvider

WebAppProvider为WAR文件、文件夹或Jetty部署描述符XML文件提供部署。它支持热部署。 

WebAppProvider的基本操作是为部署预扫描文件夹。在标准Jetty发布中，这被配置在${jetty.home}/etc/jetty-deploy.xml文件。

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">
<Configure id="Server" class="org.eclipse.jetty.server.Server">

<Call name="addBean">
<Arg>
<New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
<Set name="contexts">
<Ref refid="Contexts" />
</Set>
<Call id="webappprovider" name="addAppProvider">
<Arg>
<New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
<Set name="monitoredDirName"><Property name="jetty.home" default="." />/webapps</Set>
<Set name="defaultsDescriptor"><Property name="jetty.home" default="." />/etc/webdefault.xml</Set>
<Set name="scanInterval">1</Set>
<Set name="extractWars">true</Set>
</New>
</Arg>
</Call>
</New>
</Arg>
</Call>
</Configure>

上面的配置将创建一个DeploymentManager，并作为一个Server LifeCycle Bean。 

 1）contexts 

 一个HandlerContainer引用，通常在${jetty.home}/etc/jetty.xml文件中的id="Contexts"的项，是一个ContextHandlerCollection的实例。 

 2）monitoredDirName 

 一个指向文件夹的文件路径或者URL，用于扫描web应用。扫描按照下面的规则： 

  （1）Base文件夹必须存在 

  （2）隐藏文件（"."开头的文件）被忽略 

  （3）以".d"结尾的文件夹被忽略 

  （4）通常的CVS文件夹"CVS"和"CVSROOT"被忽略 

  （5）任何*.war文件被自动部署 

  （6）任何*.xml文件被作为上下文描述符部署 

  （7）当WAR文件和XML文件有相同的base那么，那么WAR文件不被部署，XML文件被认为配置和引用WAR文件 

  （8）文件夹是可部署的 

  （9）文件夹和WAR文件同名，文件夹不被部署，WAR文件被认为和文件夹相同并自动部署 

  （10）文件夹和XML文件同名，文件夹不被部署，XML文件认为配置和引用文件夹 

  （11）其它所有文件夹采用自动部署 

  （12）如果自动部署被用，文件名root.war或者文件夹名root将部署到"/"上下文路径 

 3）defaultsDescriptor 

 指定默认的servlet web描述符供所有web应用使用。描述符的目的是在web应用自己的/WEB-INF/web.xml被应用前，为web应用提供共同的配置。Jetty发布中自带的${jetty.home}/etc/webdefault.xml控制JSP和默认servlets的配置。 

 4）scanInterval 

 monitoredDirName文件夹的扫描周期，单位秒，扫描包括：新的上下文需要部署，改变的上下文重部署，和移除的上下文卸载。 

 5）extractWars 

 如果参数为true，任何WAR或者zip文件在部署之前被先提取到一个临时的文件夹。如果在web应用中有未编译的JSP，这样做是很好的。 

 6）parentLoaderPriority 

 参数是一个布尔变量，选择标准Java parent first delegation被使用，或者servlet specification webapp classloading priority。后者是默认。

快速启动Webapps

Servlet的自动发现特征会使部署慢且不确定。web应用配置的自动发现在webapp的部署中是有用的，它允许通过指定jar文件来激活新的特征和框架。然而，为了部署，需要扫描一些jar包的内容，导致webapp启动时间延迟。 

从Jetty的9.2.0.M0版本开始，增加了快速启动模块，允许webapp被预扫描和预配置。这意味着所有的扫面将在部署之前完成，所有需要部署的项都将在部署之前准备好。所有的配置都会被编码到一个有效的web.xml中，叫WEB-INF/quickstart-web.xml，quickstart-web.xml文件不仅包含所有的Servlets、Filters和Constraints，而且它也编码为所有发现的上下文参数： 

 1）ServletContainerInitializers 

 2）HandlesTypes classes 

 3）Taglib Descriptors 

使用快速启动机制，jetty能完全绕过所有扫描和发现模型，快速启动一个webapp。

设置快速启动

为了使用宏快速启动，模块对jetty实例必须是可用的。在maven项目中仅需要添加一个在artifact ID为jetty-quickstart的依赖，或者使用下面的命令启动jetty发布版本：

>java -jar $JETTY_HOME/start.jar --add-to-startd=quickstart

同时你部署的webapps需要是org.eclipse.jetty.quickstart.QuickStartWebApp的实例，而不是通常的org.eclipse.jetty.webapp.WebAppContext。如果你的web应用已经有一个webapps/myapp.xml文件，则你能简单的改变配置元素中的这个类，否则你需要创建一个如下的webapps/myapp.xml文件：

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">
<Configure class="org.eclipse.jetty.quickstart.QuickStartWebApp">
<Set name="war"><Property name="jetty.webapps" default="."/>/benchmark.war</Set>
<Set name="contextPath">/benchmark</Set>
<Set name="autoPreconfigure">true</Set>
</Configure>

预配置web应用

如果QuickStateWebApp的方法setAutoPreconfigure(true)被调用（看上面myapp.xml的例子），那么webapp第一次部署时，一个WEB-INF/quickstart-web.xml文件将被产生，它包含了所有发现的配置。在接下来的部署中，所有的扫描将被跳过，quickstart-web.xml被直接用于配置web应用。 

也可以通过手动的运行类org.eclipse.jetty.quickstart.PreconfigureQuickStartWar来预配置一个war文件，如下：

>java -cp jetty-all-9.2.0.jar:servlet.jar org.eclipse.jetty.quickstart.PreconfigureQuickStartWar <myapp.war>

这将在第一次配置之前创建一个quickstart-web.xml文件。注意这也能是发现配置的好的调试工具。运行类似若不带参数可以看到运行它的其它选项。

用预编译JSP避免TLD扫描

预编译JSP是提高web应用启动时间的好方法，从jetty 9.2.0开始，apache Jasper JSP实现被使用，允许TLD扫描被略过。这可以通过增加一个上下文参数到web.xml文件做到（这可以通过使用Jetty Maven JSPC插件自动做到）：

<context-param>
<param-name>org.eclipse.jetty.jsp.precompiled</param-name>
<param-value>true</param-value>
</context-param>

绕过start.jar

Jetty Start.jar是一个非常有力和灵活的机制，用于构造一个classpath和执行编码在jetty xml格式的配置。然而，这个机制在构造classpath时需要花费时间。start.jar可以通过使用-dry-run选项绕过start.jar机制：

>RUN=$(java -jar $JETTY_HOME/start.jar --dry-run)
>eval $RUN