【51CTO精选译文】本文是《你好，OSGi》系列的***一篇，讲述在Eclipse外部如何执行OSGi容器。在Eclipse IDE内部执行Equinox OSGi容器对于开发非常便利。不过，当你的应用程序准备好部署，如果你想要在Eclipse外部执行你的OSGi容器，可以按照下面的步骤从命令行运行你的Equinox OSGi容器。

51CTO编辑推荐：OSGi入门与实践全攻略

从Equinox下载完整的eclipse-equinox-.zip 二进制文件框架。本文中的示例代码在版本3.3下进行测试。

解压缩下载的文件，保存到你的计算机上。本示例将使用目录 C:\software。

在你的计算机上建立一个目录，命名为 C:\equinox （或对于你的操作系统等同的目录）。

从 C:\software 将下面的JAR文件复制到 C:\equinox：

org.eclipse.osgi_.jar  
javax.servlet v2_4.jar  
org.apache.commons.logging v1_0_4.jar  
org.eclipse.equinox.http.jetty.jar  
org.eclipse.equinox.http.registry.jar  
org.eclipse.equinox.http.servlet.jar  
org.mortbay.jetty v5_1_11.jar  
org.eclipse.equinox.common_.jar  
org.eclipse.equinox.registry_.jar  
org.eclipse.osgi.services_.jar 

现在，打开命令控制台，将目录更改到 C:\equinox，然后执行下面的目录：

java -jar org.eclipse.osgi_.jar -console 

Equinox OSGi容器将启动，并且你将会看到OSGi>提示符。

安装、验证和执行插件

需要指出的是，虽然你已经将所有的插件 JAR 文件复制到了 C:\equinox 目录，但所有这些插件还没有安装到OSGi容器。你必须一个一个地进行安置。可以通过下面的命令语句在OSGi容器中安装插件：

install file: 

例如，如果你想要安装javax_servlet v2_4 插件，那么你应该执行下面的这行命令：

install file:javax.servlet_2.4.jar 

现在，使用install 命令安装所有必须的插件。

在你的全部插件都安装完毕后，你可以通过执行ss命令来它们进行验证。OSGi容器将显示一个包含三个列的表格列出所有的已安装插件：***列显示插件的ID，第二列显示插件的状态，第三列显示套件的名称。

请注意，所有套件都处于INSTALLED状态，除了INSTALLED套件，它处于ACTIVE状态。因此，你下一步需要做的是启动所有插件。可以通过下面的命令启动插件：

start  

在本例中，javax.servlet v2_4套件的ID是1，所以你可以这样来启动它：

start 1 

所有插件都启动之后，你可以通过调用ss命令来对他们进行验证。在你的OSGi控制台上显示的内容应类似于图 2 所示。

 
图 2. Jetty 控制台

***，你可以通过在浏览器中输入 http://localhost/helloworld.html 来测试你的OSGi Web应用程序是否正确配置。你应该可以看到消息“Hello from helloworld.html”。

将OSGi容器嵌入到servlet容器

在这个小节，我们将来看看OSGi Web应用程序的另一种部署方式，它将Equinox OSGi容器嵌入到一个Web应用程序中，然后在servlet容器（如Apache Tomcat）中部署该Web应用程序。Equinox框架提供bridge.war，一个模板，具有Equinox OSGi容器的Web应用程序将这个模板嵌入到容器中。

bridge.war应用程序包含org.eclipse.equinox.servletbridge.BridgeServlet。这个servlet负责对你的OSGi容器进行初始化。每当接收到一个客户请求，它将查看是否存在一个OSGi插件可以处理该请求；如果存在，它将控制转发至该插件。下面的步骤向你演示了如何使用bridge.war中的com.javaworld.sample.osgi.web.programmatic和com.javaworld.sample.osgi.web.declarative插件。

如果你还没有安装Apache Tomcat，请下载Apache Tomcat 5.5并将其解压到操作系统文件夹 C:\software（或相应的同等文件夹）。

下载bridge.war，然后将其安装到你的Apache Tomcat服务器。一旦安装完成，启动bridge.war Web应用程序。

通过在浏览器中访问http://localhost:8080/bridge/sp_test来测试Bridge Web应用程序。你应看到一条消息：“Servlet delegate registered - org.eclipse.equinox.http.servlet.HttpServiceServlet”。

