OSGI入门：Bundle 版的HelloWorld

        在接下来的两个星期里，EclipseZone将为员工举行一系列OSGi短期培训。经过这样，他们将顺利的掌握OSGi的编程艺术。他们将在每一期课程中了解到一些新的知识，并且通过10分钟的学习，将知识运用在工作中。同样，我们也将展示开发OSGi是多么的容易。为此，我们将不使用Eclipse进行开发，我们只用文本编辑器和基本的命令行来开发。现在，欢迎走入“Getting Started with OSGi”系列。

 

       实际上，第一堂课可能要比后面的课多花点时间，因为我们需要搭建基本的工作环境。在开始之前，我们需要将OSGi框架运行起来。目前有三个开源的框架可以让我们选择：Apache Felix，Knopflerfish，和Equinox。无乱选择什么框架，对我们将要写的代码没有影响，只不过运行过程中的提示可能有所不同。既然这里是EclipseZone，那我们选择Equinox——Eclipse自己建立的OSGi框架。你可以在你的Eclipse安装根目录中，找到plugins文件夹，然后将其中的org.eclipse.osgi_…….jar（省略号表示它的版本号，Eclipse版本不一样，版本号也不一样。如果你实在找不到，可以从http://download.eclipse.org/eclipse/equinox/ 中下载equinox并从中找到这个jar包 ）拷贝到一个空的文件夹中（最好是C盘的根目录下的空文件夹中，这样不会由于其他因素造成不必要的困惑）。为了更加方便的进行学习，我们将这个org.eclipse.osgi_…….jar改名为equinox.jar。然后在我们的开发环境下打开命令行并且输入以下命令（先用cd命令将工作目录切换到该文件夹下）：

java -jar equinox.jar -console

java -jar equinox.jar -console 

 

       然后，在命令行控制台中便会出现“osgi> ”。恭喜你，你已经成功的启动了OSGi！

 

        “osgi> ”为我们提供了一个进入命令以便我们对equinox框架进行控制。如果你喜欢，可以输入“help”来查看命令列表，并且尝试一下这些命令。现在，我们试一下“ss”。这个是常用的命令，它是“short status”的简写。它会列出所有已经安装好的bundle以及这些bundle的状态。（bundle是OSGi中的模式，如果你是一名Eclipse开发者，那么你可能以插件来称呼它们。实际上，bundle和插件是相同的东西。）当我们输入“ss”之后，Equinox将会在命令行中打印出一下的内容：

 

Framework is launched.

id            State                  Bundle
0             ACTIVE               system.bundle_3.2.1.R32x_v20060919

Framework is launched.

id            State                  Bundle
0             ACTIVE               system.bundle_3.2.1.R32x_v20060919

 

        这是告诉我们已经有一个bundle被安装并且并执行了。它是一个系统的bundle，并在OSGi运行的过程中，将永远存在，它代表了框架本身。现在，我们将写一个自己的bundle。在刚才存放equinox.jar 的文件夹中，新建一个文件，并且取名HelloActivator.java，并将一下代码粘贴过去。

import org.osgi.framework.*;

public class HelloActivator implements BundleActivator {
    public void start(BundleContext context) {
        System.out.println("Hello EclipseZone Readers!");
    }

    public void stop(BundleContext context) {
        System.out.println("Goodbye EclipseZone Readers!");
    }
}

import org.osgi.framework.*;

public class HelloActivator implements BundleActivator {
	public void start(BundleContext context) {
		System.out.println("Hello EclipseZone Readers!");
	}

	public void stop(BundleContext context) {
		System.out.println("Goodbye EclipseZone Readers!");
	}
}

 

      每一个bundle需要一个manifest文件来声明bundle中的各种数据，例如：它的名字，版本等。因此我们需要建立一个名为HelloWorld.MF的文件（注意：后缀名为.MF），然后输入以下内容，并且确定在文件结尾留一个空行，否则的话，jar命令将会截断此文件，造成错误。

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: HelloWorld Plug-in
Bundle-SymbolicName: Login_ConfigFileLoginBundle
Bundle-Version: 1.0.0
Bundle-Activator: HelloActivator
Import-Package: org.osgi.framework;version="1.3.0"

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: HelloWorld Plug-in
Bundle-SymbolicName: Login_ConfigFileLoginBundle
Bundle-Version: 1.0.0
Bundle-Activator: HelloActivator
Import-Package: org.osgi.framework;version="1.3.0"

 

      然后我们新打开一个命令行窗口（待会再返回刚才的命令行窗口进行OSGi操作）用以下的命令来打一下包（先将工作目录切换到该文件夹下），

> javac -classpath equinox.jar HelloActivator.java
> jar -cfm HelloWorld.jar HelloWorld.mf HelloActivator.class

> javac -classpath equinox.jar HelloActivator.java
> jar -cfm HelloWorld.jar HelloWorld.mf HelloActivator.class  

 

       打完包后，返回到刚才的OSGi命令行控制台，输入“install file:HelloWorld.jar”。控制台里将会打印出“Bundle id is 1”。然后输入“ss” 你将会看到以下的内容：

Framework is launched.
id          State                Bundle
0           ACTIVE             system.bundle_3.2.1.R32x_v20060919
1           INSTALLED       HelloWorld_1.0.0

Framework is launched.
id          State                Bundle
0           ACTIVE             system.bundle_3.2.1.R32x_v20060919
1           INSTALLED       HelloWorld_1.0.0

 

      我们的HelloWorld Bundle已经安装上去了。但是它还没有被运行。我们将在以后会思考这个状态是什么意思，但是现在我们需要通过“start 1”来运行这个Bundle。这个“1”是每个Bundle的ID编号，就是上面第一列的内容。当你看到了“Hello EclipseZone Readers! ”的信息后，输入“stop 1”，你又会看到“Goodbye EclipseZone Reader!”，重复这个操作，直到你厌倦。不要忘记了偶尔通过“ss”命令查看每一个Bundle的状态（State）有没有发生变化。

 

       这里面发生了什么？我们的类实现了BundleActivator接口，允许框架通知我们重要的Bundle的生命活动。当我们启动Bundle的时候，框架执行“start”这个方法；当我们停止Bundle的时候，框架执行“stop”这个方法。只是因为在manifest文件中，也就是我们刚才的“HelloWorld.MF”文件中有这样一句话“Bundle-Activator: HelloActivator”，他告诉了框架哪一个Bundle类被激活。正常情况下我们会给出规范的名称，但是我们很懒惰所以我们使用默认的软件包。

 

       到这里我们就此结束第一次课。下节课见！