Jetty配置

xuyaxiu

Jetty 是 Java 领域另--个出色的 Web 服务器，这个服务器同样是开源项目。相对于Tomcat, Jetty 有更大的优点----可作为--个嵌入式服务器，即如果在应用中加入 Jetty的 Jar文件，则应用可在代码中对外提供 Web 服务。
Jetty路径结构
etc:该路径用于存放Jetty的配置文件。
examples:该路径用于存放Jetty的示例。
legal:该路径用于存放该项目的Lisence信息。
lib:该路径用于存放运行Jetty必需的J缸文件。
modules:该路径用于存放Jetty的模块，包括API文档。
patches:包含--些补丁说明。
pom.xm1:是Jetty的build文件，该文件不是Ant的build文件，而是mavaen2的build文件。
project-site:包含Jetty的网站的必需的样式文件。
readme.txt:包含最基本的使用信息。
start.jar:启动Jetty的启动文件。
version.txt:Jetty版本更新日志的简单版本。
webapps: 该路径用于存放自动部署的 Web 应用，只要将用户的 Web 应用复制到该路径下， Web 应用将自动部署。
webapps-plus: 存放--些用于演示 Jetty 扩展属性的 Web 应用，该路径下的 Web应用也可自动部署。
将解压缩后的文件放在任意路径即可。运行 Jetty 需要使用如下命令:
java -jar start.jar

Jetty 的基本配置
Jetty 的基本配置与 Tomcat类似，在这里主要介绍 Jetty 的端n设置及如何部署 Web应用。由于 Jetty 是个嵌入式 Web 服务器，因此设置方式比较特殊。
Jetty 的配置文件放在 etc 路径下，该路径下有如下几个配置文件:
jetty.xm1文件。
jetty-jmx.xm1文件。
jetty-plus.xm1文件。
webdefault.xm1文件。
其中 webdefault.xm1文件是 Web 应用的默认配置文件，与 Jetty 的配置没有太大的关系，该文件通常不需要修改。
另外的三个都是 Tomcat 的配置文件:jetty.xm1文件是默认的配置文件;jetty-jmx.xm1是启动 JMX 控制的配置文件; jetty-plus.xm1文件是在增加 Jetty 扩展功能的配置文件。在启动 Jetty 时输入如下命令:
java -jar startup.jar
默认使用jetty.xm1文件时启动Jetty，即与如下命令效果相同:
java -jar startup.jar etc/jetty.xml
启动时也可以指定多个配置文件，可输入如下命令:
java -jar startup.jaretc/jetty.xml etc/jetty-plus.xml
打开 Jetty 配置文件，该配置文件的根元素是Configure，另外还会看到有如下的配置元素。
Set: 相当于调用 se仅xx 方法。
Get: 相当于调用 getXxx 方法。
New: 创建某个类的实例。
Arg: 为方法或构造器传入参数。
Array: 设置--个数组。
Item: 设置数组或集合的-J页。
Call: 调用某个方法。
Jetty 是个嵌入式 Web 容器，因此它的服务对应--个 Server 实例，可以看到配置文件中有如下片段:
  <!-- 调用addConnector方法 -->
<Call name="addConnector">
<Arg>
<New class="org.mortbay.jetty.nio.SelectChannelConnector">
<Set name="host">
<SystemProperty name="jetty.host" />
</Set>
<Set name="port">
<!-- 端口号 -->
<SystemProperty name="jetty.port" default="8080" />
</Set>
<Set name="maxIdleTime">30000</Set>
<Set name="Acceptors">2</Set>
<Set name="statsOn">false</Set>
<Set name="confidentialPort">8443</Set>
<Set name="lowResourcesConnections">5000</Set>
<Set name="lowResourcesMaxIdleTime">5000</Set>
</New>
</Arg>
</Call>

部署 Web应用
Jetty也支持自动部署和配置文件部署。
如果使用默认的配置文件启动，webapps 会自动部署目录。即所有存放在webapps路径的Web应用将自动部署在Jetty容器中。
如果使用带Jetty扩展功能来启动，增加jetty-plus.xml文件来启动，则webapps-plus也会自动部署目录，将所有放在该路径的Web应用自动部署在Jetty容器中。下面看如何使用配置文件来部署Web应用。
部署 Web 应用需使用 org.mortbay.jetty.webapp.WebAppContext，该类的实例即对应一个 Web应用，并且该类还包含多个静态的重载方法:addWebApplications。该方法用于同时部署多个Web应用，即用于配置--个自动部署目录。
jetty.xml配置文件的片段如下:
<!-- 调用 WebAppContext 的静态方法addWebApplications -->
<Call class="org.mortbay.jetty.webapp.WebAppContext" name="addWebApplications">
<Arg>
<Ref id="contexts" />
</Arg>
<!-- 指定自动部署目录-->
<Arg>./webapps</Arg>
<!--配置Web应用的默认配置文件-->
<Arg>
<SystemProperty name="jetty.home" default="." />/etc/webdefault.xml
</Arg>
<!-- 是否解压缩-->
<Arg type="boolean">True</Arg>
<Arg type="boolean">False</Arg>
</Call>
<Call class="org.mortbay.jetty.webapp.WebAppContext" name="addWebApplications">
<Arg>
<Ref id="Server" />
</Arg>
<Arg>./webapps-plus</Arg>
<!--配置Web应用的默认配置文件-->
<Arg>org/mortbay/jetty/webapp/webdefault.xml</Arg>
<Arg>
<Ref id="plusConfig" />
</Arg>
<!-- 是否解压缩-->
<Arg type="boolean">True</Arg>
<Arg type="boolean">False</Arg>
</Call>

