eclipse下Jetty Plugin的开发应用

vivion32

Jetty做为一个轻量级的J2EE Web application server，它不仅小巧，而且性能也比较稳定，效率也挺高，现在也越来越得到广泛的应用。特别是eclipse平台集成了Jetty Plugin后，更是对RCP整合Web Server开发提供了极大的方便。一个非常典型的应用应该就是help帮助系统了，大家可以参看eclipse自已的help系统，从3.3后它就是基于Jetty的，现在的Jetty版本是5.1。
在这里不得不先叉开一个话题，就是servlet-bridge桥的概念。Jetty只是一个单纯的web server服务器，eclipse为了整合框架的考虑，提出了servlet-bridge的概念，对Jetty进行了封装，提供了基于Extension point的servlet注册机制。用户只需要在plugin.xml文件中对相应的Extension point进行扩展，就可以很方便将一个servlet注册到web server上。也就是说，标准的J2EE应用，我们需要一个web.xml文件对所有的servlet，context-param等等进行配置说明；现在这些都基于eclipse http registry所提供的Extension point进行注册，不再需要web.xml文件。
下面，我们看一个plugin.xml的例子。
<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.0"?>
<plugin>
   <extension
         point="org.eclipse.equinox.http.registry.httpcontexts">
      <httpcontext
            id="myapp">            
         <resource-mapping
               path="/myapp">
         </resource-mapping>
      </httpcontext>
   </extension>
   <extension
         point="org.eclipse.equinox.http.registry.resources">
      <resource
            alias="/"
            base-name="/"
            httpcontextId="myapp">
      </resource>
      <serviceSelector
            filter="(other.info=org.myapp.jetty.demo)">
      </serviceSelector>
   </extension>
   <extension
         point="org.eclipse.equinox.http.registry.servlets">
      <servlet
         alias="/myfirstservlet"
         class="org.myapp.jetty.demo.servlet.MyFirstServlet"
         httpcontextId="myapp"
         load-on-startup="true">         
      </servlet>
      <servlet
            alias="/*.jsp"
            class="org.eclipse.equinox.jsp.jasper.registry.JSPFactory:/"
            httpcontextId="myapp">
      </servlet>
      <serviceSelector
            filter="(other.info=org.myapp.jetty.demo)">
      </serviceSelector>
   </extension>
</plugin>
这个文件不算复杂，简单解释一下：
1) Extension point - "org.eclipse.equinox.http.registry.httpcontexts"
   这个类似于ServletContext，一般一个web application指定一个，ID是唯一的。 resource-mapping可以指定资源根目录。
2) Extension point - "org.eclipse.equinox.http.registry.resources"
   是资源目录和httpcontext间的影射关系。
3) Extension point - "org.eclipse.equinox.http.registry.servlets"
   这个很关键，就是用这个来注册servlet的。
   其中有两个地方要注意，
　 <servlet alias="/*.jsp"　class="org.eclipse.equinox.jsp.jasper.registry.JSPFactory:/"　httpcontextId="myapp"></servlet>
   这个是注册所有jsp的mapping，一定要写。
   <serviceSelector
            filter="(other.info=org.myapp.jetty.demo)">
  </serviceSelector>
  这一段最好也要保留，不然要多个web app的情况下，可能会产生冲突。
有什么不情楚的，大家可以查看eclipse的帮助。
很可惜，eclipse基本上只提供了这几个Extension point，现在只提供对servlet的支持，暂时还无法支持context-param, filter, listener等等其它的元素。
已经有相应的bug，但似乎不在eclipse的下一步开发计划中。
https://bugs.eclipse.org/bugs/show_bug.cgi?id=199748
而且在实际的开发过程中还发现两个问题：
1) 当调用ServletContext.getRealPath方法获取绝对路径时，返回NULL值。
2) 当在JSP中调用request.getServletPath方法，也是返回NULL值。
所以需要找到别的方法去处理。
在Jetty Server上启动一个Web application，代码非常简单：

Dictionary dict = new Hashtable( );
// configure the port
dict.put( "http.port", port ); //$NON-NLS-1$
// configure the host
dict.put( "http.host", host ); //$NON-NLS-1$
// set the base URL
dict.put( "context.path", "/" + webappName ); //$NON-NLS-1$ //$NON-NLS-2$
dict.put( "other.info", pluginID ); //$NON-NLS-1$
// Startup Jetty web server
JettyConfigurator.startServer( webappName, dict );
ensureBundleStarted( "org.eclipse.equinox.http.registry" ); //$NON-NLS-1$


停止一个Web application，一句代码就够了：
JettyConfigurator.stopServer( webappName );

附件中是我写的一个示例plugin，包含了所有基本的功能。包括启动/停止一个web application，注册servlet，JSP文件示例等等。
大家可以很方便的应用到自已开发的RCP应用中去。
~_~