OSGI入门：Bundles之间的相互依赖性

      在我们上次的课程中，我们学习了如何启动和停止一个bundle，以及它们在框架内是如何相互交互的和它们的生命周期。但是bundle真正为了什么（这样翻译对吗）？

 

      每一个bundle是一个模块，它们允许我们将一个完整的项目切分成管理块，这样可以在OSGi运行的时候，加载进去。问题是无论我们是否喜欢，各个模块 之间总是存在依赖性。在老式的jar文件中，从来没有一种可靠地方式指定依赖与其他jar包（类路径中的条目并不是可靠地表现方式）。然而你永远都不知道 在运行的时候，jar中的代码是正常工作还是抛出异常。

 

      OSGi非常优雅的处理这个问题。而且，它表现的要比它说的更好。所以，让我们赶快去查看代码吧。遗憾的是我们到目前为止一直使用默认的包，但是这样的工 作不会太久，现在我们使用恰当的包开始工作吧！让我们看一段非常简单的JavaBean，你需要将下面的代码拷贝到osgitut/movies文件夹下 的Movie.java中

 package    osgitut.movies;

 public     class    Movie {
      private     final    String title;
      private     final    String director;

      public    Movie(String title, String director) {
          this   .title = title;
          this   .director = director;
     }

      public    String getTitle() {
          return    title;
     }

      public    String getDirector() {
          return    director;
     }
 }

 package  osgitut.movies;

 public   class  Movie {
     private   final  String title;
     private   final  String director;

     public  Movie(String title, String director) {
         this .title = title;
         this .director = director;
     }

     public  String getTitle() {
         return  title;
     }

     public  String getDirector() {
         return  director;
     }
 }

 

      现在，我们要在相同的package中创建一个接口，创建类文件MovieFinder.java，并且把下面的代码拷贝进去。

 package    osgitut.movies;

 public     interface    MovieFinder {
     Movie[] findAll();
 }

 package  osgitut.movies;

 public   interface  MovieFinder {
     Movie[] findAll();
 }

 

      接下来，让我们把这两个文件加入到我们的bundle中。是的，我们的bundle小的可笑，而且几乎一点用都没有。但是到目前为止，它很好。在此之前， 我们需要创建一个manifest文件，因此创建并打开MoviesInterface.mf并且将下面的代码拷贝进去。

 Manifest-Version:  1.0
 Bundle-ManifestVersion:  2
 Bundle-Name: Movies Interface
 Bundle-SymbolicName: MoviesInterface
 Bundle-Version:  1.0  . 0
 Export-Package: osgitut.movies;version= "1.0.0"

 Manifest-Version:  1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: Movies Interface
 Bundle-SymbolicName: MoviesInterface
 Bundle-Version: 1.0 . 0
 Export-Package: osgitut.movies;version="1.0.0"

 

        这里有一行新的内容，我们以前没有看到过的：Export-Package。简单的说，这个包，osgitut.movies被从bundle中导出。但 是，你以前是否想到过要将某个package中的代码只在你的jar包中可见呢？当然，你可以使用一些私有的类或者受保护的类去实现。但是他们对jar中 的其他package同样是不可见的。因此OSGi有效的提供了新的代码保护层次：如果一个在你的bundle中，某些package没有加上 Export-Package的标注，那么它仅仅在你的模块里可见。

 

      你可能注意到了在导出的package后面跟着一个版本号。在以后看来，这是很重要的。这里完全没有必要提供一个版本号，顺便说一下，如果你不自己动手的 话，OSGi将自动的给你的package添加一个版本号“0.0.0”。我想实际运用中最好明确的添加一个版本号，便于以后识别。

 

      现在，让我们创建这个bundle：

 > javac osgitut/movies/Movie.java osgitut/movies/MovieFinder.java
 > jar -cfm MoviesInterface.jar MoviesInterface.mf osgitut/movies/*.class

 > javac osgitut/movies/Movie.java osgitut/movies/MovieFinder.java
 > jar -cfm MoviesInterface.jar MoviesInterface.mf osgitut/movies/*.class

 

      我们不要马上去安装这个bundle，也不要马上进行测试。我们还需要创建另外一个bundle，一个依赖于它的bundle。我们要创建一个具体的类去 实现MovieFinder接口，因此，将下面的代码拷贝到osgitut/movies/impl /BasicMovieFinderImpl.java中。

 package    osgitut.movies.impl;

 import    osgitut.movies.*;

 public     class    BasicMovieFinderImpl  implements    MovieFinder {
      private     static     final    Movie[] MOVIES =  new    Movie[] {
              new    Movie( "The Godfather"  ,  "Francis Ford Coppola"  ),
              new    Movie( "Spirited Away"  ,  "Hayao Miyazaki"  ) };

      public    Movie[] findAll() {
          return    MOVIES;
     }
 }

 package  osgitut.movies.impl;

 import  osgitut.movies.*;

 public   class  BasicMovieFinderImpl  implements  MovieFinder {
     private   static   final  Movie[] MOVIES =  new  Movie[] {
             new  Movie( "The Godfather" ,  "Francis Ford Coppola" ),
             new  Movie( "Spirited Away" ,  "Hayao Miyazaki" ) };

     public  Movie[] findAll() {
         return  MOVIES;
     }
 }

 

       我们同样需要创建一个manifest文件，所以创建BasicMovieFinder.mf

 Manifest-Version:  1.0
 Bundle-ManifestVersion:  2
 Bundle-Name: Basic Movie Finder
 Bundle-SymbolicName: BasicMovieFinder
 Bundle-Version:  1.0  . 0
 Import-Package: osgitut.movies;version= "[1.0.0,2.0.0)"

 Manifest-Version:  1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: Basic Movie Finder
 Bundle-SymbolicName: BasicMovieFinder
 Bundle-Version: 1.0 . 0
 Import-Package: osgitut.movies;version="[1.0.0,2.0.0)"

 

      注意到了吗？我们从哪个Export-package的bundle中将导出的package又导入了osgitut.movies包。同时，我们在 Import-package中也添加了版本标记。框架在运行的时候使用这些标记去匹配导出的和导入的package。OSGi使用版本范围的方式区分了 jar包中导出的部分和独有的部分，最有效的方式是我们动手指定版本号。

 

      再次声明：添加一个版本号，并不是十分必要的。它仅仅是一个比较好的习惯！

 

      现在，让我们根据下面的代码来编译并且建立今天的第二个bundle。

 > javac -classpath MoviesInterface.jar osgitut/movies/impl/BasicMovieFinderImpl.java
 > jar -cfm BasicMovieFinder.jar BasicMovieFinder.mf osgitut/movies/impl/*.class

 > javac -classpath MoviesInterface.jar osgitut/movies/impl/BasicMovieFinderImpl.java
 > jar -cfm BasicMovieFinder.jar BasicMovieFinder.mf osgitut/movies/impl/*.class

 

      最后，我们在Equinox中测试这些bundle。这次，我将给出完整的介绍。而且，我想你们已经准备好了。首先安装BasicMovieFinder的bundle，并且使用“ss”运行它，你将会发现这些bundle的状态如下：

 id      State                Bundle
 0         ACTIVE             org.eclipse.osgi_3. 3.0  .v20070208
 4         INSTALLED       BasicMovieFinder_1. 0.0

 id      State                Bundle
 0        ACTIVE             org.eclipse.osgi_3. 3.0 .v20070208
 4        INSTALLED       BasicMovieFinder_1. 0.0

 

      （注意：或许你的bundle列表和我的有些不同，特别是bundle的ID，它取决于你最初安装其他bundle的次数，这些不用特别的在意。）

 

      “INSTALLED”这个状态框架已经获取了bundle，但是到目前为止，它仍被另一个bundle所决定。我们可以使用“refresh”命令来启 动这个bundle。我们输入“refresh 4”来启动这个bundle并且用“ss”查看当前的bundle状态。

 id      State                     Bundle
 0         ACTIVE                  org.eclipse.osgi_3. 3.0  .v20070208
 4         INSTALLED            BasicMovieFinder_1. 0.0

 id      State                     Bundle
 0        ACTIVE                  org.eclipse.osgi_3. 3.0 .v20070208
 4        INSTALLED            BasicMovieFinder_1. 0.0

 

       这个bundle仍然没有解析！当然，我们需要安装interface bundle。要确认这个问题的原因，我们可以使用“diag 4”获得调试信息。

 file:BasicMovieFinder.jar [ 4  ]
   Missing imported package osgitut.movies_[ 1.0  . 0  , 2.0  . 0  ).

 file:BasicMovieFinder.jar [ 4 ]
   Missing imported package osgitut.movies_[1.0 . 0 , 2.0 . 0 ).

 

       是的，问题就是这样的：我们无法导入这个osgitut.movies的package，是因为当前没有bundle导出它。因此，现在安装bundle——MovieInterface.jar，并且使用“ss”命令查看结果：

 id      State              Bundle
 0         ACTIVE           org.eclipse.osgi_3. 3.0  .v20070208
 4         INSTALLED     BasicMovieFinder_1. 0.0
 5         INSTALLED     MoviesInterface_1. 0.0

 id      State              Bundle
 0        ACTIVE           org.eclipse.osgi_3. 3.0 .v20070208
 4        INSTALLED     BasicMovieFinder_1. 0.0
 5        INSTALLED     MoviesInterface_1. 0.0

 

       最后的步骤是通过使用“refresh 4”来解析Bundle——BasicMovieFinder。然后输入“ss”查看状态：

 id      State             Bundle
 0         ACTIVE          org.eclipse.osgi_3. 3.0  .v20070208
 4         RESOLVED     BasicMovieFinder_1. 0.0
 5         RESOLVED     MoviesInterface_1. 0.0

 id      State             Bundle
 0        ACTIVE          org.eclipse.osgi_3. 3.0 .v20070208
 4        RESOLVED     BasicMovieFinder_1. 0.0
 5        RESOLVED     MoviesInterface_1. 0.0

 

        BasicMovieFider终于处于“RESOLVED”状态了。这是必须的一步，因为只有处于“RESOLVED”状态了，才可以被“start”。而且不再取决于其他的Bundle。

 

        注意，通常我们没有必要这样做。Bundle会根据它们的需要自动的被“RESOLVE”。因此，即使我们没有使用“refresh”，它也会自动的处于“RESOLVED”状态。

 

        这就是本节课的内容，OSGi还有更多有趣的东西等着我们，来看看Chris Aniszczyk's excellent article on IBM developerWorks 的内容。敬请期待下期课程，我们在那里开始深入学习OSGi服务。