BlogJava-xylz,imxylz-随笔分类-Jettyhttp://www.blogjava.net/xylz/category/50688.html关注后端架构、中间件、分布式和高性能RESTful服务zh-cnThu, 12 Apr 2012 03:44:20 GMTThu, 12 Apr 2012 03:44:20 GMT60[深入浅出Jetty 05] Jetty 模块化http://www.blogjava.net/xylz/archive/2012/04/12/372999.htmlimxylzimxylzThu, 12 Apr 2012 01:39:00 GMThttp://www.blogjava.net/xylz/archive/2012/04/12/372999.htmlhttp://www.blogjava.net/xylz/comments/372999.htmlhttp://www.blogjava.net/xylz/archive/2012/04/12/372999.html#Feedback0http://www.blogjava.net/xylz/comments/commentRss/372999.htmlhttp://www.blogjava.net/xylz/services/trackbacks/372999.html

Inside in Jetty 8.x 模块化

Inside in Jetty 8.x带有一个默认的test环境。我们从这个默认的环境入手。

首先，来分析下start.ini里面的配置，这个配置决定启动了哪些模块。 

$ grep -v "#" start.ini|grep -v "^$"
OPTIONS=Server,jsp,jmx,resources,websocket,ext,plus,annotations
etc/jetty.xml
etc/jetty-annotations.xml
etc/jetty-deploy.xml
etc/jetty-webapps.xml
etc/jetty-contexts.xml
etc/jetty-testrealm.xml

利用上节学到的只是，我们先来分析下用到了那些模块。 

java -jar start.jar --list-options

查找Server,jsp,jmx,resources,websocket,ext,plus,annotations这些对应的模块有： 

GLOBAL option (Appended Entries) (*)
-------------------------------------------------------------
 0:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-util-8.1.2.v20120308.jar
 1:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-io-8.1.2.v20120308.jar

Option [Server] (Aggregate)
-------------------------------------------------------------
 0:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-xml-8.1.2.v20120308.jar
 1:  3.0.0.v201112011016 | ${jetty.home}/lib/servlet-api-3.0.jar
 2:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-http-8.1.2.v20120308.jar
 3:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-continuation-8.1.2.v20120308.jar
 4:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-server-8.1.2.v20120308.jar
 5:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-security-8.1.2.v20120308.jar
 6:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-servlet-8.1.2.v20120308.jar
 7:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-webapp-8.1.2.v20120308.jar
 8:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-deploy-8.1.2.v20120308.jar
 9:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-servlets-8.1.2.v20120308.jar

Option [jsp]
-------------------------------------------------------------
 0:  2.2.0.v201108011116 | ${jetty.home}/lib/jsp/com.sun.el-2.2.0.v201108011116.jar
 1:  2.2.0.v201108011116 | ${jetty.home}/lib/jsp/javax.el-2.2.0.v201108011116.jar
 2:  1.2.0.v201105211821 | ${jetty.home}/lib/jsp/javax.servlet.jsp.jstl-1.2.0.v201105211821.jar
 3:  2.2.0.v201112011158 | ${jetty.home}/lib/jsp/javax.servlet.jsp-2.2.0.v201112011158.jar
 4:  2.2.2.v201112011158 | ${jetty.home}/lib/jsp/org.apache.jasper.glassfish-2.2.2.v201112011158.jar
 5:  1.2.0.v201112081803 | ${jetty.home}/lib/jsp/org.apache.taglibs.standard.glassfish-1.2.0.v201112081803.jar
 6: 3.7.0.M20110909-1335 | ${jetty.home}/lib/jsp/org.eclipse.jdt.core-3.7.1.jar

Option [jmx]
-------------------------------------------------------------
 0:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-jmx-8.1.2.v20120308.jar

Option [resources]
-------------------------------------------------------------
 0:                (dir) | ${jetty.home}/resources

Option [websocket]
-------------------------------------------------------------
 0:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-websocket-8.1.2.v20120308.jar

Option [ext]
-------------------------------------------------------------
Empty option, no classpath entries active.

Option [plus]
-------------------------------------------------------------
 0:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-jndi-8.1.2.v20120308.jar
 1:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-plus-8.1.2.v20120308.jar
 2:  1.1.0.v201105071233 | ${jetty.home}/lib/jndi/javax.activation-1.1.0.v201105071233.jar
 3:  1.4.1.v201005082020 | ${jetty.home}/lib/jndi/javax.mail.glassfish-1.4.1.v201005082020.jar

Option [annotations]
-------------------------------------------------------------
 0:      8.1.2.v20120308 | ${jetty.home}/lib/jetty-annotations-8.1.2.v20120308.jar
 1:  1.1.0.v201108011116 | ${jetty.home}/lib/annotations/javax.annotation-1.1.0.v201108011116.jar
 2:  3.1.0.v200803061910 | ${jetty.home}/lib/annotations/org.objectweb.asm-3.1.0.v200803061910.jar

从上一节中我们知道，这些模块相当于将那些组件加入classpath中，jetty在启动时也会装载这些模块。 