现在，返回到你的Eclipse IDE。在包资源浏览器试图中，右键单击并选择 Export > Deployable plug-ins and fragments，然后单击下一步按钮。在Deployable Plug-ins and fragments对话框中，输入如图 3所示的值。

 
图 3. 导出插件

单击“完成”，Eclipse 将com.javaworld.sample.osgi.web.declarative.jar 和 com.javaworld.sample.osgi.web.programmatic.jar导出到 C:\software\apache-tomcat-5.5.25\webapps\bridge\WEB-INF\eclipse\plugins 文件夹（或你所用操作系统的同等文件夹）。请注意，Bridge Web应用程序将 C:\software\apache-tomcat-5.5.25\webapps\bridge\WEB-INF\ 文件夹中的内容复制到Tomcat 工作目录并从那里执行。当你网址：http://localhost:8080/bridge/sp_deploy 时，Bridge Web 应用程序将这些新的 JAR 文件复制到 C:\software\apache-tomcat-5.5.25\work\Catalina\localhost\bridge\eclipse \plugins。

现在，重启你的Tomcat服务器。一旦Tomcat重启完成，你将可以看到Tomcat控制台中的 osgi> 提示符。

输入ss来显示所有已安装到bridge.war中的OSGi套件。确认com.javaworld.sample.osgi.web.declarative和com.javaworld.sample.osgi.web.programmatic已安装到 OSGi容器；如果没有安装，可通过执行 install file:  命令进行安装。

在 OSGi命令提示符下，执行 start 命令，启动 com.javaworld.sample.osgi.web.declarative.jar 和 com.javaworld.sample.osgi.web.programmatic.jar 插件。

现在，你应该能够在浏览器中输入 http://localhost:8080/bridge/helloworld.html 来访问 helloworld.html 了。

探索该应用程序

这个Bridge应用程序提供了以下URL，利用它们，你可以从网络浏览器来控制你的OSGi容器。（对于该示例，这些地址应加在 http://localhost:8080/bridge/ 后面；该URL可能会有所变化，要看你的Tomcat安装情况。）

sp_deploy：复制平台内容到工作或临时目录  
sp_undeploy：工作目录删除 Eclipse 的副本  
sp_redeploy：对平台进行重置（比如：终止、取消部署、部署以及启动）  
sp_start：启动一个已部署平台  
sp_stop：终止平台  
sp_test：提供一个正常的检测，并且当基于 OSGi 的servlet 已准备好接收请求时终止 

继续研究探索这个应用程序吧，别忘了给自己一个鼓励：你已经开发出了你的***个OSGi Web应用程序！

总结

虽然OSGi的来源在于提供嵌入式和客户端解决方案，但很多人认为，它的强项将在于服务器端的开发。服务器端Equinox是一个开始，利用它，可以更加简便地将OSGi的可插入、基于组件的开发模式应用到Web应用程序。（另一个是SpringSource应用程序平台， 但不在本文讲解的范围之内。）通过这篇文章中的示例，你已经向OSGi Web应用程序开发迈出了***步。你已经在Eclipse中设置了OSGi Web应用程序开发环境；学习了注册OSGi套件的两种方式：程序方式和声明方式；以及，详细了解了如何使用这两种不同的方式对基于OSGi的Web应用程序进行部署：将Jetty servlet容器插件嵌入到 Equinox，并将Equinox嵌入到Tomcat。

在这个系列文章中，你学习如何开始创建基于OSGi的应用程序，学习了OSGi开发模式以及创建了一个简单的包含两个套件的客户-服务器（client-server）应用程序。你还学习了Spring动态模型如何简化了OSGi容器中Spring应用程序的开发，以及服务器端Equinox如何提供了一个可访问的框架以在服务器环境中开发和部署OSGi应用程序。

所有这些实践练习为你打开了OSGi开发之门，希望这个系列的文章能够帮助你更好地理解OSGi和Java的模块化，以及将它应用到你的未来Java开发项目中。

【编辑推荐】

1. 你好，OSGi！OSGi入门必读系列
2. 打造一个Hello World OSGiWeb应用程序
3. 初探OSGiWeb应用开发利器Equinox：环境设置
4. OSGi和Spring入门：什么是Spring动态模型(Spring DM)？
5. OSGi是什么：Java语言的动态模块系统