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