开发一个简单的 OSGi Web 应用实例
一个简单的 Web 应用
我们写一个简单的 Web 应用 compute.html ：计算两个数字的和或乘积。如下图所示：
图 1. 一个简单例子 
一个简单例子.bmp
为了体现 OSGi bundle 的动态部署能力，我们写两个 service bundle，其中一个计算两个数字的和（称为 add bundle），另外一个计算两个数字的积（称为 multiply bundle）。 当我们点击“Compute”按钮的时候，如果此时 add bundle 被部署，则页面将返回两个数字的和，否则如果此时 multiply bundle 被部署，则页面将返回两个数字的积。
1. 下载 Eclipse 3.4
2. 获取所有 OSGi, Equinox 和 Spring 的插件, 如下图所示:
图 2. 相关插件列表 
1. 打开 Eclipse, 设置 target platform 为上述插件集合
该应用主要包含两个层次: 服务层和 Web 层。Web 层基于 Spring-MVC 实现，包含处理 Web访问相关的 bundle（本例中只有一个）。服务层包含处理数字计算的 bundle，本例中包含一个声明服务接口的 compute interface bundle 和两个实现该服务接口的 bundle ：add bundle 和 multiply bundle。基本模块结构如下图所示：
图 3. 基本框架 
Step 1 ：实现 Service Layer
服务层的三个 OSGi bundle 实现完毕之后如下图所示 ：
服务层.bmp
其中 com.zxn.example.service.compute 是声明服务接口的 bundle。com.zxn.example.service.compute.add和com.zxn.example.service.compute.multiply 是实现了服务接口的两个 bundle。
1. com.zxn.example.service.compute
声明一个 Compute 接口，其中包含一个接口方法 computeNums（），如下图所示 ：
图 5. 服务层接口 bundle 
1. com.zxn.example.service.compute.add
bundle com.zxn.example.service.compute.add 的基本程序结构如下图所示：
图 6. 接口实现 bundle ：add 
在该 add bundle 中，添加一个 Add 类，实现 Compute 接口，如下图所示：
图 7. 接口实现代码 ：Add 类 
注意到我们在 META-INF 下建了一个 spring 目录，并且添加了一个 computeAdd-context.xml 文件。系统启动时，Spring 将利用该 xml 文件创建一个 bean 实例，并把该 bean 输出为一个 OSGi service，如下图所示 ：
图 8. Spring 声明文件 ：computeAdd-context.xml 
该xml文件中，osgi : service是 Spring-DM 输出 OSGi service 的标记，其中的 interface属性标明了该 service 实现的服务接口。
1. com.zxn.example.service.compute.multiply
按照与 add bundle 同样的方法，实现 multiply bundle，如下图所示：
图 9. 接口实现代码：Multiply 类 
接口实现代码-Multiply类.bmp
类似的，添加一个 computeMultiply-context.xml 输出 OSGi service，如下图所示 ：
图 10. Spring 声明文件：computeMultiply-context.xml 
Step 2 ：实现 Web Layer
Web 层只包含一个 bundle：com.zxn.example.web，采用 Spring-MVC 和 OSGi 构建，基本程序结构如下图所示：
1. ComputeControler.java
该JAVA类实现了 org.springframework.web.servlet.mvc.Controller，是本 web应用中核心的 servlet，负责接受并处理 web 请求。该类调用 ComputeServiceRef 的方法实现业务逻辑。该类关键的方法是 handleRequest(…), 如下图所示 ：
图 12. 核心 servlet 类 
1. ComputeServiceRef.java
该 JAVA 类负责引用部署的 service bundle 完成最终计算，其中的 computeService 由 Spring 根据 OSGi 中实际部署的 service 进行注入。本例中，实际部署的 service 可能是 add bundle 或者 multiply bundle。
需要特别注意的是，此处体现了 Spring-DM 的动态特性。OSGi 的动态部署能力使得 Spring 的动态服务注入成为可能。
图 13. 服务消费类 
1. HTTPContextResgistry.java
该 JAVA 类负责在 OSGi 环境中配置和注册 HTTP 服务，其关键方法为 bean 初始化时调用的 init( ) 方法。
图 14. 在 OSGi 环境中注册 HTTP 服务 
该 init 方法中，第六行的 getHTTPService(…) 调用 OSGi 的 ServiceTracker 来获取 OSGi环境中注册的 HTTP 服务的引用，如下图所示：
图 15. 使用 ServiceTracker 获取 HTTP 服务 
1. computeWeb-context.xml
该 xml 文件主要用于配置 HTTPContextResgistry bean 类，以及导入对 Compute 服务接口的引用。标记 osgi : reference 用于声明要导入的服务接口，其 interface 属性标明了该接口的定义，本例中为 com.zxn.example.service.compute.Compute 接口。
图 16. Spring 声明文件：导入服务接口 
1. computeWeb-Dispatcher.xml
该 xml 文件用于配置 ComputeControler bean类。
图 17. Spring 声明文件：配置核心 servlet 类 
以往开发 J2EE 应用通常需要将应用服务器的 runtime 集成到开发环境中才能进行程序调试，非常麻烦。基于 OSGi 的应用完全可以脱离应用服务器运行，这使得程序开发和调试变得非常容易，直接在 Eclipse 中调试运行就可以。我们在 Eclipse 中将程序运行起来，如下图所示：
图18. 运行 OSGi 程序 
从上图中看到，我们同时选择部署了 add bundle 和 multiply bundle，利用 OSGi console 察看如下：
图 19. 察看部署的 OSGi bundle 
当 OSGi 环境中同时部署有多个服务接口的实现 bundle 时，OSGi 会选择一个默认的 bundle提供服务。本例中，Spring 会默认注入 add bundle。我们通过 web 访问 compute.html 页面：
图 20. 访问页面 
点 Compute 按钮之后，结果页面如下：
图 21. 访问结果 
可以看出，是 add bundle 提供了计算服务。下面我们通过命令 ＜stop 76＞ 来停止 add bundle的服务：
图 22. 停止 add bundle 
图 23. add bundle 状态变为 RESOLVED 
重新访问 compute.html 页面，结果得到的是两个数字的乘积。可以看出，是 multiply bundl
提供了计算服务。如下图所示：
图 24. 再次访问页面 
作为当前颇具生命力的两个标准和框架，OSGi 和 Spring 已经初步融合在一起。二者的结合，为开发企业级的 Web 应用同时提供了巨大的灵活性和动态部署能力。本文通过一个简单的例子，描述如何开发一个基于 OSGi 和 Spring 的 Web 应用，并说明了开发过程中涉及到的技术关键点。
- 有关 Spring 和 OSGi 关联信息，请参考 Spring-OSGi 官方网站。
- 有光 OSGi 联盟和技术规范，请参考 OSGi Alliance。
- 有关 Eclipse 对 OSGi 的实现，请参考 Equinox 官方网站。
- 通过查阅 IBM developerWorks 的 Eclipse 项目资源，提高 Eclipse 技能。
- 访问 developerWorks Open source 专区，这里有丰富的 how-to 信息、工具和项目更新，可以帮助您利用开放源码技术进行开发并将其用于 IBM 产品。