$java -jar start.jar --dry-run|awk '{print $4}'|sed 's/:/\n/g'
/opt/apps/jetty8/lib/jetty-xml-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/servlet-api-3.0.jar
/opt/apps/jetty8/lib/jetty-http-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-continuation-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-server-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-security-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-servlet-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-webapp-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-deploy-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-servlets-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-annotations-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/annotations/javax.annotation-1.1.0.v201108011116.jar
/opt/apps/jetty8/lib/annotations/org.objectweb.asm-3.1.0.v200803061910.jar
/opt/apps/jetty8/lib/jetty-jmx-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jsp/com.sun.el-2.2.0.v201108011116.jar
/opt/apps/jetty8/lib/jsp/javax.el-2.2.0.v201108011116.jar
/opt/apps/jetty8/lib/jsp/javax.servlet.jsp.jstl-1.2.0.v201105211821.jar
/opt/apps/jetty8/lib/jsp/javax.servlet.jsp-2.2.0.v201112011158.jar
/opt/apps/jetty8/lib/jsp/org.apache.jasper.glassfish-2.2.2.v201112011158.jar
/opt/apps/jetty8/lib/jsp/org.apache.taglibs.standard.glassfish-1.2.0.v201112081803.jar
/opt/apps/jetty8/lib/jsp/org.eclipse.jdt.core-3.7.1.jar
/opt/apps/jetty8/lib/jetty-jndi-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-plus-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jndi/javax.activation-1.1.0.v201105071233.jar
/opt/apps/jetty8/lib/jndi/javax.mail.glassfish-1.4.1.v201005082020.jar
/opt/apps/jetty8/resources
/opt/apps/jetty8/lib/jetty-websocket-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-util-8.1.2.v20120308.jar
/opt/apps/jetty8/lib/jetty-io-8.1.2.v20120308.jar

在总结下，不同的OPTION决定了启动不同的模块（也就是不同的组件和classpath）。另外，对于start.config里面的不同的OPTION可能有相同的模块依赖。

默认的test.war启动了如下模块：

  • Server: 一个标准的servlet容器
  • jsp: jsp模块
  • jmx: jmx支持
  • resources: 允许从${jetty.home}/resources中读取类资源（实际上是配置log4j.properties)
  • websocket: 支持websocket的例子
  • ext: 由于${jetty.home}/lib/ext目录为空，实际上什么都做。其实此特性是为了装载自定义的组件依赖。
  • plus: 一些扩展支持，从上面classpath中猜测，应该是jndi、java认证以及java mail的组件。
  • annotations: java注解以及字节码的支持。

test.war配置

再来看看加载jetty配置。 test.war模块默认加载了6个配置组件。 

etc/jetty.xml
etc/jetty-annotations.xml
etc/jetty-deploy.xml
etc/jetty-webapps.xml
etc/jetty-contexts.xml
etc/jetty-testrealm.xml

Inside in Jetty.xml

