二、Jetty的配置说明

运行Jetty Web应用

在Jetty应用服务器中部署war项目很简单，只需把项目war包放入Jetty的webapps子目录即可。你都无需重启Jetty，Jetty会自动随时监听webapps目录，自动完成新项目的部署。

一、Jetty目录剖析

bin：可执行脚本文件
demo- base：
etc：Jetty模块定义的XML配置文件的目录
lib：Jetty依赖的库文件
logs：Jetty的日志目录
modules：Jetty的模块
resources：外部资源配置文件的目录
webapps：项目WAR文件的目录
还需要关心根目录下的一个文件：start.d（Wondows系统是start.ini文件），它定义了Jetty的活动模块。

二、基本配置

1、修改Jetty的端口

Jetty默认使用8080端口，要让它使用其他端口（如7070），那么编辑start.d（Wondows系统是start.ini文件），找到jetty.http.port行，修改为：

## Connector port to listen on
jetty.http.port=7070

保存并退出，再重启Jetty。

2、修改webapps目录

Jetty下的webapps是默认的Web项目的部署目录，如果想修改此目录，可修改start.d配置文件（start.ini），移除以下行的注释符号“#”

# jetty.deploy.monitoredDir=webapps

并把内容修改到你指定的目录。保存并退出，再重启Jetty。

六、Jetty的模块化架构

Jetty运行于模块化的架构之上，这意味着Jetty的功能是以模块的方式运行的，比如HTTP、HTTPS、SSL、日志logging、JMX、JNDI、WebSocket等模块。常用的模块如HTTP、JSP和WebSocket模块都是默认就激活的，而其他如HTTPS、JMX等模块则需要手动激活。

1、单个模块的剖析

Jetty的modules子目录列出了所有的模块，这些模块是扩展名为.mod的文件，它声明了要被激活的JAR文件（在Jetty的lib子目录下）和XML配置文件（在Jetty的etc子目录下），以及其他要作为模块被激活的资源。
比如，可以查看modules子目录的logging.mod文件的内容，可以看到，它声明了配置文件是etc/jetty-logging.xml，所需的JAR包在lib/logging处，另外logs目录是必须的。

[ xml]
etc/jetty-logging.xml

[files]
logs/

