jetty快速入门与嵌入使用 jetty

原文出处：http://blog.chenlb.com/2009/01/quick-start-jetty-and-embed-in-project.html

看到开源项目发布的时候都带一个 jsp 容器(jetty)。拿来做 demo、开发、调试的服务器还是很不错的。今天就小试下，主要把它运行起来。

第一步下载：http://dist.codehaus.org/jetty/jetty-6.1.14/jetty-6.1.14.zip 是目前最新的稳定版。解压到如E:\jetty-6.1.14，其中比较重要的目录是：etc、contexts、webapps。个人认为可以类比tomcat的conf、conf\Catalina\localhost、webapps目录。contexts是热部署用的。

试运行下，可以把一个简单的web项目到到webapps目录下，或是*.war，如：web-demo（或web-demo.war）放到webapps目录下。

E:\jetty-6.1.14>java -jar start.jar
2009-01-13 15:34:38.937::INFO: Logging to STDERR via org.mortbay.log.StdErrLog
2009-01-13 15:34:39.265::INFO: jetty-6.1.14
2009-01-13 15:34:39.421::INFO: Deploy E:\jetty-6.1.14\contexts\javadoc.xml -> org.mortbay.jetty.handler.ContextHandler@15cda3f{/javadoc,file:/E:/jetty-6.1.14/javadoc/}
...
2009-01-13 15:35:01.828::INFO: Opened E:\jetty-6.1.14\logs\2009_01_13.request.log
2009-01-13 15:35:01.953::INFO: Started [email protected]:8080

打开：http://localhost:8080/web-demo ，恩有结果了。

如果不把web-demo放到webapps目录下也可，在contexts目录下建立一个文件告诉jetty就行了。可以在contexts目录下复制test.xml为web-demo.xml，然后修改如下：

<?xml version="1.0" encoding="ISO-8859-1"?>  
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">  
  
<Configure class="org.mortbay.jetty.webapp.WebAppContext">  
  
    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->  
    <!-- Required minimal context configuration : -->  
    <!-- + contextPath -->  
    <!-- + war OR resourceBase -->  
    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->  
    <Set name="contextPath">/web-demo</Set>  
    <Set name="war">e:/workspace/web-demo/WebContent</Set>  
  
    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->  
    <!-- Optional context configuration -->  
    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->  
    <Set name="extractWAR">false</Set>  
    <Set name="copyWebDir">false</Set>  
    <Set name="defaultsDescriptor">  
        <SystemProperty name="jetty.home" default="." />/etc/webdefault.xml</Set>  
    <!--  
        <Set name="overrideDescriptor"><SystemProperty name="jetty.home"  
        default="."/>/contexts/test.d/override-web.xml</Set>  
    -->  
</Configure>

war可以设置成绝对路径。然后再重启jetty试试看。好了， 对jetty的初步认识到这里。

下面再来看下，怎么把它放到项目中。现我有一示例项目 e:/workspace/web-demo（称为project_home），里面的Web根目录是WebContent。

在project_home建一个jetty目录，子目录如：contexts、etc、lib。

把${jetty_home}/etc目录下的jetty.xml、webdefault.xml文件复制到${project_home}/jetty/etc目录中。

把${jetty_home}/lib/jsp-2.1目录复制到${project_home}/jetty/lib目录下（如果不复制jsp-2.1或jsp-2.0也可以正常启动，只是不能解析jsp，打开主页时提示 JSP not support）。

同样把jetty-6.1.14.jar、jetty-util-6.1.14.jar、servlet-api-2.5-6.1.14.jar复制到${project_home}/jetty/lib目录下。

把${jetty_home}/start.jar复制到${project_home}/jetty目录下。

接下来在${project_home}/jetty/contexts目录下加一个文件。可以是上面给出的web-demo.xml。不过war 可以改为

<Set name="war"><SystemProperty name="jetty.home" default="."/>/../WebContent</Set>

注释${project_home}/jetty/etc/jetty.xml文件中的：

<!--  
<Item>  
    <New id="RequestLog" class="org.mortbay.jetty.handler.RequestLogHandler" />  
</Item>  
-->  
<!--  
<Call name="addLifeCycle">  
    <Arg>  
        <New class="org.mortbay.jetty.deployer.WebAppDeployer">  
            <Set name="contexts"><Ref id="Contexts" /></Set>  
            <Set name="webAppDir"><SystemProperty name="jetty.home" default="." />/webapps</Set>  
            <Set name="parentLoaderPriority">false</Set>  
            <Set name="extract">true</Set>  
            <Set name="allowDuplicates">false</Set>  
            <Set name="defaultsDescriptor"><SystemProperty name="jetty.home" default="." />/etc/webdefault.xml</Set>  
        </New>  
    </Arg>  
</Call>  
-->  
<!--  
<Item>  
    <New class="org.mortbay.jetty.security.HashUserRealm">  
        <Set name="name">Test Realm</Set>  
        <Set name="config"><SystemProperty name="jetty.home" default="." />/etc/realm.properties</Set>  
        <Set name="refreshInterval">0</Set>  
    </New>  
</Item>  
-->  
<!--  
<Ref id="RequestLog">  
    <Set name="requestLog">  
        <New id="RequestLogImpl" class="org.mortbay.jetty.NCSARequestLog">  
            <Set name="filename"><SystemProperty name="jetty.logs" default="./logs" />/yyyy_mm_dd.request.log</Set>  
            <Set name="filenameDateFormat">yyyy_MM_dd</Set>  
            <Set name="retainDays">90</Set>  
            <Set name="append">true</Set>  
            <Set name="extended">false</Set>  
            <Set name="logCookies">false</Set>  
            <Set name="LogTimeZone">GMT</Set>  
        </New>  
    </Set>  
</Ref>  
-->

equestLog 是访问记录，不注释也可，前提就是有logs目录。

addLifeCycle 不注释也行，前提是有webapps目录。

Test Realm 不注释也是，前提是etc目录下有realm.properties。

配置好了，现在到E:\workspace\web-demo\jetty，运行java -jar start.jar 可以启动这个项目了。

真正意义的嵌入jetty 请看 http://blog.chenlb.com/2012/05/embed-jetty-http-servlet-jsp.html