osgi笔记-程序员宅基地

Bundle-Classpath可以实现内嵌jar。

一个Bundle的Activator不需要进行Export

一个Package中的类被两个ClassLoader加载,包中的Private class对于两个ClassLoader之间是相互不可见的。

Manifest语法: name: value,我们称之为一个条目,Manifest文件有不受限制的条目个数,其中name是不区分大小写,可以包含字母数字,下划线,中划线,Value可以包含除子\r, \n之后的所有字符,name和value之间必须用一个冒号和一个空格分隔开,一行不能超过72个字符,超过72字符部分需要从下一行,以一个空格开始继续写,

Manifest中空行或者全是空格的行用来划分属性group。osgi只取第一个group中定义的name value。

Osgi Manifest的条目定义形式如下,value中有多个clause(用","分隔),每个clause中包含有target,directive和attribute三部分。其具体语法请参考OSGi In action一书或者OSGI规范。不过一般不需要纠结于这一点,看了下面的一些例子相信大部分读者都能“不攻自破”,但书面表达起来的确是个问题。

Property-Name: target1; dir1:=value1; attr1=value2,
 target2; dir1:=value1; attr1=value2,
 target3; dir1:=value1; attr1=value2

如果value中包含有空格或者分隔符“,” 和“;”的话,需要用括号来括起来

如果多个target之间有相同的attribute和directive的话,可以采用下面的简写形式:

Property-Name: target1; target2; dir1:=value1; attr1=value2

 

下面是一些human-readable bundle metadata。Osgi framework将它们忽略:需要注意的是由于历史原因Bundle-Name并不是一个用于Bundle Identification的Manifest Attribute。

Bundle-Name: Simple Paint API                              
Bundle-Description: Public API for a simple paint program. 
Bundle-DocURL: http://www.manning.com/osgi-in-action/      
Bundle-Category: example, library                          
Bundle-Vendor: OSGi in Action                              
Bundle-ContactAddress: 1234 Main Street, USA               
Bundle-Copyright: OSGi in Action                     

 

Bundle-SymbolicName和Bundle-Version用于唯一标识一个Bundle。它们在Require-Bundle中被使用,大多数情况下,osgi还是在使用package作为import的标识的。

Bundle-SymblicName的value类似于java的包名,用"."来分隔。Bundle-Version的value遵循osgi version的命名规则

例如:

Bundle-ManifestVersion: 2 // 这个也会起标识作用,但目前它仅有2是合法的。
Bundle-SymbolicName: org.foo.shape
Bundle-Version: 2.0.0

 

Osgi中关于代码可见性的metadata有以下几种信息:这里不作翻译,直接贴上书中的原文:

Internal bundle class path:  The code forming the bundle
Exported internal code:       Explicitly exposed code from the bundle class path for sharing with other bundles
Imported external code:       External code on which the bundle class path code depends

 

Bundle-ClassPath用于表示Bundle内部类加载时的ClassPath,类似于定义内部可见性,注意这些ClassPath都是相对于Bundle jar文件内部的,我们还可以在Bundle中加入内嵌的jar包,如下:

Bundle-ClassPath: .,other-classes/,embedded.jar

Bundle-ClassPath的缺省值是".",也就和非osgi环境中的jar包的加载规则一致了。

Export-Package用于暴露bundle内部的类,多个包名之间用逗号隔开","同时,包名可以用";"隔开并加上限定的Attribute,因此多个Bundle可能导出同样的包名,这时候需要其它信息加以限定,并且如果多个包名所有的限定属性都一致的话,采用采用省略的写法,如下:

Export-Package: org.foo.shape; vendor="Manning", org.foo.other;
 vendor="Manning"
和下面的写法效果一致
Export-Package: org.foo.shape; org.foo.other; vendor="Manning"

除此之外,osgi定义了一个专门的限定属性version,其值必须遵循osgi version的规范。另外包名下的子包是不会被导出的。

 