[lib]
lib/logging/**.jar
resources/

2、通过命令行激活模块

激活Jetty的模块有两种方式。
第一种方式是通过命令行激活：

java -jar start.jar --add-to-startd=logging

上面的命令会在Jetty目录下创建logging.ini文件，相关的配置可以在此文件中查到。配置日志后，可以再次启动Jetty，并可以查看到日志模块是激活了的。

2、通过配置文件start.ini激活模块

第二种方式是通过配置文件start.ini激活模块

--module=logging

这种方式和前一种相似，且更常用。

3、配置模块

正如上面提到的，mod文件声明了相关的XML配置文件，在Jetty的etc子目录下，可以通过这些配置文件来配置模块。比如日志模块声明了相关的配置文件是jetty-logging.xml，可以通过修改此配置文件来调整日志。

=============================================================

Jetty 的基本配置

Jetty 的基本配置与 Tomcat类似，在这里主要介绍 Jetty 的端口设置及如何部署 Web应用。由于 Jetty 是个嵌入式 Web 服务器，因此设置方式比较特殊。

Jetty 的配置文件放在 etc 路径下，该路径下有如下几个配置文件:

jetty.xml文件。

jetty-jmx.xml文件。

jetty-plus.xml文件。

webdefault.xml文件。

其中 webdefault.xm1文件是 Web 应用的默认配置文件，与 Jetty 的配置没有太大的关系，该文件通常不需要修改。

另外的三个都是 Tomcat 的配置文件:jetty.xml文件是默认的配置文件;jetty-jmx.xml是启动 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: 相当于调用 setxx 方法。

Get: 相当于调用 getXxx 方法。

New: 创建某个类的实例。

Arg: 为方法或构造器传入参数。

Array: 设置一个数组。

Item: 设置数组或集合的-J页。

Call: 调用某个方法。

Jetty 是个嵌入式 Web 容器，因此它的服务对应一个 Server 实例，可以看到配置文件中有如下片段:

 <!--配置了一个Jetty服务器进程-->
<Configure id="Server" class="org.mortbay.jetty.Server">

1. 配置 Jetty服务端口

Configure元素里的各种子元素，即对该Server实例的操作。在Configure元素下有如下代码所示的 Set 子元素， Set 子元素的 name 属性为 connectors，效果等同于调用setConnectors方法，用于设置Web 服务的提供端口。该方法需要Connector数组，其包含的 Array 子元素则用于设置该方法的参数。Array元素里的Item子元素，则是数组的数据项，每个Connector对应一个连接提供者。

 <!--类似于调用setConnectors方法-->
<Setname="co口口ectorsll>
<!--为 setConnectors方法传入参数><Array type="org.mortbay.jetty.Connector">
<!--下面的 Connector提供常见的Web服务-->
<Item>
<Newclass="org.mortbay.jetty.nio.SelectChannelConnector">
<Set name="port">8080</Set>
<Set name="maxidleTime">30000</Set>
<Set name="lowResourceMaxIdleTime">3000</Set>

<Set name="Acceptors">l</Set>
</New><lItem>

<!--如果Java 的nio不可用，则使用如下的Connector-->

<!--
<Item><Newclass="org.mortbay.jetty.bio.SocketConnector">
<Set name="port">8081</Set>
<Set name="maxIdleTime">50000</Set></New>
<Itern>
-->
<!-- Use this connector for few very active connections ONLY IF
Select Channel Connector cannot handle your load
<Itern>
<New class="org.mortbay.jetty.nio.BlockingChannelConnector">
<Set name="port">8083</Set><Set name="maxIdleTime">30000</Set>
<Set name="lowResourceMaxIdleTime">3000</Set></New><lItem>
-->
<!--下面的 Connector用于设置HTTPS 的服务提供端口-->

<!--
<Itern>
<New class="org.rnortbay.jetty.security.SslSocketConnector">
<Set narne="Port">8443</Set>
<Set narne="rnaxIdleTirne">30000</Set>
<Set narne="Keystore"><Systern Property narne="jetty.horne" default="."
1>/etc/keystore</Set>
<Set narne="Password">OBF:lvnylzlolx8elvnwlvn61x8g1zlulvn4<1Set>
<Set narne="KeyPassword">OBF:lu2ulwmllz7s1z7alwnllu2g</Set>
</New>
<Item>
-->
</Array>
</Set>

在上面的配置片段中，默认第一个Connector是有效的，该Connector就是常规Web服务的Connector，其中的8080就是Jetty 的默认端口。

笔者将该片段修改如下:

 <!--下面的 Connector提供常见的Web服务-->
<Itern>
<!--提供基于nio 的 Connector-->
<New class="org.rnortbay.jetty.nio.SelectChannelConnector">
<!--设置端口号-->
<Set narne="port">8886</Set><Setnarne="maxIdleTirne">30000</Set>
<Setnarne="lowResourceMaxIdleTirne">3000</Set>
<Set narne="Acceptors">l</Set>
</New><lItem>

修改成上面所示的样例后，Jetty 的服务端口为88860 这也是笔者所使用的端口。

2. 部署 Web应用

Jetty也支持自动部署和配置文件部署。

如果使用默认的配置文件启动，webapps 会自动部署目录。即所有存放在webapps路径的Web应用将自动部署在Jetty容器中。

如果使用带Jetty扩展功能来启动，~P增加jetty-plus.xrnl文件来启动，则webapps-plus也会自动部署目录，将所有放在该路径的Web应用自动部署在Jetty容器中。下面看如何使用配置文件来部署Web应用。

部署 Web 应用需使用 org.mortbay.jetty.webapp.WebAppContext，该类的实例即对应一个 Web 应用，并且该类还包含多个静态的重载方法:addWebApplications。该方法用于同时部署多个Web应用，即用于配置一个自动部署目录。

jetty.xrnl配置文件的片段如下:

<!--调用 WebAppContext 的静态方法addWebApplications-->
<Call class="org.rnortbay.jetty.webapp.WebAppContext" 
name="addWebApplications">
<!--下面用于为方法传入参数-->
<Arg><Ref id="contexts"I></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>
jetty-plus.xml文件的片段如下:
<!--调用WebAppContext 的静态方法addWebApplications-->
<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><!--设置Web应用的文档路径-->
<Arg>G:/StrutsTest/js</Arg><!…设置 Web应用的 url-->
<Arg>/</Arg>
<!--设置Web应用的默认配置描述符-->
<Set name="defaultsDescriptor">
<SystemProperty name="jetty.home" default=" ."/>/etc/webdefault.xml</Set>
<!--相当于调用 setVirtualHosts方法，用于设置虚拟主机-->
<Set name="virtualHosts"><!--Array表示创建一个数组-->
<Array type="java.lang.String">
<Item>localhost</Item>
</Array>
</Set>
<!--类似于调用getSessionHandler方法-->
<Get name="SessionHandler">
<Set name="SessionManager">
<New class="org.mortbay.jetty.servlet.HashSessionManager">
<!--设置Sess工on 的超时时长-->
<Setname="maxInactiveInterval" type="int">600</Set>
</New>
</Set></Get></New>

注意:该代码片段在jetty.xml文件仅仅被注释，只要取消该代码片段注释即可。但需要注意: jetty.xml文件默认有个小错误，它的设直超时时长的Set元素的 name属性值为 maxInactivelntervale。实际上HashSessionManager并没有setMaxInactiveIntervale方法，通 过查看API 文档发现，它包含一个setMaxInactiveInterval方法(最后少一个e)，读者将原有的e 删除即可。

通常建议增加自己的配置文件，应尽量避免修改系统原有的配置文件。增加的配置文件如下:

<?xml version="1.0"encod工ng="gb2312"?>
<lDOCTYPE ConfigurePUBL工C"-//Mort Bay Consulting//DTD Configure//EN"
''http://jetty.mortbay.org/configure.dtd''>
<Configure id="Server" class="org.mortbay.jetty.Server">

<!--创建一个Web应用-->
<New class="org.mortbay.jetty.webapp.WebAppContext">
<!--三个构造参数-->
<Arg><Ref id="contexts"/></Arg><!--设置Web应用的文档路径-->
<Arg>G:/StrutsTest/js</Arg><!--设置 Web应用的url-->
<Arg>/</Arg>
<!--设置Web应用的默认配置描述符-->
<Set name="defaultsDescriptor">
<SystemProperty口ame="jetty.home" default=" ."/>/etc/webdefault.xml</Set>
<!--相当于调用 setVirtualHosts方法，用于设置虚拟主机-->
<Set name="virtualHosts">
<!-- Array表示创建一个数组-->
<Arraytype="java.lang.String">
<Item>localhost</Item>
</Array></Set><!--类似于调用getSessionHandler方法-->
<Get name="SessionHandler"><Set name="SessionManager">
<New class="org.mortbay.jetty.servlet.HashSessionManager">
<!--设置Session的超时时长-->
<Set 口ame="maxInactiveInterval"type="int">600</Set>
</New>
</Set></Get>
</New></Configure>

将该配置文件保存在etc 路径下，以后每次启动Jetty 时，可直接加载该配置文件，使用如下启动命令即可(假设该配置文件的文件名为jetty-yeeku.xml):

java -jar startup.jar etc/jetty.xml etc/jetty-yeeku.xml

3. 配置 JNDI 绑定

Jetty 同样可以整合 DBCP、 C3PO 等数据源来提供容器管理的数据源。提供容器管理的数据源，只是 Jetty JNDI 绑定功能之一。

下面介绍如何在 Jetty 绑定 JNDI，以及 JNDI 的使用。

增加 JNDI 绑定必须使用 Jetty 的 plus 功能。因此，启动时必须增加 jetty-plus.xml
文件。增加 JNDI 的绑定同样有两个方法:

·修改系统默认的jetty.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) 增加如下配置文件:

 <?xml version="l.0"?>
<!一 Jetty配置文件的文件头，包含DTD等信息>
<lDOCTYPE Configure PUBLIC "-//Mort Bay Consu1ting//DTD 
Configure//EN"''http://jetty.mortbay.org/configure.dtd''>
<'一Jetty配置文件的根元素一〉
<Configure id="Server" c1ass="org.mortbay.jetty.Server">
<!-配置第一个环境变量，只是一个普通值>
<New id="woggle"c1ass="org.mortbay.jetty.plus.naming.
EnvEntry"><Arg>wogg1e</Arg>
<Argtype="java.lang.integer">4000</Arg>
</New>
<!--配置第二个环境变量，只是一个普通值一〉
<New id="wiggle"c1ass="org.mortbay.jetty.plus.naming.EnvEntry">
<Arg>wiggle</Arg><Arg type="java.lang.Double">100</Arg>
<Arg type="boolean">true</Arg>
</New><!…创建一个数据源一〉
<New 工d="ds" class="org.apache.commons.dbcp.BasicDataSource">
<!设置数据库驱动>
<Set name="driverClassName">com.mysql.jdbc.Driver</Set>
<!一设置数据库url-->
<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>

在上面的配置文件中，绑定了三个JNDI值，下面测试该JNDI 的 Servlet:

public class TestServlet extends HttpServlet
InitialContextic;
//Servlet的初始化方法，该方法完成Context的初始化
public void init(ServletConfig config) throws ServletException
super.init(config);
try
ic = new InitialContext();
catch (Exception e)
{
throw new ServletException(e);
//service 方法是 Servlet 的服务方法
public void service(HttpServletRequest request, HttpServletResponseresponse)
throwsServletException，工OException
//获取 JSP 页面输出流
PrintStream out = newPr工ntStream(response.getOutputStream());
try
//在控制台输出 w工ggle 的绑定值
System.out.println (ic.lookup("wiggle"));
/I:在控制台输出 woggle 的绑定值
System.out.println (ic.lookup("woggle") );
//获取绑定的数据源
DataSource ds = (DataSource)ic.lookup("jdbc/mydatasource");
//通过数据源获取数据库连接
Connectionconn = ds.getConnection();
//通过数据库连接创建Statement对象
Statement stmt=conn.createStatement();
//通过 Statement对象执行SQL查询，返回ResultSet对象
ResultSet rs = stmt.executeQuery("select* from news");
//遍历记录集
while(rs.next())
out.pr工ntl口 (rs.getString(2));
}
catch (Exception e)
e.printStackTrace() ;
在 web.xml 文件中增加如下片段:
<servlet>
<!一定义Servlet-->
<servlet-name>aa</servlet-name><servlet-class>lee.TestServlet</servlet-class>
</servlet><servlet-mapping>
<! --定义 Servlet的 url 映射-->
<servlet-name>aa</servlet-name><url-pattern>/aa</url-pattern></servlet-mapping>

启动 Jetty，访问该Servlet，即看到数据库的访问结果。