OSGI简单入门.doc

本文大量参考了IBM Developerworks上的文章使用 Equinox 开发 OSGi 应用程序，之所以重新发表，是因为原文使用的是Eclipse 3.3，现在主流的版本为3.4，其中有些不同的地方。另外有一部分语焉不详，很容易使人卡在半途(主要在下一篇里)。因此我针对3.4做了一些整理，也重新截了图，作为对OSGi入门开发的一个小结。OSGi中文的大部分资料都和BlueDavy有很大的关系。如果想对OSGi有一个入门性或者较为深入的理解，请参阅BlueDavy编写的OSGi实战和OSGi进阶的OpenDoc。本文假定读者对OSGi有一些了解，所以对OSGi的介绍就不再赘述。对于Eclipse（3.2+）来说，其上运行的所有插件都是OSGi的Bundle。其核心Equinox就是OSGiR4的参考实现。所以，在Eclipse里，我们通过开发插件的形式，开发符合OSGi规范的Bundle。我们从HelloWorld开始。1. 建立一个 plug-in 工程，File New Project，选择Plug-in development Plug-in Project 新建插件项目2. 在建立工程的第一个向导，填入工程的名称：osgi.test.helloworld，使用缺省的工程路径。由于我们的项目是一个通用的 OSGi bundle，所以选择equinox。比3.3多出来的Working Set的概念我还没搞清楚，就默认吧。 新插件项目设置3. 这个步骤主要是填写插件/Bundle一些信息。可以不做修改直接“Next”。其中最后的是关于Activator的设置，相当于一个Java程序的main()入口，控制着整个Bundle的生命周期。与3.3相比，多出了Execution Environment选项。如果只在本机HelloWorld的话，就用默认的环境。 新插件项目信息4. 去掉所有的模板设置，结束新建 5. 完成，切换到插件开发的视角。新建了osgi.test.helloworld.Activator类，用于控制Bundle的生命周期，初始化等等（不过初始化工作不必都放在这里，OSGi提供了完整了Listener的支持）。最重要的配置文件是MANIFEST.MF，Eclipse提供了完整的编辑器支持，有几个标签页。比如在Dependencies里设置导入的包和依赖的Bundle/Plugin，Runtime则配置了导出的包及其他信息。 6. 编辑 Activator.java，找到start()方法，输入 hello world 语句，代码如下： ?Copy to clipboardView Code JAVA package osgi.test.helloworld;import org.osgi.framework.BundleActivator;import org.osgi.framework.BundleContext;public class Activator implements BundleActivator /* * (non-Javadoc) * see org.osgi.framework.BundleActivator#start(org.osgi.framework.BundleContext) */public void start(BundleContext context) throws Exception System.out.println(hello world);/* * (non-Javadoc) * see org.osgi.framework.BundleActivator#stop(org.osgi.framework.BundleContext) */public void stop(BundleContext context) throws Exception 每个Activator都实现了BundleActivator这个接口。OSGi就通过这个调用接口的 start()和stop()实现Bundle的启动和停止。注意：bundle 的 Activator 必须含有无参数构造函数，这样框架才能使用Class.newInstance() 方式反射构造 bundle 的 Activator 实例。 7. 运行实例。和普通Java程序直接运行不同的是，运行Bundle需要一些配置。选择Run-Run Configurations，在 OSGi framework 中右键点击选择new 一个新的 OSGi 运行环境 Bundle运行配置初始对话框8. 在右边的运行环境对话框中，输入运行环境的名字、start level 和依赖的插件。Start Level越高，启动顺序越靠后。图中默认的Start Level(SL)为4，我们把helloworld的Start Level设置为5，即较后加载的Bundle。由于目前不需要其它的第三方插件，因此只需要勾上系统的 org.eclipse.osgi 插件，如果不选择此插件，hello world 将无法运行。只有当点击了validate bundles 按钮 ，并且提示无问题之后，才表明运行环境基本 OK 了。 9. 点击“Run”，运行，应该能够在Console看到HelloWorld输出 运行控制台OSGi控制台使用命令行控制Bundle的状态查看、加载、卸载和更新。OSGi的好处在于能够在不重启应用的情况下，实现对模块的热插拔。如通过SS命令查看所有Bundle的简单状态（SS=Simple Status）。图中模块的状态为ACTIVE。 下图展示了OSGi Bundle的状态图：我可以直接修改HelloWorld里Activator的代码，编译后。使用Refresh命令更新helloworld的Bundle，得到更新后的运行输出：下面列出了主要的控制台命令。也可以在控制台中输入?获得帮助类别命令含义控制框架launch启动框架shutdown停止框架close关闭、退出框架exit立即退出，相当于 System.exitinit卸载所有 bundle（前提是已经 shutdown）setprop设置属性，在运行时进行控制 bundleInstall安装uninstall卸载Start启动Stop停止Refresh刷新Update更新展示状态Status展示安装的 bundle 和注册的服务Ss展示所有 bundle 的简单状态Services展示注册服务的详细信息Packages展示导入、导出包的状态Bundles展示所有已经安装的 bundles 的状态Headers展示 bundles 的头信息，即 MANIFEST.MF 中的内容Log展示 LOG 入口信息其它Exec在另外一个进程中执行一个命令（阻塞状态）Fork和 EXEC 不同的是不会引起阻塞Gc