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