默认的jetty.xml负责配置设置服务器的参数，包括绑定的地址、线程池大小以及一些默认的处理器(Handler）等。 

<Configure id="Server" class="org.eclipse.jetty.server.Server">
    <Set name="ThreadPool">
      <New class="org.eclipse.jetty.util.thread.QueuedThreadPool">
        <Set name="minThreads">10</Set>
        <Set name="maxThreads">200</Set>
        <Set name="detailedDump">false</Set>
      </New>
    </Set>
    <Call name="addConnector">
      <Arg>
          <New class="org.eclipse.jetty.server.nio.SelectChannelConnector">
            <Set name="host"><Property name="Inside in Jetty.host" /></Set>
            <Set name="port"><Property name="Inside in Jetty.port" default="8080"/></Set>
            <Set name="maxIdleTime">300000</Set>
            <Set name="Acceptors">2</Set>
            <Set name="statsOn">false</Set>
            <Set name="confidentialPort">8443</Set>
    <Set name="lowResourcesConnections">20000</Set>
    <Set name="lowResourcesMaxIdleTime">5000</Set>
          </New>
      </Arg>
    </Call>
    <Set name="handler">
      <New id="Handlers" class="org.eclipse.jetty.server.handler.HandlerCollection">
        <Set name="handlers">
         <Array type="org.eclipse.jetty.server.Handler">
           <Item>
             <New id="Contexts" class="org.eclipse.jetty.server.handler.ContextHandlerCollection"/>
           </Item>
           <Item>
             <New id="DefaultHandler" class="org.eclipse.jetty.server.handler.DefaultHandler"/>
           </Item>
         </Array>
        </Set>
      </New>
    </Set>
    <Set name="stopAtShutdown">true</Set>
    <Set name="sendServerVersion">true</Set>
    <Set name="sendDateHeader">true</Set>
    <Set name="gracefulShutdown">1000</Set>
    <Set name="dumpAfterStart">false</Set>
    <Set name="dumpBeforeStop">false</Set>
</Configure>

可以看出默认的线程池大小是最小线程10个，最大线程200个。绑定在所有网卡的8080端口。其它配置以后再分析。

Inside in Jetty-annotation.xml

Inside in Jetty-annotation.xml配置应该是描述支持哪些注解配置方式。 

    <Call name="setAttribute">
      <Arg>org.eclipse.jetty.webapp.configuration</Arg>
      <Arg>
          <Array type="java.lang.String">
               <Item>org.eclipse.jetty.webapp.WebInfConfiguration</Item>
               <Item>org.eclipse.jetty.webapp.WebXmlConfiguration</Item>
               <Item>org.eclipse.jetty.webapp.MetaInfConfiguration</Item>
               <Item>org.eclipse.jetty.webapp.FragmentConfiguration</Item>
               <Item>org.eclipse.jetty.annotations.AnnotationConfiguration</Item>
               <Item>org.eclipse.jetty.webapp.JettyWebXmlConfiguration</Item>
          </Array>
      </Arg>
    </Call>

Inside in Jetty-deploy.xml

Inside in Jetty-deploy.xml配置web发布方式。 

    <Call name="addBean">
      <Arg>
        <New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
          <Set name="contexts">
            <Ref id="Contexts" />
          </Set>
          <Call name="setContextAttribute">
            <Arg>org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern</Arg>
            <Arg>.*/servlet-api-[^/]*\.jar$</Arg>
          </Call>          
        </New>
      </Arg>
    </Call>

事实上这里没有定义要发布的目录或者应用位置，因此jetty-deploy依赖于jetty-contexts.xml或者jetty-webapps.xml。

Inside in Jetty-webapps.xml

Inside in Jetty-webapps.xml定义要发布的内容，通常是要发布应用或者应用的定义。默认是存放于${jetty.home}/webapps下的应用以及${jetty.home}/contexts下的xml定义。 

    <Ref id="DeploymentManager">
          <Call id="webappprovider" name="addAppProvider">
            <Arg>
              <New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
                <Set name="monitoredDirName"><Property name="Inside in Jetty.home" default="." />/webapps</Set>
                <Set name="defaultsDescriptor"><Property name="Inside in Jetty.home" default="."/>/etc/webdefault.xml</Set>
                <Set name="scanInterval">1</Set>
                <Set name="contextXmlDir"><Property name="Inside in Jetty.home" default="." />/contexts</Set>
<Set name="extractWars">true</Set>
              </New>
            </Arg>
          </Call>
    </Ref>

Inside in Jetty-contexts.xml

Inside in Jetty-contexts.xml定义一些预置规则。类似于一些拦截器。例如可以讲某些URI rewrite或者静态资源cache配置等。

这会自动扫描${jetty.home}/contexts下面的xml配置。 

    <Ref id="DeploymentManager">
      <Call name="addAppProvider">
        <Arg>
          <New class="org.eclipse.jetty.deploy.providers.ContextProvider">
            <Set name="monitoredDirName"><Property name="Inside in Jetty.home" default="." />/contexts</Set>
            <Set name="scanInterval">1</Set>
          </New>
        </Arg>
      </Call>
    </Ref>

Inside in Jetty-testrealm.xml

Inside in Jetty-testrealm.xml用于test.war的特定配置，用于配置一些认证信息。 

    <Call name="addBean">
      <Arg>
        <New class="org.eclipse.jetty.security.HashLoginService">
          <Set name="name">Test Realm</Set>
          <Set name="config"><Property name="Inside in Jetty.home" default="."/>/etc/realm.properties</Set>
          <Set name="refreshInterval">0</Set>
        </New>
      </Arg>
    </Call>

test.xml

事实上这么模块的配置都是在<Configure id="Server" class="org.eclipse.jetty.server.Server">节点配置下。 因此可以合并成一个大的xml。这样做的好处是在一个xml包含所有配置，方便灵活定义。当然，坏处就是复用率低。 

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure id="Server" class="org.eclipse.jetty.server.Server">
    <Set name="ThreadPool">
      <!-- Default queued blocking threadpool -->
      <New class="org.eclipse.jetty.util.thread.QueuedThreadPool">
        <Set name="minThreads">10</Set>
        <Set name="maxThreads">200</Set>
        <Set name="detailedDump">false</Set>
      </New>
    </Set>
    <Call name="addConnector">
      <Arg>
          <New class="org.eclipse.jetty.server.nio.SelectChannelConnector">
            <Set name="host"><Property name="Inside in Jetty.host" /></Set>
            <Set name="port"><Property name="Inside in Jetty.port" default="8080"/></Set>
            <Set name="maxIdleTime">300000</Set>
            <Set name="Acceptors">2</Set>
            <Set name="statsOn">false</Set>
            <Set name="confidentialPort">8443</Set>
    <Set name="lowResourcesConnections">20000</Set>
    <Set name="lowResourcesMaxIdleTime">5000</Set>
          </New>
      </Arg>
    </Call>
    <Set name="handler">
      <New id="Handlers" class="org.eclipse.jetty.server.handler.HandlerCollection">
        <Set name="handlers">
         <Array type="org.eclipse.jetty.server.Handler">
           <Item>
             <New id="Contexts" class="org.eclipse.jetty.server.handler.ContextHandlerCollection"/>
           </Item>
           <Item>
             <New id="DefaultHandler" class="org.eclipse.jetty.server.handler.DefaultHandler"/>
           </Item>
         </Array>
        </Set>
      </New>
    </Set>
    <Set name="stopAtShutdown">true</Set>
    <Set name="sendServerVersion">true</Set>
    <Set name="sendDateHeader">true</Set>
    <Set name="gracefulShutdown">1000</Set>
    <Set name="dumpAfterStart">false</Set>
    <Set name="dumpBeforeStop">false</Set>
    <Call name="setAttribute">
      <Arg>org.eclipse.jetty.webapp.configuration</Arg>
      <Arg>
          <Array type="java.lang.String">
<Item>org.eclipse.jetty.webapp.WebInfConfiguration</Item>
<Item>org.eclipse.jetty.webapp.WebXmlConfiguration</Item>
<Item>org.eclipse.jetty.webapp.MetaInfConfiguration</Item>
<Item>org.eclipse.jetty.webapp.FragmentConfiguration</Item>
<Item>org.eclipse.jetty.annotations.AnnotationConfiguration</Item>
<Item>org.eclipse.jetty.webapp.JettyWebXmlConfiguration</Item>
          </Array>
      </Arg>
    </Call>
    <Call name="addBean">
      <Arg>
        <New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
          <Set name="contexts">
            <Ref id="Contexts" />
          </Set>
          <Call name="setContextAttribute">
            <Arg>org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern</Arg>
            <Arg>.*/servlet-api-[^/]*\.jar$</Arg>
          </Call>
        </New>
      </Arg>
    </Call>
    <Ref id="DeploymentManager">
          <Call id="webappprovider" name="addAppProvider">
            <Arg>
              <New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
                <Set name="monitoredDirName"><Property name="Inside in Jetty.home" default="." />/webapps</Set>
                <Set name="defaultsDescriptor"><Property name="Inside in Jetty.home" default="."/>/etc/webdefault.xml</Set>
                <Set name="scanInterval">1</Set>
                <Set name="contextXmlDir"><Property name="Inside in Jetty.home" default="." />/contexts</Set>
<Set name="extractWars">true</Set>
              </New>
            </Arg>
          </Call>
    </Ref>
<Ref id="DeploymentManager">
  <Call name="addAppProvider">
<Arg>
  <New class="org.eclipse.jetty.deploy.providers.ContextProvider">
<Set name="monitoredDirName"><Property name="Inside in Jetty.home" default="." />/contexts</Set>
<Set name="scanInterval">1</Set>
  </New>
</Arg>
  </Call>
</Ref>
<Call name="addBean">
  <Arg>
<New class="org.eclipse.jetty.security.HashLoginService">
  <Set name="name">Test Realm</Set>
  <Set name="config"><Property name="Inside in Jetty.home" default="."/>/etc/realm.properties</Set>
  <Set name="refreshInterval">0</Set>
</New>
  </Arg>
</Call>
</Configure>

我们将test.xml放入etc目录下面。这是保持start.ini文件不存在，也就是不使用start.ini里面的配置。

手动运行它。 

java -jar start.jar OPTIONS=Server,jsp,jmx,resources,websocket,ext,plus,annotations etc/test.xml

这时候的启动就和默认启动是一样的了。

这时候就可以访问了。

Inside in Jetty Statistics

这一部分，我们利用学习到的只是来部署一个Jetty统计模块。

修改设置

将连接计数参数打开： 

    <Call name="addConnector">
      <Arg>
          <New class="org.eclipse.jetty.server.nio.SelectChannelConnector">
            <Set name="host"><Property name="Inside in Jetty.host" /></Set>
            <Set name="port"><Property name="Inside in Jetty.port" default="8080"/></Set>
            <Set name="maxIdleTime">300000</Set>
            <Set name="Acceptors">2</Set>
            <Set name="statsOn">true</Set><!-- modify this -->
          </New>
      </Arg>
    </Call>

设置servlet

为了不影响默认的test.war环境，我们增加一个最简单的WAR环境。

根据前面学到的知识，只需要将war环境放到webapps目录下即可。可以是一个war包，也可以是一个以.war结尾的目录。 

$tree webapps/demo.war/
webapps/demo.war/
`-- WEB-INF
    |-- Inside in Jetty-web.xml
    `-- web.xml
1 directory, 2 files

$cat webapps/demo.war/WEB-INF/jetty-web.xml 

<?xml version="1.0"  encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
  <Set name="contextPath">/demo</Set>
</Configure>

$cat webapps/demo.war/WEB-INF/web.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app 
   xmlns="http://java.sun.com/xml/ns/javaee" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   metadata-complete="false"
   version="3.0"> 
  <display-name>static demo</display-name>
  <servlet>
    <servlet-name>statistic</servlet-name>
    <servlet-class>org.eclipse.jetty.servlet.StatisticsServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
    <init-param>
        <param-name>restrictToLocalhost</param-name><param-value>false</param-value>
    </init-param>
  </servlet>
  <servlet-mapping>
    <servlet-name>statistic</servlet-name>
    <url-pattern>/statistic/*</url-pattern>
  </servlet-mapping>
</web-app>

说明几点：

  • 为了不和test.war的contextPath混淆，这里强制修改为/demo。
  • 增加一个jetty内置的统计servlet(org.eclipse.jetty.servlet.StatisticsServlet)
  • 将servlet的参数restrictToLocalhost修改为false，否则默认情况下只能通过本机访问，不能远程访问

运行demo

保持test.war不变增加一个统计配置。 

$java -jar start.jar etc/jetty-stats.xml

执行效果

使用浏览器访问 

http://127.0.0.1:8080/demo/statistic/

效果如下：

统计结果包含6个部分：

  1. 统计结果收集时间
  2. 请求数详情（当前请求数、最大请求数、总共请求数、请求时间等）
  3. 请求分发详情（和请求数不同的是，这是jetty内部分发请求的数量，包括forward/include等）
  4. 响应状态详情（1xx/2xx/3xx/4xx/5xx以及总共发送的字节数）
  5. 连接数详情 （当前连接数、最大连接数、连接持续时间等）
  6. 内存状况（堆内存和非堆内存使用状况,非堆内存通常也称永久代内存）

小结

Inside in Jetty 8.x已经将各个模块拆分非常详细了。每一个模块的命名都非常有规律。通常从名称上就能够猜测出模块的作用。

部分模块可能还需要对应的配置。${jetty.home}/etc下面有大量的配置，这些零散的配置拆分是为了可复用。 如果一个jetty要想启动多个java进程，那么只需要指定不同的配置即可。甚至为了方便定制化，可能为每一个java进程创建一个完整的jetty.xml配置，而不需要${jetty.home}/etc下面的配置。



imxylz 2012-04-12 09:39 发表评论
]]>[深入浅出Jetty] 文章索引http://www.blogjava.net/xylz/archive/2012/04/12/371612.htmlimxylzimxylzThu, 12 Apr 2012 01:38:00 GMThttp://www.blogjava.net/xylz/archive/2012/04/12/371612.htmlhttp://www.blogjava.net/xylz/comments/371612.htmlhttp://www.blogjava.net/xylz/archive/2012/04/12/371612.html#Feedback0http://www.blogjava.net/xylz/comments/commentRss/371612.htmlhttp://www.blogjava.net/xylz/services/trackbacks/371612.html
  1. [深入浅出Jetty 01] Jetty 8.x 安装
  2. [深入浅出Jetty 02] Jetty 8.x 简单试用
  3. [深入浅出Jetty 03] 简单的RESTful入门
  4. [深入浅出Jetty 04] Jetty的启动方式
  5. [深入浅出Jetty 05] Jetty 模块化


imxylz 2012-04-12 09:38 发表评论
]]>[深入浅出Jetty 04]Jetty的启动方式http://www.blogjava.net/xylz/archive/2012/03/28/372923.htmlimxylzimxylzWed, 28 Mar 2012 11:02:00 GMThttp://www.blogjava.net/xylz/archive/2012/03/28/372923.htmlhttp://www.blogjava.net/xylz/comments/372923.htmlhttp://www.blogjava.net/xylz/archive/2012/03/28/372923.html#Feedback3http://www.blogjava.net/xylz/comments/commentRss/372923.htmlhttp://www.blogjava.net/xylz/services/trackbacks/372923.html
除了极大方便嵌入式启动之外，从程序外部也非常好容易启动jetty。

[原文：http://www.blogjava.net/xylz/archive/2012/03/28/372923.html]

运行方式

运行方法1

首先我们以一个标准的jar程序启动来看待这个问题.
[adyliu@adyliu-pc jetty8]$ cat run.sh 
#!/bin/bash

JETTY_CLASSPATH="./start.jar"
for f in `find ./lib -name "*.jar"`
do
    JETTY_CLASSPATH=$JETTY_CLASSPATH:$f
done

#echo $JETTY_CLASSPATH
java -cp $JETTY_CLASSPATH $*

然后运行查看下
[adyliu@adyliu-pc jetty8]$ sh run.sh org.eclipse.jetty.start.Main
2012-03-28 16:00:57.532:INFO:oejs.Server:jetty-8.1.2.v20120308
2012-03-28 16:00:57.578:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080

由于没有任何web环境，因此此时访问任何地址应该都是404。测试一下：
[adyliu@adyliu-pc jetty8]$ curl -v http://127.0.0.1:8080
* About to connect() to 127.0.0.1 port 8080
*   Trying 127.0.0.1 connected
* Connected to 127.0.0.1 (127.0.0.1) port 8080
> GET / HTTP/1.1
> User-Agent: curl/7.15.5 (x86_64-redhat-linux-gnu) libcurl/7.15.5 OpenSSL/0.9.8b zlib/1.2.3 libidn/0.6.5
> Host: 127.0.0.1:8080
> Accept: */*
> 
< HTTP/1.1 404 Not Found
< Date: Wed, 28 Mar 2012 08:15:27 GMT
< Content-Type: text/html
< Content-Length: 618
< Server: Jetty(8.1.2.v20120308)
<HTML>
<HEAD>
<TITLE>Error 404 - Not Found</TITLE>
<BODY>
<H2>Error 404 - Not Found.</H2>

运行方法2

另外上述运行等价于：
[adyliu@adyliu-pc jetty8]$ sh run.sh org.eclipse.jetty.xml.XmlConfiguration etc/jetty.xml
2012-03-28 16:31:16.481:INFO:oejs.Server:jetty-8.1.2.v20120308
2012-03-28 16:31:16.518:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080

运行方法3

第三种方法就是使用封装好的start.jar，这个jar包封装了一些常规的配置。

在开始之前，我们先重命名下默认的start.ini，因为默认的配置文件会启动一个test.war环境。
mv start.ini start.ini.default
[adyliu@adyliu-pc jetty8]$ java -jar start.jar
2012-03-28 16:35:21.941:INFO:oejs.Server:jetty-8.1.2.v20120308
2012-03-28 16:35:21.992:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080

可以看出这个方式和第一种、第二种完全相同。
另外start.jar提供了一种可以查看当前运行参数的命令：
java -jar start.jar --dry-run

可能输出:
/opt/apps/jdk/bin/java -Djetty.home=/opt/apps/jetty8 -cp /opt/apps/jetty8/resources:\
/opt/apps/jetty8/lib/jetty-xml-8.1.2.v20120308.jar:/opt/apps/jetty8/lib/servlet-api-3.0.jar:\
/opt/apps/jetty8/lib/jetty-http-8.1.2.v20120308.jar:/opt/apps/jetty8/lib/jetty-continuation-8.1.2.v20120308.jar:\
/opt/apps/jetty8/lib/jetty-server-8.1.2.v20120308.jar:/opt/apps/jetty8/lib/jetty-security-8.1.2.v20120308.jar:\
/opt/apps/jetty8/lib/jetty-servlet-8.1.2.v20120308.jar:/opt/apps/jetty8/lib/jetty-webapp-8.1.2.v20120308.jar:\
/opt/apps/jetty8/lib/jetty-deploy-8.1.2.v20120308.jar:/opt/apps/jetty8/lib/jetty-servlets-8.1.2.v20120308.jar:\
/opt/apps/jetty8/lib/jetty-util-8.1.2.v20120308.jar:/opt/apps/jetty8/lib/jetty-io-8.1.2.v20120308.jar \
org.eclipse.jetty.xml.XmlConfiguration /tmp/start1059041541723976621.properties /opt/apps/jetty8/etc/jetty.xml

有意思的是这里有一个临时文件：/tmp/start1059041541723976621.properties，里面记录了所有系统属性，也就是类似System.getProperties()。
除非是嵌入式开发，否则我们都是用start.jar来启动jetty。

命令参数

start.jar提供了大量的参数来负责启动JVM。
下面命令列出所有的命令行参数：
java -jar start.jar --help

现在问题来了，这些默认的参数都是哪来的？例如，如果想改变${jetty.home}又怎样？
jetty内部默认提供了一个默认的配置文件start.config来解决此问题。
默认情况下start.jar里面带有一个默认的start.config文件，这个文件有一些预置的定义。
[adyliu@adyliu-pc jetty8]$ jar tvf start.jar | grep start.config
  8669 Fri Mar 09 00:13:12 CST 2012 org/eclipse/jetty/start/start.config

start.config 文件内容非常大，其中大部分是注释。

start.config的作用有以下几个：

  • 定义jetty.home属性
  • 定义jetty启动类
  • 定义jetty启动的默认配置文件
  • 定义OPTIONS
  • 根据OPTIONS来定义classpath

上面特别提到OPTIONS。什么是OPTIONS？

OPTIONS

由于jetty是高度可定制的，因此jetty将各个模块拆分成各个非常细小的模块。每一个模块（实际上是一个个的jar包），我们可以简单的看出是一个OPTION。而每一个OPTION都会对应于实际的jar，这就决定了这些jar包是否需要加入classpath，并且在jetty启动的时候是否需要做一些额外的事情。

start.config文件的语法也挺有意思的。支持一些简单的逻辑判断，例如文件是否存在、命令行参数是否存在等。

默认情况下有如下配置：

  • path参数的值加入classpath
  • lib参数的值作为目录搜索jar包，其中的jar/zip包加入classpath
  • 默认的启动类是org.eclipse.jetty.xml.XmlConfiguration.class，除非定义了start.class属性
  • 默认的jetty配置文件是$(jetty.home)/etc/jetty.xml，除非传入的参数不为空
  • 默认${jetty.home}目录是当前目录（不一定是start.jar所在路径）。${jetty.home}属性搜索顺序有：
    • $(jetty.home) 参数或者系统属性（包括环境变量）
    • . 当前路径
    • .. 当前路径的父路径
    • jetty-distribution/src/main/resources 当前路径的发行版子路径
    • ../jetty-distribution/src/main/resources 当前路径的父路径的发行版子路径
  • 默认的classpath有：
    • resources
    • lib/jetty-xml-8.1.2.v20120308.jar
    • lib/servlet-api-3.0.jar
    • lib/jetty-http-8.1.2.v20120308.jar
    • lib/jetty-continuation-8.1.2.v20120308.jar
    • lib/jetty-server-8.1.2.v20120308.jar
    • lib/jetty-security-8.1.2.v20120308.jar
    • lib/jetty-servlet-8.1.2.v20120308.jar
    • lib/jetty-webapp-8.1.2.v20120308.jar
    • lib/jetty-deploy-8.1.2.v20120308.jar
    • lib/jetty-servlets-8.1.2.v20120308.jar
    • lib/jetty-util-8.1.2.v20120308.jar
    • lib/jetty-io-8.1.2.v20120308.jar

start.jar参数

我们再来看start.jar支持的参数：

[adyliu@adyliu-pc jetty8]# java -jar start.jar --help
Usage: java -jar start.jar [options] [properties] [configs]

options

其中options列表（这指的是命令行参数，不是模块，由此可见jetty将内置的OPTIONS定义为模块多好）有：

  • --version 列出版本号
  • --list-options 列出当前start.config支持的所有OPTIONS
  • --list-config 列出当前start.config内容（文本内容）
  • --dry-run 列出当前配置要启动的java进程完整参数（不启动jetty服务）
  • --exec 启动子进程（只有启动子进程才能修改-X，-D等参数，因为start.jar本身就是依靠java进程启动的，不能在运行时改变）
  • --stop 停止运行的jetty实例
  • --daemon 后台运行jetty，启动将stdout/stderr记录到${jetty.log}/start.log中（好了，这个变量jetty.log没有默认配置说明，估计是${jetty.home}/logs目录）
  • --config=<file> 指定特别的start.config，以便覆盖内置的start.config.(经过测试，如果指定此文件，那么内置的配置将不再读取，这导致必须将所有配置写全，包括mainclass/jetty config/OPTIONS等）
  • --ini=<file> 从配置文件中装载命令行参数。上面参数以及下面提到的参数是在太多，可以从配置文件中一次性加载，默认的配置文件是${jetty.home}/start.ini。
  • --pre=<file> 指定特别的jetty运行配置文件，这个配置文件在后面提高的配置文件前面运行，相当于改变默认的装载机制。

properties

属性分成两种，一种是会传递给系统属性（java.lang.System#getProperty(String)),一种只是作为jetty的启动参数。

如果要传递给系统属性，则格式是： -Dname=value，和java进程系统属性类似。

jetty也有一些默认的系统属性：

属性类型描述
org.eclipse.jetty.util.log.class class jetty日志记录，默认为：org.eclipse.jetty.util.log.Slf4jLog
org.eclipse.jetty.util.log.DEBUG boolean 调试日志输出地方，默认为stderr和java内置的Logger，如果是其他日志则需要设置为true，默认为false
org.eclipse.jetty.util.log.IGNORED boolean 是否记录一些忽略的错误日志，默认为false
org.eclipse.jetty.util.log.SOURCE boolean 记录错误日志行号？位置？默认为false
com.sun.management.jmxremote   启动jmx管理

jetty的启动参数属性，格式是： name=value，注意这里没有-D了。这些参数不会传递给系统属性。

所有参数列表：

  • path=[directory]: 传递额外的classpath，参考上面默认的start.config配置
  • lib=[directory]: 传递额外classpath搜索jar/zip的目录
  • STOP.PORT=[number]: 停止jetty的端口（远程管理）
  • STOP.KEY=[alphanumeric]: 停止jetty的密码（远程管理）
  • DEBUG=true: 是否启动调试模式，同时会设置org.eclipse.jetty.util.log.DEBUG属性为true，默认为false
  • OPTIONS=[option,option...]: OPTION列表，也就是要启动的模块列表。

在内置的start.config中默认的OPTIONS列表有：

  • All
  • Client
  • Server
  • ajp
  • annotations
  • client
  • default
  • deploy
  • ext
  • jmx
  • jndi
  • jsp
  • jta
  • monitor
  • overlay
  • overlays
  • plus
  • policy
  • resources
  • rewrite
  • security
  • server
  • servlet
  • servlets
  • setuid
  • webapp
  • websocket
  • xml

configs

jetty运行需要一些配置文件，这些配置文件对应于不同的OPTION所需要的配置。

默认的jetty配置存在都存在于${jetty.home}/etc中，所有配置文件列表有：

  • etc/jetty-ajp.xml
  • etc/jetty-annotations.xml
  • etc/jetty-bio-ssl.xml
  • etc/jetty-bio.xml
  • etc/jetty-contexts.xml
  • etc/jetty-debug.xml
  • etc/jetty-deploy.xml
  • etc/jetty-fileserver.xml
  • etc/jetty-ipaccess.xml
  • etc/jetty-jmx.xml
  • etc/jetty-logging.xml
  • etc/jetty-monitor.xml
  • etc/jetty-overlay.xml
  • etc/jetty-plus.xml
  • etc/jetty-policy.xml
  • etc/jetty-proxy.xml
  • etc/jetty-requestlog.xml
  • etc/jetty-rewrite.xml
  • etc/jetty-ssl.xml
  • etc/jetty-stats.xml
  • etc/jetty-testrealm.xml
  • etc/jetty-webapps.xml
  • etc/jetty-xinetd.xml
  • etc/jetty.xml

这么多配置，如何记得住？该使用哪些配置？

下一个章节中介绍配置文件。


参考资源：


imxylz 2012-03-28 19:02 发表评论
]]>[深入浅出Jetty 03]简单的RESTful入门http://www.blogjava.net/xylz/archive/2012/03/09/371598.htmlimxylzimxylzFri, 09 Mar 2012 09:52:00 GMThttp://www.blogjava.net/xylz/archive/2012/03/09/371598.htmlhttp://www.blogjava.net/xylz/comments/371598.htmlhttp://www.blogjava.net/xylz/archive/2012/03/09/371598.html#Feedback0http://www.blogjava.net/xylz/comments/commentRss/371598.htmlhttp://www.blogjava.net/xylz/services/trackbacks/371598.html
项目地址：https://github.com/adyliu/jetty-rest-demo 

