OSGi框架-第一章- Equinox 框架中的相关知识点

MANIFEST.MF

MANIFEST.MF 可能出现在任何包括主类信息的 Jar 包中，一般位于 META-INF 目录中，所以此文件并不是一个 OSGi 特有的东西，而仅仅是增加了一些属性，这样也正好保持了 OSGi 环境和普通 Java 环境的一致性，便于在老的系统中部署。表 2 列出此文件中的重要属性及其含义：

表 2. MANIFEST.MF 文件属性

属性名字	含义
Bundle-Activator	Bundle 的启动器
Bundle-SymbolicName	名称，一般使用类似于 JAVA 包路径的名字命名
Bundle-Version	版本，注意不同版本的同名 bundle 可以同时上线部署
Export-Package	导出的 package 声明，其它的 bundle 可以直接引用
Import-Package	导入的 package
Eclipse-LazyStart	是否只有当被引用了才启动
Require-Bundle	全依赖的 bundle，不推荐
Bundle-ClassPath	本 bundle 的 class path，可以包含其它一些资源路径
Bundle-RequiredExecutionEnvironment	本 bundle 必须的执行环境，例如 jdk 版本声明

什么是 bundle？

我们已经看到，编写一个很普通的 Hello world 应用，必须首先创建一个 plug-in 工程，然后编辑其 Activator 类的 

start

 方法，实际我们这样做的本质是为 OSGi 运行环境添加了一个 bundle，那么一个 bundle 必须的构成元素是哪些呢？

1. MANIFEST.MF：描述了 bundle 的所有特征，包括名字、输出的类或者包，导入的类或者包，版本号等等，具体可以参考 表 2. MANIFEST.MF 文件属性。
2. 代码：包括 Activator 类和其它一些接口以及实现，这个和普通的 Java 应用程序没有什么特殊的区别。
3. 资源：当然，一个应用程序不可能没有资源文件，比如图片、properties 文件、XML 文件等等，这些资源可以随 bundle 一起存在，也可以以 fragment bundle 的方式加入。
4. 启动级别的定义：可以在启动前使用命令行参数指定，也可以在运行中指定，具体的 start level 的解释，请参考 后面的说

框架做了些什么？

好了，我们已经明白 bundle 是什么了，也知道如何开发一个基本的 bundle 了，那么我们还必须要明白，我的 bundle 放在 Equinox 框架中，它对我们的 bundle 做了些什么？

图 11. Equinox 框架架构

实际上，目标平台已经为我们准备了 N 个 bundle，它们提供各种各样的服务，OSGi 中，这些 bundle 的名字叫 system bundle，就好比精装修的房子，您只需要拎包入住，不再需要自己铺地板，装吊顶了。

我们的 bundle 进入 Equinox 环境后，OSGi 框架对其做的事情如下：

1. 读入 bundle 的 headers 信息，即 MANIFEST.MF 文件；
2. 装载相关的类和资源；
3. 解析依赖的包；
4. 调用其 Activator 的 

   start

    方法，启动它；
5. 为其提供框架事件、服务事件等服务；
6. 调用其 Activator 的 

   stop

    方法，停止它；

Bundle 导入导出 package

OK，到现在为止，似乎一切都是新鲜的，但是您似乎在考虑，OSGi 到底有什么优势，下面介绍一下其中的一个特点，几乎所有的面向组件的框架都需要这一点来实现其目的： 面向服务、封装实现 。这一点在普通的 Java 应用是很难做到的，所有的类都暴露在 classpath 中，人们可以随意的查看您的实现，甚至变更您的实现。这一点，对于希望发布组件的公司来说是致命的。

图 13. OSGi bundle 原理

OSGi 很好的解决了这个问题，就像上面的图显示的，每个 bundle 都可以有自己公共的部分和隐藏的部分，每个 bundle 也只能看见自己的公共部分、隐藏部分和其它 bundle 的公共部分。

bundle 的 MANIFEST.MF 文件提供了 EXPORT/IMPORT package 的关键字，这样您可以仅仅 export 出您希望别人看到的包，而隐藏实现的包。并且您可以为它们编上版本号，这样可以同时发布不同版本的包。

Bundle class path

这一点比较难理解，一般情况下您不需要关心这个事情，除非事情出现了问题，您发现明明这个类就在这里，怎么就是报告 ClassNotFoundException/NoClassDefExcpetion 呢？在您垂头丧气、准备砸掉电脑显示器之前，请看一下 bundle 中的类是如何查找的：

1. 首先，它会找 JRE，这个很明显，这个实际是通过系统环境的 

   JAVA_HOME

    中找到的，路径一般是 JAVA_HOME/lib/rt.jar、tools.jar 和 ext 目录，endorsed 目录。
2. 其次，它会找 system bundle 导出的包。
3. 然后，它会找您的 import 的包，这个实际包含两种：一种是直接通过 require-bundle 的方式全部导入的，还有一种就是前面讲的通过 import package 方式导入的包。
4. 查找它的 fragment bundle，如果有的话。
5. 如果还没有找到，则会找自己的 classpath 路径（每个 bundle 都有自己的类路径）。
6. 最后它会尝试根据 DynamicImport-Package 属性查找的引用。