通过查看该配置文件不难发现，在每次调用addWebApplications方法后，即可增加--个Web应用的自动部署路径。如有必要，用户完全可以增加自己的自动部署路径，如果增加了自动部署路径，则所有在该路径下的Web应用将自动部署。如果仅需要部署--个Web应用，可以有如下两种方法: ·修改jetty.xml文件。 增加自己的配置文件。根据前面的介绍，对于Web服务器，应尽量避免修改默认的配置文件。如果读者真需要通过修改jetty.xml文件来部署Web应用，则应在 jetty 的 Configure元素下增加如下片段:
<!--创建一个Web应用 -->
<New class="org.mortbay.jetty.webapp.WebAppContext">
<Arg>
<Ref id="contexts" />
</Arg>
<Arg>d:/StrutsTest/</Arg>
<!-- 设置 Web应用的 url -->
<Arg>/</Arg>
<!-- 设置Web应用的默认配置描述符-->
<Set name="defaultsDescriptor">
<SystemProperty name="jetty.home" default="." />
/etc/webdefault.xml
</Set>
<!-- 相当于调用 setVirtualHosts方法，用于设置虚拟主机  -->
<Set name="virtualHosts">
<Array type="java.lang.String">
<Item>localhost</Item>
</Array>
</Set>
<!--类似于调用getSessionHandler方法-->
<Get name="SessionHandler">
<Set name="SessionManager">
<New class="org.mortbay.jetty.servlet.HashSessionManager">
<!-- 设置Session 的超时时长-->
<Set name="maxInactiveinterval" type="int">600</Set>
</New>
</Set>
</Get>
</New>
将该配置文件保存在etc 路径下，以后每次启动Jetty 时，可直接加载该配置文件，使用如下启动命令即可(假设该配置文件的文件名为jetty-yeeku.xml): java -jar startup.jar etc/jetty.xml etc/jetty-yeeku.xml

配置 JNDI 绑定
Jetty 同样可以整合 DBCP、 C3PO 等数据源来提供容器管理的数据源。提供容器管理的数据源，只是 Jetty JNDI 绑定功能之一。
下面介绍如何在 Jetty 绑定 JNDI，以及 JNDI 的使用。
增加 JNDI 绑定必须使用 Jetty 的 plus 功能。因此，启动时必须增加 jetty-plus.xml

增加自己的配置文件方式。
在 Jetty 的 plus 中，有如下包。
org.mortbay.jetty.plus.naming:执行JNDI绑定的包。
该包下有如下四个类。
EnvEntry: 绑定简单值。
NamingEntry: 抽象类，是另外三个类的父类。
Resource: 用于绑定数据源等资源。
Transaction: 用于绑定事务。
增加数据源绑定请按如下步骤进行。
(1)此处绑定的数据源依然以 DBCP 为实现，当然也可以绑定 C3PO 数据源，但必须将 DBCP 所需要的 jar文件复制到 Jetty 可以使用的路径中。根据前面介绍 DBCP 主要需要如下三个文件:
commons-dbcp.jar
commons-pool.jar
commons-collections.jar
将这三个文件复制到 Jetty 的 lib 路径下即可， Jetty 启动时会自动加载该路径的jar文件。当然，还需将数据库驱动复制到该路径下。
(2) 增加如下配置文件:
<Configure id="Server" c1ass="org.mortbay.jetty.Server">
<New id="wogg1e" c1ass="org.mortbay.jetty.p1us.naming.EnvEntry">
<Arg>wogg1e</Arg>
<Arg type="java.1ang.integer">4000</Arg>
</New>
<New id="wigg1e" c1ass="org.mortbay.jetty.p1us.naming.EnvEntry">
<Arg>wigg1e</Arg>
<Arg type="java.1ang.Doub1e">100</Arg>
<Arg type="boo1ean">true</Arg>
</New>
<!--  创建一个数据源-->
<New id="ds" class="org.apache.commons.dbcp.BasicDataSource">
<Set name="driverClassName">com.mysql.jdbc.Driver</Set>
<Set name="url">jdbc:mysql://localhost:3306/j2ee</Set>
<Set name="username">root</Set>
<Set name="password">32147</Set>
<Set name="maxActive" type="int">100</Set>
<Set name="maxldle" type="int">30</Set>
<Set name="maxWait" type="int">1000</Set>
<Set name="defaultAutoCommit" type="boolean">true</Set>
<Set name="removeAbandoned" type="boolean">true</Set>
<Set name="removeAbandonedTimeout" type="int">60</Set>
<Set name="logAbandoned" type="boolean">true</Set>
</New>
<!-- 将实际的数据源绑定到jdbc/mydatasource这个 JNDI 名 -->
<New id="mydatasource" class="org.mortbay.jetty.plus.naming.Resource">
<Arg>jdbc/mydatasource</Arg>
<Arg>
<Ref id="ds" />
</Arg>
</New>
</Configure>