本文来源于http://book.51cto.com/art/200808/86012.htm
一。 Jetty 的下载和安装
Jetty 是 Java 领域另一个出色的 Web 服务器,这个服务器同样是开源项目。相对于Tomcat, Jetty 有更大的优点一一可作为一个嵌入式服务器,即如果在应用中加入 Jetty的 Jar文件,则应用可在代码中对外提供 Web 服务。
下面主要介绍 Jetty 的下载、安装和基本配置。
二. Jetty 的下载和安装
Jetty 也是与平台无关的 Java Web 服务器,既可以在 Windows 平台上运行,也可以在 Linux 平台上运行,下载和安装 Jetty 请按如下步骤进行。
(1) 登录 http://jetty.mortbay.comljetty/index.htm1站点,下载 Jetty 的最新版本。笔者成书之时, Jetty 的最新版本是 jetty-6.0.0rcO,下载 jetty-6.0.0rcO且p 文件,该文件是与平台无关的压缩包,不管是 Windows 还是Linux 都可使用该压缩包。
(2) 解压缩jetty-6.0.OrcO.zip 文件,应得到如下的文件结构。
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应用也可自动部署。
(3)将解压缩后的文件放在任意路径即可。运行 Jetty 需要使用如下命令:
建议将上面命令写成脚本,如在Windows下写成批处理命令,Linux下写成一个shell脚本。每次直接运行其脚本文件即可。
运行成功后,启动浏览器并在地址栏输入http://localhost:8080/,然后回车,出现如图1.14 所示的界面,即表示 Jetty 安装成功
498)this.style.width=498;" border=0> |
图1.14Jetty安装成功的界面 |
三. 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 |
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-→ <!-- <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"> <!…设置端口号一〉 <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"><!…三个构造参数…〉 <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.刀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"><!…创建一个Web应用一〉 <New class="org.mortbay.jetty.webapp.WebAppContext"> <1-三个构造参数> <Arg><Ref id="contexts"/></Arg><!…设置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方法…〉 <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> |
java -jar startup.jar etc/jetty.xml etc/jetty-yeeku.xml |
四、 Jetty 的基本配置(2)
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) 增加如下配置文件:
<?xrn1versio口="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="wogg1e"c1ass="org.mortbay.jetty.p1us.naming. EnvEntry"><Arg>wogg1e</Arg> <Argtype="java.1ang.工nteger">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 工d="ds" class="org.apache.commons.dbcp.Bas工cDataSource"> <!设置数据库驱动> <Set name="driverClassName">com.mysql.jdbc.Driver</Set> <!一设置数据库url--> <Set name="url">jdbc:mysql://localhost:3306/j2ee</Set> <1一设置数据库用户名--> <Set name="username">root</Set> <!--设置数据库密码一〉 <Set name="password">32147</Set> <!设置数据库驱动二〉 <Set name="maxActive" type="int">100</Set> <1设置数据源最大空闲连接数> <Set 口ame="maxldle"type="int">30</Set> <!--设置数据源最大的等待数--> <Set 口ame="maxWait"type="int">1000</Set> <1 一设置数据库是否自动提交一〉 <Set 口ame="defaultAutoComm工t"type="boolean">true</Set> <!一设置连接是否自动删除> <Set name="removeAbandoned" type="boolean">true</Set> <!设置数据库驱动> <Set name="removeAbandonedTimeout"type="工nt">60</Set:> <Set name="logAbandoned" type="boolean">true</Set> </New> <1 一将实际的数据源绑定到jdbc/mydatasource这个 JNDI 名…〉 <New 工d="mydatasource"class="org.mortbay.jetty.plus.naming.Resource"> <Arg>jdbc/mydatasource</Arg> <Arg><Ref id="ds"/></Arg></New></Configure> |
public class TestServlet extends HttpServlet 工nitialContextic; //Servlet的初始化方法,该方法完成Context的初始化 public void init(ServletConfig config) throws ServletException super.init(conf工g); try ic = new InitialContext(); catch (Exception e) { throw new ServletException(e); //serv工ce 方法是 Servlet 的服务方法 public void service(HttpServletRequest request, HttpServletResponseresponse) throwsServletException,工OException II获取 JSP 页面输出流 PrintStream out = newPr工ntStream(response.getOutputStream()); try //在控制台输出 w工ggle 的绑定值 System.out.printl口 (ic.lookup("wiggle")); /I:在控制台输出 woggle 的绑定值 System.out.pr工口tl口 (ic.lookup("woggle") ); //获取绑定的数据源 DataSource ds = (DataSource)ic.lookup("jdbc/mydatasource"); //通过数据源获取数据库连接 Co口口ectionconn = ds.getConnection(); //通过数据库连接创建Statement对象 Statement stmt=conn.createStatement(); //通过 Statement对象执行SQL查询,返回ResultSet对象 ResultSet rs = stmt.executeQuery("select* from news"); //遍历记录集 wh工le(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> <J 一定义 Servlet的 url 映射〉 <servlet-name>aa</servlet-name><url-pattern>/aa</url-pattern></servlet-mapping> |