1.3.2 Jetty 的基本配置（1）

darkpoon

　　1.3.2 Jetty 的基本配置（1）
　　Jetty 的基本配置与 Tomcat类似，在这里主要介绍 Jetty 的端口设置及如何部署 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.刀nl etc/jetty-plus.xml

　　打开 Jetty 配置文件，该配置文件的根元素是Configure，另外还会看到有如下的配
置元素。
　　Set: 相当于调用 se仅xx 方法。
　　Get: 相当于调用 getXxx 方法。
　　New: 创建某个类的实例。
　　Arg: 为方法或构造器传入参数。
　　Array: 设置一个数组。
　　Item: 设置数组或集合的-J页。
　　Call: 调用某个方法。
　　Jetty 是个嵌入式 Web 容器，因此它的服务对应一个 Server 实例，可以看到配置文件中有如下片段:

<1-配置了一个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服务 --> 〈Itern> <Newclass="org.mortbay.jetty.n工o.SelectChannelConnector"> <Set name="port">8080</Set> <Set 口ame="max工dleTime">30000</Set> <Set name="lowResourceMaxIdleTime">3000</Set><Set name="Acceptors">l</Set> </New><lItem><!如果Java 的 ni。不可用，则使用如下的Connector-&#8594; <!-- <Item><Newclass="org.mortbay.jetty.b工o.SocketConnector"> <Set 口ame="port">8081</Set> <Set name="maxIdleTime">50000</Set></New> <Itern> --> <!-- Use this connector for few very active connectionsONLY 工F SelectChannelConnector 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"><SysternProperty narne="jetty.horne" default="." 1>/etc/keystore</Set> <Set narne="Password">OBF:lvnylzlolx8elvnwlvn61x8g1zlulvn4<1Set> <Set narne="KeyPassword">OBF:lu2ulwmllz7s1z7alwnllu2g</Set> </New> <I工tern> --> </Array> </Set>

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

<!--下面的 Connector提供常见的Web服务 > 〈Itern> <!--提供基于nio 的 Connector--> <New class="org.rnortbay.jetty.nio.SelectChannelConnector"> <!&#8230;设置端口号一〉 <Set narne="port">8886</Set><Setnarne="rnaxIdleT工rne">30000</Set> <Setnarne="lowResourceMax工dleTirne">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 应用需使用 or咆g.mortba叮y予.扣t即ty.we讪ba叩pp.We由bAppCo∞nt优ex刘t，该类的实例即对应一个 Web 应用，并且该类还包含多个静态的重载方法:addWebApplications。该方法用于同时部署多个Web应用，即用于配置一个自动部署目录。
　　jetty.xrnl配置文件的片段如下:

<!--调用 WebAppContext 的静态方法addWebApplications--> <Call class="org.rnortbay.jetty.webapp.WebAppContext" name="addWebApplications"> <1 一下面用于为方法传入参数--> <Arg><Ref id="contexts"I></Arg> <'一 指定自动部署目录一〉 <Arg>./webapps</Arg> <!--配置Web应用的默认配置文件--> <Arg><SystemProperty name="jetty.home"default="."/> /etc/webdefault.刀nl</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"><!&#8230;三个构造参数&#8230;〉 <Arg><Ref id="contexts"/></Arg><!--设置Web应用的文档路径--> <Arg>G:/StrutsTest/js</Arg><!&#8230;设置 Web应用的 url--> <Arg>/</Arg> <!--设置Web应用的默认配置描述符一〉 <Set name="defaultsDescriptor"> <SystemProperty name="jetty.home" default=" ."/>/etc/webdefault.刀nl</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="maxInact工ve工nterval" type="工口t">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"><!&#8230;创建一个Web应用一〉 <New class="org.mortbay.jetty.webapp.WebAppContext"> <1-三个构造参数> <Arg><Ref id="contexts"/></Arg><!&#8230;设置Web应用的文档路径--> <Arg>G:/StrutsTest/js</Arg><1--设置 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.Str工ng"> 〈工tem>localhost</Item> </Array></Set><1--类似于调用getSessionHandler方法&#8230;〉 <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