Import-Package用于导入在运行时bundle所依赖的类。但java.*开头的类比较特殊,它自动地对所有的bundle都是可见的,因此我们不需要也无法插手这一点。Import-Package和Export-Package的写法上基本一致,但是Import-Package可以指定version的范围,比如:

Import-Package: org.osgi.framework; version="[1.3.0,2.0.0)"

version定义规范如下:

在没有version限定的情况下,version默认为0.0.0,因此version>=0.0.0的匹配到的包都有可能被选择。

1、注意在有多个版本的Export-Package符合version要求的话,那么osgi将会选择最高版本那个,比如servlet bundle提供javax.servlet; version="2.4.0"而tomcat bundle提供了javax.servlet; version="2.5",那么osgi将使用tomcat中提供的类。如果servlet bundle已经先于tomcat bundle被使用,那么将使用servlet bundle中的类,即使它的版本号比较低。

2、如果有两个bundle提供的版本号也相同的话,那么选择,最先被install的那个bundle。

Use directive:上面两点在解决类不一致问题上还是不足的,对于在方法名上暴露了import进来的类的情况下(osgi in action page61-63),需要用uses:=import.package.name这一条directive来解决,uses:=import.package.name用于保证其它bundle import这个bundle的Export-Package的时候,转为使用这个Bundle所import的import.package.name,上面这句话不知道怎么表达哈,贴上原书的图:

其实Http Service这个Bundle在Export-Package中,通过方法的签名暴露了从Servlet API bundle import进来的javax.servlet.Servlet和javax.servlet.ServletContext:

package org.osgi.service.http; 
import javax.servlet.Servlet; 
public interface HttpService {
  void registerServlet(Sting alias, Servlet servlet, HttpContext ctx); 
}

那么在Http Servlet Bundle中使用uses:=javax.servlet时候,将传递性地使Http Client也转为使用Servlet API Bundle中export的javax.servlet; version="2.3.0",从而保证了类的一致性:

Export-Package: org.osgi.service.http;
 uses:="javax.servlet"; version="1.0.0"
Import-Package: javax.servlet; version="2.3.0"

不过osgi framework并不能为我们解决所有的问题,所以这种情况下我们自己可以手动解决的就不要偷懒了。

 

类搜索的顺序:

1、如果类名以java.开头,那调用父加载器进行加载,如果找不到将抛出ClassNotFoundException等异常。

2、如果这个类属于Import-Package中的一员,那么,委托给对应的外部的Bundle进行加载。

3、最后搜索Bundle-ClassPath

 关于osgi模块化的高级特性:

importing exported packages, implicit attributes, mandatory attributes, class filtering, and duplicate exports.

Importing exported packages: 这种情况多发生在接口与实现打包在一起,而又希望osgi环境中可以从别的bundle中拿到接口的实现者,而且它们之间可以进行交互。比如书中所描述的情况:
Bundle A, Bundle B 都导出了javax.servlet,Bundle A import javax.servlet.Servlet,而且A在使用javax.servlet.Servlet时候希望能同时在B和C之间传递,交互。

那么,针对C有两种解决方案:

1、删除C中的javax.servlet,import B中的。

2、不删除C中的,并且导出javax.servlet。

方案1的话,C将依赖于B,在缺少B的环境将无法使用。

方案2的话,A中的javax.servlet.Servlet无法在B,C之间传递,否则将引起ClassCastException。

针对这个情况,osgi提供了一个import exported package方案,我们可以在C中使用import exported package,如下,Import-Package 和Export-Package可以有不同的Version,表明C可以更低版本的javax.servlet下工作,这并不是错误:

Export-Package: javax.servlet; version="2.4.0"
Import-Package: javax.servlet; version="2.3.0"

 

Implicit export attribute Export-Package(隐性携带的属性):

在Export-Package的时候,OSGi framework隐性地在导入的包中附加上bundle-symbolic-name(值为Bundle-SymblicName)和bundle-version(值为Bundle-Version)属性:

Bundle-ManifestVersion: 2
Bundle-SymbolicName: my.javax.servlet
Bundle-Version: 1.2.0
Export-Package: javax.servlet; javax.servlet.http; version="2.4.0"

等同于(下面展示用,不能像下面直接在Manifest Export-Package中写bundle-symbolic-name和bundler-version属性,否则会在install bundle时候抛出异常)

Bundle-ManifestVersion: 2
Bundle-SymbolicName: my.javax.servlet
Bundle-Version: 1.2.0
Export-Package: javax.servlet; javax.servlet.http; version="2.4.0";
bundle-symbolic-name="my.javax.servlet"; bundle-version="1.2.0"

同时在Import-Package的时候指定bundle-symbolic-name和bundle-version:

Import-Package: javax.servlet; bundle-symbolic-name="my.javax.servlet"; bundle-version="[1.2.0,1.2.0]"

注意应该尽量避免implicit exported package,因为正常的Export-Package 属性也可以完成类似的工作。

Mandatory directive用于指定Export-Package中,Import-Package在进行bundle 匹配的时候必须进行匹配的属性,如果属性不存在或者匹配不上,那么将不会import 这个package。比如下面的例子:

Export-Package: javax.servlet; version="2.4.1"; private="true";
mandatory:="private"

那么在Import-Package的时候必须指定这个private属性才能import成功:

Import-Package: javax.servlet; version="[2.4.0,2.5.0)"; private=true

Exclude Directive用于从Export-Package中过滤掉(屏蔽)一些类,如下,org.foo.service.Util将不会被导出,Exclude Directive支持通配符*:

Export-Package: org.foo.service; version="1.0.0"; exclude:="Util"

同样Include Directive用于指定Export-Package中进行导出的类:

Export-Package: org.foo.service; version="1.0.0"; include:="Service*"

Duplicate Export和Include Directive, Export Directive结合用于实现向不同的bundle导出不同的类。

resolution directive用于表明依赖是可选的,在没有Bundle export相应的package情况下也能完成bundle resolve过程,ClassNotFoundException,找不到这些类的情况下该bundle 也可以正常完成工作,比如一些日志服务类。

Dynamic Import 用于解决SPI问题。

DynamicImport-Package: javax.servlet.*; version="2.4.0"

DynamicImport-Package和resolution:=optional有以下两点相同之处 :

Optional/dynamic imports never cause a bundle to be unable to resolve.
Your bundle code must be prepared to catch ClassNotFoundException s for the optionally/dynamically imported packages.

 

Require-Bundle: 用于导入另一个bundle中所有的Export-Package。

关于存在Require-Bundle时候的类搜索顺序:

1、如果类名以java.开头,那调用父加载器进行加载,如果找不到将抛出ClassNotFoundException等异常。

2、如果这个类属于Import-Package中的一员,那么,委托给对应的外部的Bundle进行加载。

3、如果这个类属于Require-Bundle中的,那么将从Require-Bundle目标中进行搜索,如果找到了即返回,如果没有找到则继续从下一个Require-Bundle目标开始搜索。

4、如果3中找不到的话,从Bundle-ClassPath中搜索。如果没有找到的话继续步骤5

5、如果类所在的包isn't exported or required(这里的意思不是很清楚)的话,开始对DynamicImport-Package进行匹配,如果匹配到了,则委托给export这个package的Bundle。如果找到了,则返回,如果最后还是找不到只好抛出异常了。

同样Require-Bundle也可以使用resolution:="optional" directive,并且可以使用visibility进行reexport,比如A require-bundle B那么B中的Export-Package将会添加在Bundle A的Export-Package列表中。

最后一个特性是Fragment Bundle,在Fragment Bundle中,有Host和Fragment两种角色,Host Bundle中对Fragment Bundle是不可知的,但Fragment Bundle中必须声明它所属于的Host Bundle(通过Fragment-Host):(注意只能声明一个Host Bundle,不能声明多个)

