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

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

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

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

Java代码

1. package  osgitut.movies;   
2.   
3. public   class  Movie {   
4.      private   final  String title;   
5.      private   final  String director;   
6.   
7.      public  Movie(String title, String director) {   
8.          this .title = title;   
9.          this .director = director;   
10.     }   
11.   
12.      public  String getTitle() {   
13.          return  title;   
14.     }   
15.   
16.      public  String getDirector() {   
17.          return  director;   
18.     }   
19. }  

Java代码  

1. package  osgitut.movies;  
2.   
3. public   class  Movie {  
4.     private   final  String title;  
5.     private   final  String director;  
6.   
7.     public  Movie(String title, String director) {  
8.         this .title = title;  
9.         this .director = director;  
10.     }  
11.   
12.     public  String getTitle() {  
13.         return  title;  
14.     }  
15.   
16.     public  String getDirector() {  
17.         return  director;  
18.     }  
19. }  

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

Java代码

1. package  osgitut.movies;   
2.     
3. public   interface  MovieFinder {   
4.     Movie[] findAll();   
5. }  

Java代码  

1. package  osgitut.movies;  
2.    
3. public   interface  MovieFinder {  
4.     Movie[] findAll();  
5. }  

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

Mf代码

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

Mf代码  

1. Manifest-Version:  1.0   
2. Bundle-ManifestVersion: 2   
3. Bundle-Name: Movies Interface  
4. Bundle-SymbolicName: MoviesInterface  
5. Bundle-Version: 1.0 . 0   
6. 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：

Cmd命令代码

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

Cmd命令代码  

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

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

Java代码

1. package  osgitut.movies.impl;   
2.   
3. import  osgitut.movies.*;   
4.   
5. public   class  BasicMovieFinderImpl  implements  MovieFinder {   
6.      private   static   final  Movie[] MOVIES =  new  Movie[] {   
7.              new  Movie( "The Godfather" ,  "Francis Ford Coppola" ),   
8.              new  Movie( "Spirited Away" ,  "Hayao Miyazaki" ) };   
9.   
10.      public  Movie[] findAll() {   
11.          return  MOVIES;   
12.     }   
13. }  

Java代码  

1. package  osgitut.movies.impl;  
2.   
3. import  osgitut.movies.*;  
4.   
5. public   class  BasicMovieFinderImpl  implements  MovieFinder {  
6.     private   static   final  Movie[] MOVIES =  new  Movie[] {  
7.             new  Movie( "The Godfather" ,  "Francis Ford Coppola" ),  
8.             new  Movie( "Spirited Away" ,  "Hayao Miyazaki" ) };  
9.   
10.     public  Movie[] findAll() {  
11.         return  MOVIES;  
12.     }  
13. }  

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

Mf代码

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

Mf代码  

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

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

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

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

Cmd命令代码

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

Cmd命令代码  

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

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

Bundle state代码

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

Bundle state代码  

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

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

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

Bundle state代码

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

Bundle state代码  

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

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

Diag information代码

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

Diag information代码  

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

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

Bundle state代码

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

Bundle state代码  

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

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

Bundle state代码

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

Bundle state代码  

1. id      State             Bundle  
2. 0        ACTIVE          org.eclipse.osgi_3. 3.0 .v20070208  
3. 4        RESOLVED     BasicMovieFinder_1. 0.0   
4. 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服务。