文件列表


包含如下文件：

  • git忽略文件
  • README文件
  • pom文件
  • 一个简单的Controller文件
  • 一个log4j的配置文件
  • 一个简单的spring mvc配置
  • 一个简单的web.xml

Maven配置

为了能够方便从jetty:run来启动web容器，使用jetty的maven插件。
需要特别注意的是，从jetty7.5.3开始就必须用maven 3了，以前使用的maven 2不能使用了，就为了这问题，我跟踪了很久，大囧。
这里使用jetty最新的maven插件，同样会启动最新的jetty8.1.1 来测试。
<build>
    <plugins>
        <plugin>
            <groupId>org.mortbay.jetty</groupId>
            <artifactId>jetty-maven-plugin</artifactId>
            <version>8.1.1.v20120215</version>
        </plugin>
    </plugins>
</build>

web.xml

这是一个简单的web.xml配置，主要配置spring servlet。当然这里也辅助配置了一个log4j，方便查看日志输出，不配置也没关系。
另外也没有使用servlet 3.0的配置。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
    version="2.4">
    <display-name>jetty-rest-demo</display-name>
    <context-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>classpath:log4j.properties</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
    </listener>
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
</web-app>

dispatcher-servlet.xml

接下来是spring mvc的配置。
包含三部分：要扫描的住解包，mvc注解驱动以及jsp的渲染映射（其实这个例子中没有用到）。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
            http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.1.xsd
            http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">
    <context:component-scan base-package="info.imxylz.study.jetty.rest" />
    <mvc:annotation-driven />
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <property name="suffix" value=".jsp"></property>
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"></property>
    </bean>