Fragment-Host: org.foo.hostbundle; bundle-version="[1.0.0,1.1.0)"

Host Bundle中无须声明任何关于Fragment Bundle的信息,没有Fragment-Host声明的Bundle默认就是一个Host Bundle。

另外Fragment Bundle中不能定义Bundle-Activator,因为它不是一个独立的bundle。它必须依存于Host Bundle。

注意,Fragment-Bundle和Host Bundle使用同一个ClassLoader

最终在查找类的时候的搜索顺序:

1、如果类名以java.开头,那调用父加载器进行加载,如果找不到将抛出ClassNotFoundException等异常。

2、如果这个类属于Import-Package中的一员,那么,委托给对应的外部的Bundle进行加载。

3、如果这个类属于Require-Bundle中的,那么将从Require-Bundle目标中进行搜索,如果找到了即返回,如果没有找到则继续从下一个Require-Bundle目标开始搜索。

4、如果3中找不到的话,从Bundle-ClassPath中搜索。如果没有找到的话继续步骤5

5、搜索已经installed的Fragment Bundle的Class path,如果查找到了则返回,如果没有找到则继续直到查找完所有的Fragment Bundle,如果最后仍然没有找到则开始步骤6

6、 如果类所在的包isn't exported or required(这里的意思不是很清楚)的话,开始对DynamicImport-Package进行匹配,如果匹配到了,则委托给export这个 package的Bundle。如果找到了,则返回,如果最后还是找不到只好抛出异常了。

转载于:https://www.cnblogs.com/mosmith/p/5465489.html

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/weixin_30871905/article/details/98532057

智能推荐

时序约束——set_max_delay和set_min_delay用法-程序员宅基地

文章浏览阅读6.8k次,点赞2次,收藏57次。实现约束_set_max_delay

在Linux下使用RAID(1):介绍 RAID 的级别和概念_在 linux 下使用 raid(一):介绍 raid 的级别和概念-程序员宅基地

文章浏览阅读289次。RAID 的意思是廉价磁盘冗余阵列(Redundant Array of Inexpensive Disks),但现在它被称为独立磁盘冗余阵列(Redundant Array of Independent Drives)。早先一个容量很小的磁盘都是非常昂贵的,但是现在我们可以很便宜的买到一个更大的磁盘。Raid 是一系列放在一起,成为一个逻辑卷的磁盘集合。 伦理片 http://www.dot_在 linux 下使用 raid(一):介绍 raid 的级别和概念

java计算机毕业设计课程答疑系统源程序+mysql+系统+lw文档+远程调试_一梵程序-程序员宅基地

文章浏览阅读92次。java计算机毕业设计课程答疑系统源程序+mysql+系统+lw文档+远程调试。前端技术:Layui、HTML、CSS、JS、JQuery等技术。ssm基于SSM+VUE技术的小区车辆档案车位管理系统设计与实现。springboot基于SpringBoot的自助旅游导航系统。springboot基于springboot的社会公益平台。JSP+sql图书管理系统(源程序+论文+数据库+录像)ssm+sqlserver海城同泽中学图书仓库管理系统。ssm+sqlserver长大工院竞赛系统。_一梵程序

java 16.数组-程序员宅基地

文章浏览阅读80次。数组数组元素数组是一种最简单的复合数据类型,它是有序数据的集合,数组中的每个元素具有相同的数据类型,可以用一个统一的数组名和不同的下标来唯一确定数组中的元素。根据数组的维度,可以将其分为一维数组、二维数组和多维数组等。总的来说,数组具有以下特点:数组可以是一维数组、二维数组或多维数组。数值数组元素的默认值为 0,而引用元素的默认值为 null。交错数组是数组的数组,..._java数组16

vue 3.0中设置网页title_vue3设置title-程序员宅基地

