jetty部署Web应用程序 -

aoyouzi

浏览: 1981844 次
性别:
来自: 北京

最近访客更多访客>>

dy.f

zhaoshijie

lbq136957978

juzhibest

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

jetty部署Web应用程序

博客分类：

技术总结
WEb服务器

jetty 部署 Web 应用程序

5.1 常用术语

为了使本章中讨论的内容能得到大家一致的理解，本节先明确一些专业术语，避免大家造成误解。

web应用程序（Web Application）

经常会说到这个词，大家也不难理解，就是由一组文件构成的集合，这些文件可能包含html文件、图像文件、java编译后的class文件，配置文件等等所有可能出现的文件。符合Servlet规范的应用程序还要求目录下存在一个WEB-INF的文件夹，在里面还必须存在一个web.xml的web部署配置文件，关于这个目录和web.xml的内容格式都是Servlet规范中定义的。根据Servlet规范我们还可以web应用程序整个目录打包成 war文件。

上下文（Context）

上下文是我们经常听到的词汇，可以使用在各种专业场合，但当我谈论web应用程序的时候，是这样的意思。

首先看一个名为Example的web应用程序的访问URL，http://www.yourdomain.com/example /index.jsp。可以发现要访问这个Example应用，所有的路径都需要加前缀“/example”，换句话说，就是该应该的访问地址都符合 http://www.yourdomain.com/example/* 这种模式。所有已http://www.yourdomain.com/example/开头的请求都将有Example应用程序处理。

这就是上下文的概念了。有了上下文的概念后，一个web服务下就可以部署多套不同的web应用程序了，且不同的应用程序不会造成混乱。

上下文路径（Context Path）

在术语上下文的中，我们举例的“/example”就是上下文路径。同一个服务器下的不同的web应用就应该有不同的上下文路径。

注意：上下文路径必须以“/”开头，且不能以“/”结尾。

在Servlet规范中，通过API，request.getContextPath()方法来获取当前应用程序的上下文路径

5.2 初探

如果你使用过Tomcat服务器的话，那么你一定知道在Tomcat下部署一个web应用会有两种方式：一、将web程序目录或者war文件程序复制到 webapps目录。二、编写配置文件，指向到web程序的目录。我们Jetty也提供类似这两种方式，确有略为不同。

静态部署

在jetty安装目录下存在一个名为webapps的目录，你可以存放web应用程序或者war文件。Jetty服务启动时会扫描webapps目录下面的文件，如果识别为web应用程序，那么就启动它。上下文路径就是文件夹的名称或者war文件的名称。（文件夹或war的名称是 root，对应的上下文路径为 “/”）

此类部署方式之所以被称为静态部署 ，是因为在服务器启动完成后便不在扫描webapps目录变动情况了，换句话说，在服务启动完成后，再在webapps部署新的web应用，不会及时生效，需等到服务器重启后才能被识别。

顺便提醒下，虽然这里叫静态部署，但是web应用里面的jsp被修好后，还是会被动态重编译。

动态部署

在jetty安装目录下存在一个名为contexts的目录，在这个目录里面是用来放置动态部署的配置文件的，配置文件是xml文件，使用的语法和第4 章介绍的Jetty xml Configuration 语法相同。（配置文件语法统一，这也是jetty设计优秀之处）jetty启动服务时，会开启一个线程每隔一段时间扫描contexts目录下的xml配置文件，然后更加配置文件的内容来部署一个web应用。当服务器启动后的任意时刻，你在contexts下新增一个配置文件，jetty就会动态地启动这个web应用，同理，删除一个已存在的配置文件，jetty就会关闭相应的web应用。你也可以修改一下配置文件的最后修改时间，来达到重启web应用的功能。

此类部署方式就是所谓的动态部署了。

需要提醒的是，通常情况下你会认为部署一个web应用程序，那么这个web应用一定是符合Servlet规范的，不然jetty为什么会叫 servlet容器呢！但是Jetty的设计哲学没有强迫你非得这样做，Jetty允许你发布一个支持上下文功能，但不支持Servlet的应用。

如，在jetty自带的示例中，contexts目录下有一个文件javadoc.xml，内容如下：

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">

<!--

Configure a custom context for the javadoc.

This context contains only a ServletHandler with a default servlet

to serve static html files and images.

-->

<Call class="org.mortbay.log.Log" name="debug"><Arg>Configure javadoc.xml</Arg></Call>

<Set name="contextPath">/javadoc</Set>

<Set name="resourceBase"><SystemProperty name="jetty.home" default="."/>/javadoc/</Set>

<Item>index.html</Item>

<Item>contents.html</Item>

</Array>

</Set>

<Set name="cacheControl">max-age=3600,public</Set>

