OSGi应用发布到tomcat

 equinox中的内置的jetty服务器已经很优秀了，但应用可以需要用到已经成熟的技术，需要集成到如tomcat， weblogic等等容器中。（下面以tomcat容器为例， 其他已经包括了OSGi框架的容器可能会更麻烦一点） 

下面按照自己的操作需要注意的关键步骤，记录一下如何把OSGi应用部署到tomcat容器中。

 

1 环境准备(或rap1.5)：

servletbridge相关插件[s1]

• org.eclipse.equinox.http.servletbridge_1.0.300.v20120522-2049.jar
• org.eclipse.equinox.servletbridge.extensionbundle_1.2.100.v20120522-2049
• org.eclipse.equinox.servletbridge_1.2.200.v20120522-2049（需打包成servletbridge.jar）

warproduct相关插件[s2]（0.2.2.201212132117）

• /org.eclipse.libra.warproducts.core
• /org.eclipse.libra.warproducts.ui

2 打包部署到tomcat

1） 集成到tomcat容器中，得去掉就javax.servlet Plugin的依赖。需要修改：插件中对于javax.servlet插件的引用，修改为package的方式添加依赖。

 

2） 在已经可以运行的product的基础上 [s3]，新建warproduct导出为war [r1]。（后面的就不用讲了，和部署其他war是一样的）

• 下载demo.zip，然后导入eclipse
• 打开/sample.server/server-web.product文件，运行"Launch an Eclipse application"
• 新建warproduct，选择"Use a launch configuration"-"server-web.product"(warproduct插件的安装参考[r1]的链接)
• 需要添加servletbridge.jar的library
• 导出成war，然后放置到tomcat/webapp目录下即可。（web.xml & launch.ini会同时导出）

 

3 到底发生了什么

 1、这其中最牛叉的就是servletbridge.jar，其中就三个Java类：

· org/eclipse/equinox/servletbridge/BridgeServlet.java

    接收和转发请求（给真正的Servlet），和插件org.eclipse.equinox.http.servletbridge配合把真正的Servlet（org.eclipse.equinox.http.servlet.HttpServiceServlet）注册到容器（如tomcat）。

    同时管理Framework。
· org/eclipse/equinox/servletbridge/CloseableURLClassLoader.java

    （。。。HARD。。。）
· org/eclipse/equinox/servletbridge/FrameworkLauncher.java

    对插件的部署，启动，extensionbundle的创建/更新

 

2、当然，能让我们的导出工作如此轻松，warproduct居功至伟啊！warproduct是一个精简版的PDE-product的实现，在PDE-product的基础上实现自定义校验和添加了library的功能，以及实现自己的导出功能。（使用Ant导出的文章http://www.ibm.com/developerworks/cn/web/wa-rcprap/index.html

现在的版本都是使用warproduct，找了老久才找到一个老版本的[rold1]），封装了如下的功能：

• 去掉对jetty的依赖
• 同时添加servletbridge相关插件和jar的校验
• 过滤javax.servlet插件依赖错误的提示。

  public static final String SERVLET_BRIDGE_ID 
    = "org.eclipse.equinox.servletbridge"; //$NON-NLS-1$

  public static final String[] BANNED_BUNDLES = new String[] { 
    "javax.servlet", //$NON-NLS-1$
    "org.eclipse.update.configurator",  //$NON-NLS-1$
    "org.eclipse.equinox.http.jetty",  //$NON-NLS-1$
    "org.mortbay.jetty.server",  //$NON-NLS-1$
    "org.mortbay.jetty.util"  //$NON-NLS-1$
  };

  public static final String[] REQUIRED_BUNDLES = new String[] { 
    "org.eclipse.equinox.servletbridge.extensionbundle", //$NON-NLS-1$
    "org.eclipse.equinox.http.registry", //$NON-NLS-1$
    "org.eclipse.equinox.registry", //$NON-NLS-1$
    "org.eclipse.equinox.http.servlet", //$NON-NLS-1$
    "org.eclipse.equinox.http.servletbridge" //$NON-NLS-1$
  };

  + org.eclipse.equinox.http.servletbridge [s1] + tomcat 的功能相当于org.eclipse.equinox.http.jetty

 

源码Source

s1： equinox source

http://git.eclipse.org/c/equinox/rt.equinox.bundles.git/

s2： warproducts demo

https://github.com/hstaudacher/org.eclipse.rap.build.examples/tree/master/warproducts

s3： example

http://winse.iteye.com/blog/1601916 

 

参考：

r1： RAP/Equinox WAR products

http://wiki.eclipse.org/RAP/Equinox_WAR_products

http://download.eclipsesource.com/~hstaudacher/warproducts/3.7

http://eclipse.org/rap/developers-guide/devguide.php?topic=advanced/deployment.html&version=1.5

 

http://eclipsesource.com/blogs/2011/02/02/equinoxrap-war-products-has-moved-hello-eclipse-libra/

http://eclipsesource.com/blogs/2011/02/07/how-to-build-a-server-side-equinoxrap-application/

http://eclipsesource.com/blogs/2009/08/15/building-your-equinox-based-appserver-part-1/

 

rold1： webappbuilder

http://eclipsesource.com/blogs/2007/12/07/rap-deployment-part-2-deploying-your-application-as-a-war-file/

http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.rap.help/help/html/advanced/deployment.html

写道

the script/webappBuilder.xml of the org.eclipse.rap.demo.feature.

 

r2：  Equinox in a Servlet Container

http://www.eclipse.org/equinox/server/

http://www.eclipse.org/equinox/server/http_in_container.php