OSGi使用发布到tomcat

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的方式添加依赖。
OSGi使用发布到tomcat
 

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会同时导出)

OSGi使用发布到tomcat
 

II 到底发生了什么

 1 这其中最牛叉的就是servletbridge.jar,其中就三个主类:

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