</beans>

Controller

下载开始写第一个Controller，当然这个Controller稍微有一点点别扭。
直接返回字符串，另外将索引页映射到一个字符串上。（也不对中文进行处理）

package info.imxylz.study.jetty.rest.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * a rest demo (spring 3.x)
 * 
 * @author adyliu (imxylz@gmail.com)
 * @since 2012-3-9
 */
@Controller
public class DemoController {

    @ResponseBody
    @RequestMapping("/index/{name}/")
    public String index(@PathVariable("name") String name) {
        return "Welcome, " + name;
    }
    @ResponseBody
    @RequestMapping("")
    public String index() {
        return "This is a rest demo";
    }
}

Access

现在该是打开浏览器显示下了。
http://localhost:8080/index/Ady/
http://localhost:8080/index/Ady%20Liu/
http://localhost:8080/

好了，这算是一个最简单的入门例子了。
下面的参考资源中有git的源码。

Resources



imxylz 2012-03-09 17:52 发表评论
]]>[深入浅出Jetty 02] Jetty 8.x 简单试用http://www.blogjava.net/xylz/archive/2012/01/29/368970.htmlimxylzimxylzSun, 29 Jan 2012 08:41:00 GMThttp://www.blogjava.net/xylz/archive/2012/01/29/368970.htmlhttp://www.blogjava.net/xylz/comments/368970.htmlhttp://www.blogjava.net/xylz/archive/2012/01/29/368970.html#Feedback3http://www.blogjava.net/xylz/comments/commentRss/368970.htmlhttp://www.blogjava.net/xylz/services/trackbacks/368970.htmlJetty 8.x 简单试用