</New>

</Set>

</Configure>

该配置文件启动了一个java文档的web服务，文档的静态文件被放在 $jetty_home/javadoc目录下，访问地址是http://127.0.0.1:8080/javadoc。

现在看不懂这个文件也不要紧，后续内容会设计，这里只是用来展示下Jetty的灵活性。

webapps目录和contexts目录

这两个目录的位置一定必须在jetty安装目录下面么？它们的名字必须如此么？

根据前面不断宣称的Jetty的灵活性，答案肯定是否定的。目录的名称和位置只是jetty.xml文件中的默认配置，如果你愿意都可以修改。

5.3 Jetty实现上下文功能的基本原理

既然jetty可以同时部署多个web应用程序，那么必然支持上下文功能。本小节向你展示下Jetty是如何支持上下文功能。

在默认的服务配置文件jetty.xml中有如下一段配置：

<Item>

</Item>

<Item>

</Item>

<Item>

</Item>

</Array>

</Set>

</New>

</Set>

通过这段默认配置，为Jetty的Server对象设置了一组Handler对象，结构如下图：

Server对象将接收到的HTTP请求转发到 HandlerCollection对象，再由HandlerCollection对象将HTTP请求按顺序转发给内部所有的Handler对象，即被 HandlerCollection包含的对象都有机会去处理每一个请求。

让我们看一段 HandlerCollection的核心代码，来验证上面的说法：

for (int i=0;i<_handlers.length;i++)

