领域修炼之路

理解OSGi Fragment Bundle

Fragment Bundle是一个可追加于一个或多个主体(Host)Bundle的Bundle。Fragment Bundle与其Host Bundle之间是从主关系,并且Fragment Bundle不能独立运行,它在Host Bundle解析之前被框架追加到Host Bundle,随之被看作是Host Bundle的一部分。 Fragment Bundle具有自己的保护域,但没有自己的Class loader。

具有相同的Symbolic Name且版本不同的Fragment bundle 可以追加到多个Host bundle。如果存在多个具有相同Fragment bundle应用的一个主要场景是用来提供不同语言的翻译包,在这种模式下,每种语言包可以作为独立的Fragment bundle存在。

当一个已追加的fragment更新时,之前追加到Host bundle的内容会继续保留。新的fragment内容只有在框架重启或者Host bundle刷新时才会追加到Host。在这种情况下,fragment具有两个版本:已追加的版本;可以追加到新的Host或其它host bundle的新的fragment bundle。

当框架追加一个fragment bundle到一个host bundle时,按下述步骤操作:

  1. 如果Package导入不冲突,将Fragemnt bundle的包导入定义(Import-Package)附加到Host Bundle的包导入定义中。Fragment可以导入Host bundle的私有包(Private-Package),此时,Host bundle中此包仍保持私有;

  2. 在Require-Bundle定义不冲突的前提下,将Fragment bundle的Require bundle定义附加到Host bundle的Require bundle定义中;

  3. 将Fragemnt bundle的Export-Package定义附加到Host bundle的Export-Package定义中。如果Fragment的某个Package的导出定义与Host中导出包的定义完全一致(包名、标记和属性),则此包忽略,否则必须附加。即,可以导出同名包的多个版本。

  4. 附加Provide-Capability到Host bundle定义;

  5. 附加Require-Capability到Host bundle定义;

如果Host和Fragment不能提供一致的类空间,则会产生冲突。如果存在冲突,Fragment bundle则不能追加到Host。

当且仅当一个Fragment bundle成功追加到至少一个Host bundle时,此Fragment bundle进入Resolved状态。

在运行时,fragment的jar在类路径查找中位于host bundle的类路径查找之后。

Fragment bundle不能出现在其他bundle的Require-Bundle定义中。

Fragment-Host清单头的语法定义:

1
2
Fragment-Host ::= bundle-description
Bundle-description ::= symbolic-name(';'parameter)*

Fragment-Host可配置的标记属性:

属性 说明

Extension(仅在Fragment-Host是系统bundle(id=0)时允许此标记)| framework/bootclasspath | framework:fragment bundle是框架的扩展bundle; bootclasspath:fragment bundle是启动类路径的扩展bundle
Bundle-version | [0.0.0,∞) | 如果属性值是一个范围,则fragment bundle将追加到所有符合条件的host

逻辑上,从fragment bundle追加到host bundle开始,fragment bundle就是host bundle的一部分,fragment bundle中的所有类及资源都由host bundle的类加载器加载。

Host自身的类查找路径在其所有的fragment bundle类路径之前;fragment bundle的类查找路径顺序按照fragment bundle ID的升序排列。

Fragment bundle的另一个常见用途是扩大现有bundle的类加载范围,比如commons-dbcp bundle需要加载各种数据库的jdbc驱动,可以将这些驱动封装为commons-dbcp的fragment bundle。如果已有的jdbc驱动需要独立bundle存在,则可以封装一个该驱动的wrpper fragment bundle。

chrisrc wechat
更多信息请订阅我的微信订阅号