运行

安装好了以后，在jetty的主目录下，运行起来。

java -jar start.jar

如果仔细看的话还有一个start.ini，这是典型的eclipse启动方式。事实上jetty8是按照eclipse的OSGI启动模型来运行的。

远程访问

默认情况下jetty使用8080端口，访问下看看。

http://adyliu-pc:8080

出现了点问题。启动后居然是jetty7后的描述信息。看来jetty8发布的时候比较粗糙，这些细节都没有处理好。事实上，官方站点上的文章都是和jetty7.x有关的，没有更新到8.x版本。

好在有一行提示说，如果要远程访问的话，需要开启一个设置。好吧，按照说明，将默认test.war的远程访问模式打开。 修改文件$JETTY_HOME/contexts/test.d/override-web.xml中的如下部分

  <filter>
    <filter-name>TestFilter</filter-name>
    <filter-class>com.acme.TestFilter</filter-class>
    <init-param>
      <param-name>remote</param-name>
      <param-value>true</param-value>
    </init-param>
  </filter>


这里已经将默认remote的属性值false改为了true。然后再试试。


显然，这样就已经支持远程访问了。

Servlet访问

test.war模块里面有一个dump的Servlet，它可以查看当前请求的Request/Session/Cookie信息。我们简单看一下Request请求。

