eclipse下Jetty Plugin的开发应用

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的下一步开发计划中。
[url]https://bugs.eclipse.org/bugs/show_bug.cgi?id=199748[/url]

而且在实际的开发过程中还发现两个问题：
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应用中去。
~_~