Jetty学习四:部署到Jetty

转自:http://www.tuicool.com/articles/NrENjq

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元素在你的描述符文件中,如果你设置了系统属性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
posted @ 2017-05-09 10:49  adaandy  阅读(6162)  评论(1编辑  收藏  举报