这里面的信息非常丰富，这为以后调试当前请求信息提供了很方便的样例。

Comet模型

Jetty8.x里面有两种comet模型，一种是常见的长连接(Long Polling), 另一种就是HTML5支持的WebSocket模型。

我们先来简单看一下Long Polling模型。在这种方式下，浏览器定时发起一个长连接，等待服务器返回。一次请求完了以后仍然会发起一个新的请求，总是有一个连接保持双方的通讯。 下图描述了此效果。

而WebSocket模型显然不是所有浏览器都支持的。高版本的Chrome就支持，比如我的chrome 18.0的开发版本就能很好的支持WebSocket。

有意思的是，这里的请求头和响应头有一些特殊的标识。以后涉及到websocket的时候再来研究。

经测试，我机器上的chrome 18.0,firefox 8.0都支持websocket的，而IE9仍然不支持。




imxylz 2012-01-29 16:41 发表评论
]]>[深入浅出Jetty 01] Jetty 8.x 安装http://www.blogjava.net/xylz/archive/2012/01/29/368969.htmlimxylzimxylzSun, 29 Jan 2012 08:34:00 GMThttp://www.blogjava.net/xylz/archive/2012/01/29/368969.htmlhttp://www.blogjava.net/xylz/comments/368969.htmlhttp://www.blogjava.net/xylz/archive/2012/01/29/368969.html#Feedback0http://www.blogjava.net/xylz/comments/commentRss/368969.htmlhttp://www.blogjava.net/xylz/services/trackbacks/368969.htmlJetty从7.x已经迁移到eclipse下了，从eclipse的下载目录开始安装吧。

最新的发布版本是8.1.0.v20120127，我们从这个版本开始。

JETTY_VERSION=8.1.0.v20120127
wget http://download.eclipse.org/jetty/$JETTY_VERSION/dist/jetty-distribution-$JETTY_VERSION.tar.gz
tar xfz jetty-distribution-$JETTY_VERSION.tar.gz
cd jetty-distribution-$JETTY_VERSION
java -jar start.jar

附录



imxylz 2012-01-29 16:34 发表评论
]]>