文章浏览阅读2.7k次,点赞2次,收藏2次。(1)main.js创建自定义指令。(2)vue页面中使用。_vue3设置title

python爬虫遇到中文乱码问题(ISO-8859-1)_python 乱码 ò ¢-程序员宅基地

文章浏览阅读4.6k次,点赞4次,收藏12次。python爬虫遇到中文乱码(ISO-8859-1)直接入正题,今天爬虫遇到中文乱码问题,具体大概如下:ÕбêÈË»òÆäÕбê´úÀí»ú¹¹Ó¦µ±¶ÔÆäÌá¹µÄÕб깫¸æµÄÕæʵÐÔ¡¢×¼È·ÐÔ¡¢ºÏ·¨ÐÔ¸ºÔð¡£(这种的字符)找问题所在,首先查看response的编码问题response = request.get(url,headers)print(response.encoding)输出内容:这就好办了,直接编码解码(使用utf_python 乱码 ò ¢

随便推点

在Ubuntu 12.04 64 位 搭载Android4.4源码编译环境-程序员宅基地

文章浏览阅读67次。在Ubuntu 12.04 64 位 搭载Android4.4源码编译环境 一、准备工作:(1) VMare Workstation 10(2)Ubuntu12.04 64bit(3) JDK1.6(4)Android 4.4 源码(PS:...

图像数据增广_图像增广-程序员宅基地

文章浏览阅读1.2k次,点赞19次,收藏24次。本文主要介绍了图像数据的几种增广方式,其中包括随机翻转、随机裁剪和随机颜色变换等,使用时一般在训练集上综合使用以达到鲁棒效果。_图像增广

8种编程语言对比,究竟谁更好用_算法用什么语言写比较好-程序员宅基地

文章浏览阅读977次。8种编程语言对比,究竟谁更好用_算法用什么语言写比较好

数据库oracle实际使用的内存---AIX产生大量的swap反思_oracle数据库内存64,sga40,会占用swap吗-程序员宅基地

文章浏览阅读796次。来看看oracle实际使用的内存:select sum(pga_alloc_mem)/1024/1024/1024 Alloc from v$process ; +select sum(value)/1024/1024/1024 as b from v$sga + 进程本身消耗的内存。操作系统频繁使用swap,原因基本是系统内存不够用了。从数据库的内存配置来看,128G总内..._oracle数据库内存64,sga40,会占用swap吗

Matlab 仿真——直流电机速度控制(1)直流电机建模_直流电机系统建模matlab-程序员宅基地

文章浏览阅读2.2w次,点赞31次,收藏228次。Matlab 仿真——直流电机速度控制(1)直流电机建模(搬运自:https://ctms.engin.umich.edu/CTMS/index.php?example=MotorSpeed&section=SystemModeling)该系列我们学习如何对直流电机进行速度控制物理模型一个直流电机模型如下所示:为了简化讨论,假设转子和转轴都是刚体,转子受到的磁场恒定,转子受到的摩擦为粘性摩擦,即受到的摩擦力与速度成正比。假设该电机的物理参数为:(J) 转子的转动惯量 _直流电机系统建模matlab

震惊!国内常见的14款低代码平台-程序员宅基地

文章浏览阅读2.1k次。Astro轻应用(Astro Zero,简称AstroZero)是零代码和低代码应用开发平台,源于华为应用开发和数字化转型的实践,提供了云上无码化、低码化、支持多码化的应用开发模式,屏蔽了技术的复杂性,提升了企业开发的效率。开放和透明,低代码平台最大的风险是技术锁定和黑盒,作为开发者我们自己也不喜欢封闭的低代码平台,因此爱速搭重视开放性,前端方面渲染器开源了,后端方面也选择了开发人员最熟悉的传统数据库技术,没有中间层,对开发者是透明的,并且爱速搭后端不依赖任何云厂商,可以部署到任意环境。_低代码平台

推荐文章

热门文章

相关标签