JES,是Java嵌入服务器-Java Embedded Server的缩写。在嵌入系统中使用Java,是Java跨平台战略的重要组成部分。国内目前并无比较系统的中文文献。
从最简单的包(bundle)开始
简介
每个包(bundle)都至少需要一个包激活器类,用来激活包,还要有一个清单(manifest)文件。包激活器类是一个实现org.osgi.framework.BundleActivator 的类,它定义了start (开始)和stop (结束)方法的逻辑。JES框架使用start 和stop方法来启动和停止包。
在这个例子里,我们建立一个简单的包(bundle),在它里面没有什么服务,仅仅在启动的时候显示Hello ,在停止的时候显示Bye 。请按以下步骤进行:
用Java编写一个包激活类
用文本文件的格式建立一个清单(Manifest)文件。
建立一个JAR文件,里面包含编译好的激活器类以及清单(Manifest)文件。
启动 JES框架,并安装、运行、停止包。
稍后,如果要建立复杂的包,你将编写服务,用服务处理处理框架工作的事件,利用JES核心服务;你还要给包激活器这个类增加功能。
BundleContext(包环境)对象
现在,是介绍BundleContext(包环境)对象的时候了。这个对象让包能够与JES框架相互作用。
在框架启动一个包的时候,就建立一个BundleContext 对象,并把这个对象传递给包激活器的start 方法。利用BundleContext 对象里的方法,包可以安装自己、登记服务、取得其它已经安装的包的信息、取得对服务的引用、获取或释放服务对象、获取或翻译包(Bundle)对象和文件(File)对象、占用框架发布的事件。BundleContext 对象的内容,在本教程的后面还会详细介绍。
现在,你对BundleContext 对象需要了解这些事情:
只有 JES框架能够创建BundleContext对象,包不能创建它。
在包被激活的时候,BundleContext对象被传递给start方法。
在包停止的时候,BundleContext还被传递给stop方法。
现在,我们来看看,如何编写包的激活器类。
包的生命周期
每个包都有一个生命周期。在生命周期里,包可以被安装、激活、更新、灭活,直至最后卸载。生命周期就是我们从比较高的级别上观察这一连串事件时,事件经历的时间 (如果你对细节有兴趣,可以查阅OSGi 服务网关规范,发行版1.0)。
生命周期运行的步骤就象这样:
1. 安装包
JES框架读取包的内容,给包分配一个包ID,并且持续地缓存包的位置和状态。会建立一个专门的类引导,以访问包的资源。
2. 激活包
框架检测这个包所要求的Java类是否已经由其它的包导入了。如果别的包已经导入了相应的类,框架就调用包激活器类里的start 方法,登记包的服务。这时,包的服务开始运行。
在这一步,JES框架还要解决包之间的依赖关系,这样可以保证:如果包B依赖包A,那么在启动包B之前,包A已经存在。
3. 灭活包
框架调用包的stop 方法,取消服务的登记。服务停止运行。
4. 卸载包。
包从计算机上删除。
如果在包的生命周期期间出现错误, JES框架就会抛出一个BundleException(包异常),这是一种特殊的异常类型,只在包的生命周期当中发生。BundleException is是OSGI规范定义的一个标准异常 (在org.osgi.framework里),JES实现了这个异常。
第一步:编写包的激活器类
我们要建立的greeting1 这个包,它的激活器类Activator.java非常简单,只定义了start 和stop 二个方法。
代码示例1-1 一个简单的包激活器类(greeting1/Activator.java)
①
②
③
④
⑤
package greeting1;
import org.osgi.framework.BundleActivator;
import org.osgi.framework.BundleContext;
import org.osgi.framework.BundleException;
public class Activator implements BundleActivator {
public void start(BundleContext context) throws BundleException {
System.out.println( "Hello" );
}
public void stop(BundleContext context) throws BundleException {
System.out.println( "Bye" );
}
}
激活器类Activator 保存在包greeting1 里①。它从org.osgi.framework逐个导入了BundleActivator, BundleContext, 和BundleException 这几个类②,而没有导入整个org.osgi.framework包,这样降低了JES装载包激活器时占用的内存数量。
激活器Activator 实现BundleActivator (包激活器)这个接口③,定义了它的start 和stop 方法,所有的包激活器类都要实现这些功能。在start 方法④的实现里,用它抛出BundleException(包异常),而没有用BundleActivator里声明的java.lang.Exception 作为抛出异常的方法,因为BundleException (java.lang.Exception的子类) 是JES框架用来抛出有关包的生命周期问题的异常类型。start 的这个实现,在包启动的时候,会显示Hello。
stop 方法⑤也抛出BundleException ,在包停止的时候显示Bye 。
第二步:建立清单文件
在JES框架里安装的每个包,都包含一个清单(Manifest)文件。清单文件是标准的文本文件,它描述了JAR文件里的内容。清单文件是结构化组织的文件,每个段都由一个头组成,每个头都有一个属性。例如,参见greeting1/Manifest文件,它的内容是:
BundleActivator: greeting1.Activator
这个清单文件只有一个头,它告诉JES框架,用哪个类作为包的激活器类。
头给JES框架提供了“钩子”,可以钩上包里包含的文件和资源。通过这种途径,框架就能知道,当包在生命周期中移动的时候,在包里的什么地方去找到资源(例如:包激活器)。
OSGi 规范义了能够在清单文件里供JES包使用的头(如表1-1所示)。但是表1-1 只显示了头的名称。每个头都有一套规定好的语法,必须用它的语法给它指定属性。不过,学习这份教程,并不需要了解语法的细节内容。如果你对细节感兴趣,可以参阅Java 嵌入服务器 2.0 开发人员指南。
表 1-1 在包的清单文件里可以使用的头
头
说明
Bundle-Activator
包激活器
Bundle-ClassPath
包的类路径
Bundle-ContactAddress
包的联系人地址
Bundle-Description
包的描述
Bundle-Vendor
包的开发商
Bundle-DocURL
包的文档URL
Bundle-Name
包名称
Bundle-NativeCode
包的本机码
Bundle-UpdateLocation
包的更新位置
Import-Service
导入服务
Bundle-Version
包的版本
Export-Package
导出包
Export-Service
导出服务
Import-Package
导入包
第三步:建立包的JAR文件
现在,我们有了一个包激活器类和一个清单文件,可以建立包了。建立包,可以使用gnumake (Solaris 平台)或者nmake (Windows平台)这两个工具。
在Windows NT上的操作方法如下:
1.打开一个 MS-DOS 命令窗口
2.转到greeting1目录,就象这样:
C:cd jes2.0docs utorialgreeting1
3. 建立 JAR 文件:
C: make
4. 检测是否成功创建了JAR 文件:
C:cd jes2.0docs utorialuildundles
C:dir greeting1.jar
第四步:安装、运行包
要启动JES框架,单击开始菜单,然后是程序>Java Embedded Server2.0>Java Embedded Server 2.0 Frame。
当JES框架启动时,在MS-DOS窗口时,可以看到下面内容:
Java Embedded Server 2.0
Copyright 1998, 1999 and 2000 Sun Microsystems, Inc.
All rights reserved. Use is subject to license terms.
Type ‘h[elp]’ for a list of commands.
>
要打开JES工具包JES Tools Portal—单击开始菜单,然后是程序>Java Embedded Server 2.0>Java Embdded Server 2.0 Tools Portal.
在Tools Portal里,单击管理面板,打开JES的管理面板 JES Management Panel。
在管理面板里,单击包(Bundles)标签。
在要安装的包文件(Bundle File to Install)里,找到greeting1 这个包(缺省是jes2.0/docs/tutorial/build/bundles/greeting1.jar),然后单击安装。
在右侧面板的列表中看到greeting1 时,单击开始。
检查在右侧面板中显示的greeting1.jar的详细内容.
从最简单的包(bundle)开始
简介
每个包(bundle)都至少需要一个包激活器类,用来激活包,还要有一个清单(manifest)文件。包激活器类是一个实现org.osgi.framework.BundleActivator 的类,它定义了start (开始)和stop (结束)方法的逻辑。JES框架使用start 和stop方法来启动和停止包。
在这个例子里,我们建立一个简单的包(bundle),在它里面没有什么服务,仅仅在启动的时候显示Hello ,在停止的时候显示Bye 。请按以下步骤进行:
用Java编写一个包激活类
用文本文件的格式建立一个清单(Manifest)文件。
建立一个JAR文件,里面包含编译好的激活器类以及清单(Manifest)文件。
启动 JES框架,并安装、运行、停止包。
稍后,如果要建立复杂的包,你将编写服务,用服务处理处理框架工作的事件,利用JES核心服务;你还要给包激活器这个类增加功能。
BundleContext(包环境)对象
现在,是介绍BundleContext(包环境)对象的时候了。这个对象让包能够与JES框架相互作用。
在框架启动一个包的时候,就建立一个BundleContext 对象,并把这个对象传递给包激活器的start 方法。利用BundleContext 对象里的方法,包可以安装自己、登记服务、取得其它已经安装的包的信息、取得对服务的引用、获取或释放服务对象、获取或翻译包(Bundle)对象和文件(File)对象、占用框架发布的事件。BundleContext 对象的内容,在本教程的后面还会详细介绍。
现在,你对BundleContext 对象需要了解这些事情:
只有 JES框架能够创建BundleContext对象,包不能创建它。
在包被激活的时候,BundleContext对象被传递给start方法。
在包停止的时候,BundleContext还被传递给stop方法。
现在,我们来看看,如何编写包的激活器类。
包的生命周期
每个包都有一个生命周期。在生命周期里,包可以被安装、激活、更新、灭活,直至最后卸载。生命周期就是我们从比较高的级别上观察这一连串事件时,事件经历的时间 (如果你对细节有兴趣,可以查阅OSGi 服务网关规范,发行版1.0)。
生命周期运行的步骤就象这样:
1. 安装包
JES框架读取包的内容,给包分配一个包ID,并且持续地缓存包的位置和状态。会建立一个专门的类引导,以访问包的资源。
2. 激活包
框架检测这个包所要求的Java类是否已经由其它的包导入了。如果别的包已经导入了相应的类,框架就调用包激活器类里的start 方法,登记包的服务。这时,包的服务开始运行。
在这一步,JES框架还要解决包之间的依赖关系,这样可以保证:如果包B依赖包A,那么在启动包B之前,包A已经存在。
3. 灭活包
框架调用包的stop 方法,取消服务的登记。服务停止运行。
4. 卸载包。
包从计算机上删除。
如果在包的生命周期期间出现错误, JES框架就会抛出一个BundleException(包异常),这是一种特殊的异常类型,只在包的生命周期当中发生。BundleException is是OSGI规范定义的一个标准异常 (在org.osgi.framework里),JES实现了这个异常。
第一步:编写包的激活器类
我们要建立的greeting1 这个包,它的激活器类Activator.java非常简单,只定义了start 和stop 二个方法。
代码示例1-1 一个简单的包激活器类(greeting1/Activator.java)
①
②
③
④
⑤
package greeting1;
import org.osgi.framework.BundleActivator;
import org.osgi.framework.BundleContext;
import org.osgi.framework.BundleException;
public class Activator implements BundleActivator {
public void start(BundleContext context) throws BundleException {
System.out.println( "Hello" );
}
public void stop(BundleContext context) throws BundleException {
System.out.println( "Bye" );
}
}
激活器类Activator 保存在包greeting1 里①。它从org.osgi.framework逐个导入了BundleActivator, BundleContext, 和BundleException 这几个类②,而没有导入整个org.osgi.framework包,这样降低了JES装载包激活器时占用的内存数量。
激活器Activator 实现BundleActivator (包激活器)这个接口③,定义了它的start 和stop 方法,所有的包激活器类都要实现这些功能。在start 方法④的实现里,用它抛出BundleException(包异常),而没有用BundleActivator里声明的java.lang.Exception 作为抛出异常的方法,因为BundleException (java.lang.Exception的子类) 是JES框架用来抛出有关包的生命周期问题的异常类型。start 的这个实现,在包启动的时候,会显示Hello。
stop 方法⑤也抛出BundleException ,在包停止的时候显示Bye 。
第二步:建立清单文件
在JES框架里安装的每个包,都包含一个清单(Manifest)文件。清单文件是标准的文本文件,它描述了JAR文件里的内容。清单文件是结构化组织的文件,每个段都由一个头组成,每个头都有一个属性。例如,参见greeting1/Manifest文件,它的内容是:
BundleActivator: greeting1.Activator
这个清单文件只有一个头,它告诉JES框架,用哪个类作为包的激活器类。
头给JES框架提供了“钩子”,可以钩上包里包含的文件和资源。通过这种途径,框架就能知道,当包在生命周期中移动的时候,在包里的什么地方去找到资源(例如:包激活器)。
OSGi 规范义了能够在清单文件里供JES包使用的头(如表1-1所示)。但是表1-1 只显示了头的名称。每个头都有一套规定好的语法,必须用它的语法给它指定属性。不过,学习这份教程,并不需要了解语法的细节内容。如果你对细节感兴趣,可以参阅Java 嵌入服务器 2.0 开发人员指南。
表 1-1 在包的清单文件里可以使用的头
头
说明
Bundle-Activator
包激活器
Bundle-ClassPath
包的类路径
Bundle-ContactAddress
包的联系人地址
Bundle-Description
包的描述
Bundle-Vendor
包的开发商
Bundle-DocURL
包的文档URL
Bundle-Name
包名称
Bundle-NativeCode
包的本机码
Bundle-UpdateLocation
包的更新位置
Import-Service
导入服务
Bundle-Version
包的版本
Export-Package
导出包
Export-Service
导出服务
Import-Package
导入包
第三步:建立包的JAR文件
现在,我们有了一个包激活器类和一个清单文件,可以建立包了。建立包,可以使用gnumake (Solaris 平台)或者nmake (Windows平台)这两个工具。
在Windows NT上的操作方法如下:
1.打开一个 MS-DOS 命令窗口
2.转到greeting1目录,就象这样:
C:cd jes2.0docs utorialgreeting1
3. 建立 JAR 文件:
C: make
4. 检测是否成功创建了JAR 文件:
C:cd jes2.0docs utorialuildundles
C:dir greeting1.jar
第四步:安装、运行包
要启动JES框架,单击开始菜单,然后是程序>Java Embedded Server2.0>Java Embedded Server 2.0 Frame。
当JES框架启动时,在MS-DOS窗口时,可以看到下面内容:
Java Embedded Server 2.0
Copyright 1998, 1999 and 2000 Sun Microsystems, Inc.
All rights reserved. Use is subject to license terms.
Type ‘h[elp]’ for a list of commands.
>
要打开JES工具包JES Tools Portal—单击开始菜单,然后是程序>Java Embedded Server 2.0>Java Embdded Server 2.0 Tools Portal.
在Tools Portal里,单击管理面板,打开JES的管理面板 JES Management Panel。
在管理面板里,单击包(Bundles)标签。
在要安装的包文件(Bundle File to Install)里,找到greeting1 这个包(缺省是jes2.0/docs/tutorial/build/bundles/greeting1.jar),然后单击安装。
在右侧面板的列表中看到greeting1 时,单击开始。
检查在右侧面板中显示的greeting1.jar的详细内容.