运行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 实例,可以看到配置文件中有如下片段:
1. 配置 Jetty服务端口
Configure元素里的各种子元素,即对该Server实例的操作。在Configure元素下有如下代码所示的 Set 子元素, Set 子元素的 name 属性为 connectors,效果等同于调用setConnectors方法,用于设置Web 服务的提供端口。该方法需要Connector数组,其包含的 Array 子元素则用于设置该方法的参数。Array元素里的Item子元素,则是数组的数据项,每个Connector对应一个连接提供者。
在上面的配置片段中,默认第一个Connector是有效的,该Connector就是常规Web服务的Connector,其中的8080就是Jetty 的默认端口。
笔者将该片段修改如下:
修改成上面所示的样例后,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配置文件的片段如下:
注意:该代码片段在jetty.xml文件仅仅被注释,只要取消该代码片段注释即可。但需要注意: jetty.xml文件默认有个小错误,它的设直超时时长的Set元素的 name属性值为 maxInactivelntervale。实际上HashSessionManager并没有setMaxInactiveIntervale方法,通 过查看API 文档发现,它包含一个setMaxInactiveInterval方法(最后少一个e),读者将原有的e 删除即可。
通常建议增加自己的配置文件,应尽量避免修改系统原有的配置文件。增加的配置文件如下:
将该配置文件保存在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.jarcommons-pool.jarcommons-collections.jar
将这三个文件复制到 Jetty 的 lib 路径下即可, Jetty 启动时会自动加载该路径的jar文件。当然,还需将数据库驱动复制到该路径下。
(2) 增加如下配置文件:
在上面的配置文件中,绑定了三个JNDI值,下面测试该JNDI 的 Servlet:
public class TestServlet extends HttpServletInitialContextic;//Servlet的初始化方法,该方法完成Context的初始化public void init(ServletConfig config) throws ServletExceptionsuper.init(config);tryic = 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 文件中增加如下片段:
启动 Jetty,访问该Servlet,即看到数据库的访问结果。