在Spring DM中使用Annotations发布和引用OSGi服务

     <p>Spring DM并不是OSGi规范的实现，也就是说它不是OSGi容器。它只是一套用于在 OSGi环境中将Spring Bean注册发布为OSGi服务的工具。它充分利用Spring的特性，将OSGi与Spring无缝的加以结合，实现了Spring的模块化开发。</p>    <p>1．  在使用Spring DM进行开发过程中发现的问题：</p>    <p>虽然Spring DM改进了OSGi原本的DS开发，使用Spring Bean来完成服务的注册。但是对于“懒惰”的程序员来说还是太过繁琐，首先需要在XML中注册SpringBean，然后要使用SpringDM提供的 特殊命名空间（     <!--?xml:namespace prefix = osgi /-->     <osgi:service>      ）发布服务，最后当需要引入一个OSGi服务时又要使用SpringDM提供的另外一个特殊命名 空间（      <osgi:reference>       ）来引入服务。对于一个只有十几个Bean的应用程序来说，这些配置量也无所谓，但是当应用程序的 Bean发展到上百个的时候，这简直就是配置噩梦。尤其是在多人合作开发的环境下，经常会发生遗漏配置的情况，一旦遗漏则OSGi服务将无法启动，并且要 在上百个Bean配置XML文件中查找到底是哪个遗漏了，的确也是一件体力活（这正是IT民工的悲惨命运）。      </osgi:reference>     </osgi:service></p>    <p>当然Spring DM的开发团队也想到了这点，为我们开发人员提供了Annotation的选项，这样可以大大减少XML的配置量（这里我们不争论XML和 Annotation孰优孰劣）。但是不知为何，Spring DM只提供了引入服务的Annotation，并没有提供发布OSGi服务的Annotation，这让我很费解？其次，由于SpringDM是在 JDK1.4环境下编译的，所以默认情况下Annotation的功能是Disabled的。这又让我很费解？到底让我们用不用Annotation！</p>    <p>2．  问题的解决方案：</p>    <p>针对上述的问题，我们可以通过以下方法解决；</p>    <p>1）  如何启用Spring DM的Annotation功能</p>    <p>通过阅读Spring DM提供的官方文档，让我很莫名，关于Annotation的介绍只有寥寥数语，而且还是放在附录中介绍的。可能是我的英文水平太烂，总之一句话，没看 懂！后来从解决其他问题的过程中得到了启示，终于开启了SpringDM的Annotation功能。</p>    <p>第一步，创建一个Fragment类型的Bundle，具体的目录结构如下图所示：</p>    <p><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/324f4fc3d25a9b9aa946a915850ae853.png" width="205" height="172" /></p>    <p>这里主要关注2个文件，一个是extender.xml文件和MANIFEST.MF文件。</p>    <p>第二步，创建extender.xml文件：</p>    <p>在上图所示的目录结构中创建一个extender.xml文件，这个文件用于覆盖SpringDM Extender的配置选项。因为默认情况下是不支持Annotation的，所以要将指定的属性值设置为开启状态，才能使用Annotation功能。 配置文件的内容如下：</p>    <p><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/fb48c5af63b701d061972bac2dd7486b.png" width="655" height="202" /></p>    <p align="left">这个配置文件其实就是一个Spring Bean的配置文件。将process.annotations属性设置成true，就开启了Spring DM的Annotation功能。</p>    <p align="left">第三步，创建MANIFEST.MF文件，这个文件是Bundle的属性配置文件，我们在这个文件中指定Fragment-Host属性，具体内容如下：</p>    <p align="left"><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/f31616c5b278148d81fb8e2418fa0fb7.png" width="663" height="156" /></p>    <p align="left">其中我们要关注的是Fragment-Host属性，这里指定为 org.springframework.osgi.extender，表示在extender Bundle启动之前先启动ftps-extender-config这个Bundle，这样就将默认的属性值更新为我们设置的属性值。</p>    <p align="left">第四步，在Spring的XML配置文件中注册处理Annotation的处理器Bean，如下所示：</p>    <p align="left"><img style="width:716px;height:54px;" alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/bda1f36b4f27fbd67469bfe9e29c8263.png" /></p>    <p align="left">通过上述4个步骤，我们就开启了Spring DM的Annotation功能。</p>    <p align="left">以下例子展示如何使用Spring DM的Annotation功能：</p>    <p align="left"><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/7f2ef2293510859396fe25fa56fc780c.png" width="568" height="225" /></p>    <p align="left">其中@ServiceReference就是引入OSGi服务的Annotation，它等效于XML中的     <osgi:reference>      配置项。     </osgi:reference></p>    <p>2）  编写自己的Annotation实现OSGi服务的发布：</p>    <p>胜利的喜悦还没维持多久，新的问题又随之而来。既然我们已经有引入OSGi服务的Annotation，为什么发布OSGi服务的时候不能使用 Annotation呢？我们仍然在继续编写一大坨苦涩的OSGi配置项，这种工作即枯燥又乏味。但是寻遍SpringDM的所有官方文档，包括 SpringDM提供的Annotation扩展包源代码，都没有找到发布OSGi服务的Annotation。Google一下，大致都是提问的，没有 回答问题的。没有办法，只能靠自己。经过对SpringDM源代码的阅读以及使用BEBUG来查看代码流程的走向，终于了解了SpringDM将 Spring Bean发布为OSGi服务的大致方法。其中最关键的对象就是：OsgiServiceFactoryBean。这个工厂bean就是将 SpringBean发布为OSGi服务的关键类。这个类并不难懂，有兴趣的朋友可以阅读一下这个类的源代码。由于我们是解决问题的文章，不是谈理论的文 章，所以我们继续看实现方案：</p>    <p>首先介绍一下解决方案的大致流程。1）通过编写一个实现了BeanPostProcessor接口的处理器类，我们就可以对Bean的生命周期进行 控制。2）在容器中的某个Bean被初始化之后，我们拦截这个Bean，并获取该Bean上是否写了注册OSGi服务的Annotation。3）如果 是，则实例化OsgiServiceFactoryBean对象，设置相关的属性值，并调用OsgiServiceFactoryBean对象的 afterPropertiesSet方法，进行OSGi服务的注册和发布。最后返回该OsgiServiceFactoryBean对象。同时将该对象 的引用放入一个集合中保存用于OSGi服务的注销。4）当处理器类被销毁时，对集合中的所有OsgiServiceFactoryBean对象执行 destroy方法，完成OSGi服务的注销操作。</p>    <p>先来看Annotation的代码，很简单，如下所示：</p>    <p><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/8bdef4bd59733299ed74ddec832dd51a.png" width="295" height="158" /></p>    <p>ElementType.TYPE指定这个Annotation只能用于类声明，接口声明上。</p>    <p>接着是处理器的实现代码，先关注类签名：</p>    <p><img style="width:709px;height:169px;" alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/9ee0c78db9204dd96a22550646919494.png" /></p>    <p>这里需要关注的是实现的几个接口的用途。实现BundleContextAware接口是为了在处理器中获取Bundle上下文对象。实现 BeanClassLoaderAware接口是为了在处理器中获取ClassLoader对象，这些对象都是注册发布OSGi服务所必须使用的对象。而 继承InstantiationAwareBeanPostProcessorAdapter适配器是为了在Spring Bean初始化完之后给我们一个机会进行定制的特殊处理。我们需要覆盖的是 InstantiationAwareBeanPostProcessorAdapter类的 postProcessAfterInitialization方法。该方法在Spring Bean初始化之后执行。我们来看这个方法的实现，如下所示：</p>    <p><img style="width:678px;height:426px;" alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/1b7e33bb13d44fdb556174d434eda7c5.png" /></p>    <p>代码中的注释已经很好的说明了各逻辑块的实现目的，不再赘述。其中需要关注createExporter方法，这个方法是创建OsgiServiceFactoryBean对象的。如下所示：</p>    <p><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/b726e99b55c9be2364b2d92efc3a0357.png" width="716" height="326" /></p>    <p>代码很简单，就是实例化对象，并调用注册发布OSGi服务的方法。其实发布一个OSGi服务只需要三个参数：Bean名称，Bean对象，Bean实现接口类型的数组，这个和XML中的配置属性一一对应：</p>    <p align="left">     <osgi:service interface="org.storevm.ftps.biz.service.core.SystemConfigureService" ref="systemConfigureServiceBean"></osgi:service></p>    <p>其中ref属性对应Bean名称以及一个Bean对象的引用，interface属性对应Bean实现接口类型的一个数组。</p>    <p>该方法中用到的一些其他实例变量的定义如下：</p>    <p><img style="width:701px;height:451px;" alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/2977b072084d78684c744b0c5aa68738.png" /></p>    <p>最后来看一下OSGi服务的注销实现，代码如下：</p>    <p><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/002e1c9ed437956611223429469d8ba8.png" width="497" height="337" /></p>    <p>注销服务就是将先前注册时保存下来的OsgiServiceFactoryBean对象集合进行destroy方法的调用。</p>    <p>3．  启用发布OSGi服务的Annotation：</p>    <p>相比较开启SpringDM自带的Annotation，我们这个Annotation的启用方法要简单的多。只要在Spring的XML中注册这个处理器Bean就可以了，代码如下：</p>    <p><img style="width:692px;height:44px;" alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/4606a3d117fc6eed8441ddca0e34f76f.png" /></p>    <p>以下实例代码展示了如何使用使用Annotation发布一个OSGi服务发布：</p>    <p><img alt="在Spring DM中使用Annotations发布和引用OSGi服务" src="https://simg.open-open.com/show/6b0b7245a89c4fe7521b229c506f02fe.png" width="636" height="245" /></p>    <p>其中@OsgiService就是注册发布OSGi服务的Anntation。到此我们终于实现了使用Annotation来发布注册OSGi服务 以及引入OSGi服务，我们不再需要在XML中配置那一大坨无聊的OSGi服务配置了。最后引用一句名言：任何发明创造源自于“懒惰”。<br /> <br /> 转自：<a href="/misc/goto?guid=4959500157990579434" target="_blank">CSDN</a>。</p>