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服务。