{

try

{

_handlers[i].handle(target,request, response, dispatch);

}

catch(IOException e)

{

throw e;

}

catch(RuntimeException e)

{

throw e;

}

catch(Exception e)

{

if (mex==null)

mex=new MultiException();

mex.add(e);

}

现在来主要看本节的主角ContextHandlerCollection，通过

<New id="Contexts" class="org.mortbay.jetty.handler.ContextHandlerCollection"/>来配置，从上图中看出它也是一个集合，集合就意味着可以容纳其他Handler，再从类名可以看出该集合只能容纳ContextHandler类以及它的子类。New标签的 id属性被设置为“Contexts”，由第4章的内容可知ContextHandlerCollection对象会以key为“Contexts”保存起来，可以使用Ref标签可以再次引用该对象，如何引用在下面的篇章会介绍。

ContextHandlerCollection 的作用是什么？其作用是将接收到的请求分发给正确的ContextHandler来处理，分发的依据就是ContextHandler的上下文路径。

5.3 静态部署的原理和配置文件

上一节介绍了ContextHandlerCollection对象，但何时、如何向该对象中放入ContextHandler对象或其子类对象呢？本节介绍的静态部署将是其中的一种方法。

先看一段jetty.xml中的配置片段：

<Arg>

<Set name="webAppDir"><SystemProperty name="jetty.home" default="."/>/webapps</Set>

<Set name="parentLoaderPriority">false</Set>

<Set name="allowDuplicates">false</Set>

<Set name="defaultsDescriptor"><SystemProperty name="jetty.home" default="."/>/etc/webdefault.xml</Set>

</New>

</Arg>

</Call>

等价的Java代码是：

WebAppDeployer webAppDeployer = new WebAppDeployer ();

webAppDeployer.setContexts(env.get("Contexts "));

webAppDeployer.setWebAppDir(System.getProperty("jetty.home",".")+"/webapps" );

webAppDeployer.setParentLoaderPriority(false);

webAppDeployer.setExtract(true);

webAppDeployer.setAllowDuplicates(false);

webAppDeployer.setDefaultsDescriptor(System.getProperty("jetty.home",".")+"/etc/webdefault.xml" );

server .addLifeCycle(webAppDeployer );

其实Jetty就是用WebAppDeployer对象来完成静态部署的任务的。上一节中我们说过ContextHandlerCollection对象会以key为“Contexts”保存起来，WebAppDeployer.setContexts(env.get("Contexts "));方法将 ContextHandlerCollection对象的引用设置给了webAppDeployer对象，在服务器启动过程中 WebAppDeployer将默认实例化一些的ContextHandler的子类WebappContext的实例，并添加到 ContextHandlerCollection对象中去。大致的过程就是这样的，细节问题接下来会讨论。

WebAppDeployer 类的工作内容

当服务器启动时，WebAppDeployer扫描指定的WebAppDir 目录（默认配置为System.getProperty("jetty.home",".")+"/webapps" ,及jetty安装目录下的webapps目录，可以修改）。在WebAppDir目录中发现的文件夹或者.war文件或者.jar文件，每个文件夹或文件都会被看作是一个的web应用程序，实例化一个 WebAppContext对象，并将该对象添加到ContextHandlerCollection对象中去。

WebAppContext 代表一个支持Servlet标准的应用程序。

5.4 动态部署的原理和配置

动态部署的原理和静态部署基本原理差不多，都是向ContextHandlerCollection对象中增加ContextHandler的实例对象。

先看一段jetty.xml的配置：

<Arg>

<Set name="configurationDir"><SystemProperty name="jetty.home" default="."/>/contexts</Set>

</New>

</Arg>

</Call>

等价的Java代码是：

ContextDeployer contextDeployer = new ContextDeployer ();

contextDeployer.setContexts(env.get("Contexts") ); contextDeployer.setConfigurationDir(System.getProperty("jetty.home",".")+"/contexts" );

contextDeployer.setScanInterval(5 );//扫描间隔时间

server .addLifeCycle(contextDeployer);

可以看出Jetty正是利用ContextDeployer类来实现动态部署的功能。

ContextDeployer的工作内容

当服务器启动时，ContextDeployer扫描$jetty_home/contexts目录下面的所有xml文件，根据xml文件的配置内容，实例化相应的ContextHandler或其子类实现(WebappContext)对象，并将该对象添加到 ContextHandlerCollection对象中去。

ContextDeployer的方法setScanInterval会设定一个扫描间隔时间，单位为秒。服务器启动完成后，会有一个后台线程以 scanInterval为间隔，不断扫描configurationDir指定的目录，如果发现xml文件的新增、删除、修改会相应的执行对应 ContextHandler对象的部署、移除、重新部署等工作。

Contexts目录下面的配置文件是怎样的？使用的是Jetty xml Configuration的语法。先看一个文件示例：

$JettyHome/contexts/test.xml文件

<Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/test</Set>

<Set name="extractWAR">false</Set>

<Set name="copyWebDir">false</Set>

<Set name="defaultsDescriptor"> <SystemProperty name="jetty.home" default="."/>/etc/webdefault.xml</Set>

<!-- virtual hosts

<Item>www.myVirtualDomain.com</Item>

<Item>localhost</Item>

</Array>

</Set>

-->

<!-- disable cookies

<Set name="usingCookies" type="boolean">false</Set>

</Get>

-->

</Configure>

类 ContextDeployer是如何使用这个配置的呢？看下ContextDeployer中的一段核心代码：

XmlConfiguration xmlConfiguration=new XmlConfiguration(resource.getURL());

...

ContextHandler context=(ContextHandler) xmlConfiguration.configure();

第四章中介绍过XmlConfiguration类，相信你也知道它的用途了。$JettyHome/contexts/test.xml文件中 Configure标签的属性class="org.mortbay.jetty.webapp.WebAppContext"指明了最终需要实例化的类，这个类必须是ContextHandler本身或其子类，否则就会抛出异常。

在 text.xml文件中我们可以对当前test应用程序设定更多的特性，比如虚拟主机、是否启用Session功能等等，详细可以参考 WebAppContext类的API文档。

5.5 jetty-web.xml 配置文件

在动态部署的方式下，我们可以对WebAppContext对象进行详细设置，但是在静态部署时却不可以。而且把和web应用程序功能相关的配置放在 contexts目录下的一个配置文件中，对部署人员也是一个挑战，很容易混乱。

Jetty为了解决这个问题，运行我们在WEB-INF目录下面放入一个名为jetty-web.xml的文件（文件名还可以为jetty6- web.xml 或者 web-jetty.xml），这个配置文件的语法同样也是jetty xml configuration语法，其中Configure标签的class属性是 org.mortbay.jetty.webapp.WebAppContext。

一个jetty-web.xml的示例：

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">

<!--

This is the jetty specific web application configuration file. When starting

a Web Application, the WEB-INF/web-jetty.xml file is looked for and if found, treated

as a org.mortbay.xml.XmlConfiguration file and is applied to the

org.mortbay.jetty.servlet.WebApplicationContext objet

-->

<Call class="org.mortbay.log.Log" name="debug"><Arg>executing jetty-web.xml</Arg></Call>

</Configure>

在这个配置文件中你可以对已经实例化的WebAppContext对象进行操作。

Jetty服务在启动一个WebAppContext应用程序时，WebAppContext类会在当前应用的WEB-INF目录下面搜寻jetty- web.xml的配置文件，如果发现了类似文件，就调用XmlConfiguration类对WebAppContext的实例对象进行配置。

核心代码：

JettyWebXmlConfiguration.java

XmlConfiguration jetty_config=new XmlConfiguration(jetty.getURL());

jetty_config.configure(getWebAppContext());

其中getWebAppContext()方法的作用是取得当前启动的WebAppContext对象。

在Contexts目录下的配置文件中可以做的事情，在jetty-web.xml文件中一样可以做到。

同样即使我们使用静态部署的方式部署一个WebAppContext的应用程序，一样可以通过在WEB-INF目录下加入jetty-web.xml文件来控制WebAppContext对象的行为和属性。

5.6 webdefault.xml 文件

在ContextDeployer和WebAppDeployer两个类的实例化配置中我们都可以看到一个名为defaultsDescriptor的属性配置，默认情况下都指向了$jetty_home/etc/webdefault.xml文件。当然你可以不配置这个属性，默认会指向jetty.jar文件中的org/mortbay/jetty/webapp/webdefault.xml 文件，不过为了修改方便我们还是使用etc/webdefault.xml文件。

webdefault.xml 作用是什么？相信你在tomcat中也见过这种类似配置文件，作用就是为WebAppContext类型的应用程序提供一个默认的配置，其语法就是 Servlet规范中定义的web.xml文件的语法。

webdefault.xml主要定义了一些组件如：

DefaultServlet：服务静态文件
JspServlet：服务jsp页面

其余定义了常用的配置，比如默认Session过期时间、welcome- file-list等等。

接下来的章节会介绍DefaultServlet和JspServlet 的配置。

5.7 DefaultServlet配置

在webdefault.xml定义了DefaultServlet对象，DefaultServlet有很多可选的配置。

参数名	可选值	默认值	作用
acceptRanges	true 或 false	true	服务器是否支持静态文件下载的断点续传功能。 true支持，false不支持。
dirAllowed	true 或 false	true	如果访问的地址指向一个目录，且目录下不存在一个webcome文件的情况下，是否显示该目录列表内容。true显示，false不显示。注意：在生产环境下，建议设置为false，避免泄露不必要的详细。
welcomeServlets	true 或 false	false	一般情况下welcome- file-list指定的是具体存在文件，当文件不存在时要么显示403错误、要么显示目录列表内容。webcomeServlets的作用是，当 welcome文件不存在是是否把请求地址映射到响应的Servlet上执行。true映射，false不映射。默认情况下是不映射的，除非你想将一个某个Servlet路径作为一个webcome-file-list的一员时，可以将该设置为true。
redirectWelcome	true 或 false	false	请求发送给welcome文件路径的方式。true使用redirect方式，false使用forward方式。
gzip	true 或 false	false
resoureBase
relativeResourceBase
useFileMappedBuffer	true 或 false
cacheControl
maxCacheSize
maxCachedFileSize
maxCachedFiles
cacheType	"nio", "bio" or "both"

5.8 JSP配置

分享到：

Jetty服务配置文件 | Jetty构架

2014-07-23 09:59
浏览 7384
评论(0)
分类:开源软件
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

jetty部署Web应用程序

5.1 常用术语

5.2 初探

5.3 Jetty实现上下文功能的基本原理

Server对象将接收到的HTTP请求转发到 HandlerCollection对象，再由HandlerCollection对象将HTTP请求按顺序转发给内部所有的Handler对象，即被 HandlerCollection包含的对象都有机会去处理每一个请求。

5.3 静态部署的原理和配置文件

5.4 动态部署的原理和配置

5.5 jetty-web.xml 配置文件

5.6 webdefault.xml 文件

5.7 DefaultServlet配置

5.8 JSP配置

评论

发表评论

相关推荐

最近访客 更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

jetty部署Web应用程序

5.1 常用术语

5.2 初探

5.3 Jetty实现上下文功能的基本原理

Server对象将接收到的HTTP请求转发到 HandlerCollection对象，再由HandlerCollection对象将HTTP请求按顺序转发给内部所有的Handler对象，即被 HandlerCollection包含的对象都有机会去处理每一个请求。

5.3 静态部署的原理和配置文件

5.4 动态部署的原理和配置

5.5 jetty-web.xml 配置文件

5.6 webdefault.xml 文件

5.7 DefaultServlet配置

5.8 JSP配置

评论

发表评论

相关推荐

万字总结Java 9~15新特性

架构制图：工具与方法论

性能优化

【冬察冬见】FFmpeg系列学习笔记

有关创新的一些思考

浅谈面试官的培养

冬察冬见·全视角再议晋升

冬察冬见·晋升-晋升的那些事儿1

物联网MQTT实战

大小公司都适用的架构选型工具箱（涵盖上百个组件）

elasticsearch使用踩坑

【冬察冬见】读书日话高效读书

【冬察冬见·荐书】4·23世界读书日 80本书单推荐承包你一年的书单

快速上手 AB Test

优雅的微服务架构下的鉴权

知识图谱的构建

宜信微服务架构落地及其演进

MySQL性能优化神技

REST协议解密(原创)

大型互联网公司分布式ID方案总结

最近访客更多访客>>