OSGi起步(3)：bundle之间的依赖
-----------------------
原文出处：http://www.eclipsezone.com/eclipse/forums/t90544.html
原作者：Neil Bartlett
----------------------
OSGi起步(3)：bundle之间的依赖
在之前的教程中，我们知道bundle怎么启动和停止，以及它们如何与框架、以及相互间的生命周期进行交互。但是，bundle到底是什么呢？
bundle是模块。它使得我们可以把一个完整的项目分解成便于管理的模块。这些模块可以单独地加载入OSGi运行环境。问题是，不管我们是否愿意，模块间几乎总是存在依赖关系。过去简单的jar文件中，不存在一个可靠的方法来详细指明不同jar之间的依赖。（注意，manifest文件中的Class-Path属性并不是一个可靠的方法）。所以，我们永远无法保证，在运行期，某个jar中的代码是可以正常工作，还是会抛出一个ClassNotFoundException。
OSGi很巧妙地解决了这个问题。不过，与其直接告诉你是怎么回事，我们还是做个例子来展示一下吧。好，我们直接进入代码部分。不幸的是，由于我们之前一直在使用默认的package，而这样是没法用于展示的，所以我们将从一个合适的package入手。所以，我们先写一些简单的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/MovieFinder.java，复制以下内容：
package
osgitut.movies;
public
interface
MovieFinder
{ Movie[] findAll();}
接下来，我们把这两个文件做成一个bundle。是的，这个bundle出奇的小，并且几乎没有任何用途，不过在本例子中已经足够用了。跟以前一样，我们需要创建一个manifest文件。创建文件MoviesInterface.mf，复制以下内容：
Manifest-Version:
1.0
Bundle-ManifestVersion:
2
Bundle-Name: Movies InterfaceBundle-SymbolicName: MoviesInterfaceBundle-Version:
1.0.0
Export-Package: osgitut.movies
;
version="1.0.0"
这里有一行我们之前没有遇到过的内容： Export-Package 。这一行表示这个 bundle 将导出一个 package osgitut.movies 。在刚开始的时候，这看起来也许有些怪异，因为在旧的 jar 包中，所有的内容都是自动导出的。但是，难道你就从来没想要在一个 package 中放一些只在 jar 中可见的代码么？当然，你可以写一些 private 或者 protected 的类，但是，这样一样，它们对于 jar 中的其他 package 也是不可见的了。所以， OSGi 引入了一个很有效的代码保护层：如果一个 package 没有被 Export-Package 明确导出，那么它们就只能在你的模块中被使用。
也许你还注意到了，我们给这个package添加了一个版本号。我们将在后边看到它的重要性。版本号并不是必须的，但是，如果没有，那么，OSGi将自动为你的package添加版本号”0.0.0”。提供明确的版本号是一个比较好的习惯。
现在，我们来创建这个bundle：
javac osgitut
/
movies
/
Movie
.
java osgitut
/
movies
/
MovieFinder
.
javajar -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; }}
然后创建一个 manifest 文件 BasicMovieFinder.mf ：
Manifest-Version:
1.0
Bundle-ManifestVersion:
2
Bundle-Name: Basic Movie FinderBundle-SymbolicName: BasicMovieFinderBundle-Version:
1.0.0
Import-Package: osgitut.movies
;
version="[1.0.0,2.0.0)"
注意，我们导入了被另一个bundle导出的package osgitut.movies。同时我们在导入的时候添加了一个版本范围。框架将在运行时使用这个版本范围，检查导入的和被导出的package是否相匹配。OSGi对版本范围所使用的语法对于数学爱好者来说应该是很熟悉的：方括号表示包括，而圆括号表示不包括。这样，我们能很有效地表示出版本”1.x”。
同样的，为导入的 package 添加版本号也不是必须的，但是，这是一个很好的习惯。
好，我们编译并创建第二个 bundle ：
javac -classpath MoviesInterface
.
jar osgitut
/
movies
/
impl
/
BasicMovieFinderImpl
.
javajar -cfm BasicMovieFinder
.
jar BasicMovieFinder
.
mf osgitut
/
movies
/
impl
/
*
.
class
现在，我们终于可以在Equinox上测试这些bundle了。这一次，我们不再详细给出所有的指令了，你应该可以自己处理:)
首先，安装BasicMovieFinder，输入ss，应该能看到这个bundle处于INSTALLED状态；
id State Bundle
0
ACTIVE org
.
eclipse
.
osgi_3
.
3.0
.
v20070208
4
INSTALLED BasicMovieFinder_1
.
0.0
（作者注：你的 bundle 列表看起来可能会和我的不一样。一般来说， bundle 的 ID 取决于你上一次安装和卸载了多少次 HelloWorld J 你需要自己手动将文中的 ID 转换成你的 ID ）
INSTALLED 表示框架已经得到这个 bundle 了，但是还没有处理它的依赖性。强制 Enquinox 处理这些 bundle 的一个方法是调用 refresh 命令。所以，输入 refresh 4 后，你将看到：
id State Bundle
0
ACTIVE org
.
eclipse
.
osgi_3
.
3.0
.
v20070208
4
INSTALLED BasicMovieFinder_1
.
0.0
这个bundle还是不是RESOLVED。这是理所当然的，我们需要安装包含了Movie类和MovieFinder接口的“接口”bundle。为了确定这就是问题所在，输入diag 4来查看诊断信息：
file
:BasicMovieFinder
.
jar [
4
] Missing imported package osgitut
.
movies_[
1.0
.
0
,
2.0
.
0
).
看，这正是问题所在：我们无法导入package osgitut.movies，因为现在没有一个bundle导出这个package。现在，安装MovieInterface.jar bundle，并执行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
最后的步骤是让Equinox再次处理BasicMovieFinder。输入refresh 4，将看到：
id State Bundle
0
ACTIVE org
.
eclipse
.
osgi_3
.
3.0
.
v20070208
4
RESOLVED BasicMovieFinder_1
.
0.0
5
RESOLVED MoviesInterface_1
.
0.0
好了，现在BasicMovieFinder是RESOLVED状态了。这是一个很重要的步骤，因为只有当一个bundle是RESOLVED状态，他才可以被启动，或者为其它bundle提供依赖。
注意，通常并不需要象这样手动处理。一般的， bundle 会在需要时自动被处理。例如，本例中，尽管我们没有明确要求 refresh ， MovieInterface 已经是 RESOLVED 状态了。
以上就是今天的内容。你可以去看看这篇文章“Chris Aniszczyk's excellent article on IBM developerWorks”(http://www-128.ibm.com/developerworks/opensource/library/os-ecl-osgiconsole/)，看看通过Equinox控制台可以做哪些好玩的事情:)
下一次，我们将介绍OSGi 服务。
------------------- 重要的回帖 ----------------------
从Eclipse中启动OSGi平台的方法是，菜单”Run”->”Run…”,创建一个新的运行选项，在左边的列表中选择”OSGi Framework”。
这样，当你运行这个配置的时候，你将在Eclipse界面的控制台窗口中看到OSGi的控制台。
（译者：我的尝试出错了-___-!）