OSGi 系列(三)之 bundle 详解
OSGi 系列(三)之 bundle 详解
1. 什么是 bundle
bundle 是以 jar 包形式存在的一个模块化物理单元,里面包含了代码,资源文件和元数据(metadata),并且 jar 包的物理边界也同时是运行时逻辑模块的封装边界。
2. MANIFEST.MF 规范
位置:META-NF/MANIFEST.MF
文件格式
- 属性声明的一般格式是 name: value
- 一行不超过 72 个字符,下一行则由单个空格字符开始
3. bundle 常用标识符
标识符 | 说明 |
---|---|
Bundle-Category | 描述用逗号分隔的分类名称 |
Bundle-Activator | 启动和停止 bundle 的类名称 |
Bundle-Classpath | 定义用逗号分隔的路径,包含的内容有 JAR 文件和包含类和资源的目录(bundle内部) .点号代表 JAR 文件的根目录,同时也是默认的 |
Bundle-Copyright | 描述 bundle 的版权信息 |
Bundle-Description | 对 bundle 的描述信息 |
Bundle-Localization | 描述 bundle 的本地文件地址,默认值是 OSGI-INF/l10n/bundle |
Bundle-ManifestVers | on |
Bundle-Name | 定义了一个具有可读性的名字来标识 bundle。应该是一个简短易读没有空格的名 |
bundle-SymbolicName | (必须)提供了 bundle 的一个全局的惟一的标志符 |
Bundle-UpdateLocation | 描述 bundle 的更新地址。bundle 需要更新,则使用这个地址进行更新。 |
Bundle-Vendor | 描述 bundle 的发行者信息。 |
Bundle-Version | 描述 bundle 的版本信息。默认值为0.0.0 |
DynamicImport-Package | 包含了一个逗号分隔的动态导入包清单 |
Export-Package | 导出包声明 |
Import-Package | 声明 bundle 导入的包 |
Require-Bundle | 指定 bundle 中需要其他 bundle 导出的内容 |
3.1 Bundle-SymbolicName
Bundle-SymbolicName(符号名称) 是唯一必须指定的。通过 bundle 的符号名称和版本号可以在框架中惟一的确定一个 bundle。也就是说,如果一个 bundle 和另外一个 bundle 有着同样的符号名称和版本号,那么这两个 bundle 就是等价的。
Bundle-Name 是给用户读的,而 Bundle-Symbolicname 是给 OSGi 框架读的,让 OSGi 框架能够唯一标识一个 bundle。
示例:
Bundle-SymbolicName: com.edu.osgi.hellowrod
3.2 Bundle-Version
格式:主版本号(Major) + 副版本号(Minor) + 微版本号(Micro) + 限定符串(Qualifier)
bundle-version: 1.0.0.bate1
- 默认值为:0.0.0
- 主版本号、副版本号、微版本号必须是数字
- 限定字符串可以为空,默认为空
- 版本号是可以进行比较的,比较是根据主版本号、小版本号、微版本号的顺序进行比较。最后是字符串的限定符比较。eg:1.0.0.2016213 > 1.0.0
3.3 Export-Package
标准的 jar 文件默认公开一切内容,而 bundles 默认不公开任何内容 OSGi 通过 Export-Package 公开内容
可以导出多个包,多个用逗号隔开
可以给导出包增加任何属性,以区分导出包
导出的包 version 默认为 0.0.0
Export-Package: com.edu.api
Export-Package: com.edu.api;version="1.0.0"
Export-Package: com.edu.api,com.edu.util;version="1.0.0"
当导出一个包的时候,默认导出该包的所有类、接口。可以设置过滤条件:include 包含;exclude 排除
Export-Package: com.edu.api;include:="*Service"
Export-Package: com.edu.api;exclude:="*Impl"
3.4 Import-Package
OSGi 要求 bundle 显示声明对外部代码的依赖:
不能导入 java.*
导入一个包,不会导入它的子包
通过增加属性导入特定的包
Import-Package: com.edu.api
Import-Package: com.edu.api;version="1.0.0"
Import-Package 版本过滤:
语法 含义 [min,max) min<=x<max [min,max] min<=x<=max (min,max] min<x<=max (min,max) min<x<max min min<=x [1.0.0,1.0.0] 精确指定一个版本 Import-Package: com.edu.api;version="[1.0.0,2.0.0)"
Import-Package: com.edu.api;version="1.0.0"
Import-Package 属性过滤:
Import-Package: com.edu.api;type="apache"
默认情况下 bundle2 虽然没有声明自定义属性 type,但在默认情况下这并不会产生匹配冲突。如果要改变这种情况,可以使用 mandatory 附加参数,强制要求必须存在扩展属性オ能成功匹配。
# bundle1
Import-Package: com.edu.api;type="1";mandatory:="type"
# bundle2
Export-Package: com.edu.api
Export-Package: com.edu.api;type="1"
注意: type 是属性;mandatory 是 OSGi 的指令,指令前必须加 ":"
Import-Package 可选导入:
在大多数情况下,导入某个 Package,就说明当前这个 bundle 的正常运行是必须依赖导入的 Package 的。但还有另外一些场景导入某个 Package 是为了实现一些不影响 Bundle 正常运行的附加功能,比如 Apache thrift 里面会用到 httpclient。但是只是在特殊情況下才会用到,此时就不需要强行依赖 httpclient 了。
# resolution 可选值 mandatory(默认) 和 optional
Import-Package: com.edu.api;resolution:="optional"
3.5 DynamicImport-Package
定义需要动态导入的包。这部分定义没有在 bundle 解析过程中使用,而是在运行时动态解析并加载共享包。
动态导入和可选导入实现的功能有些类似,它们的共同特征是在 bundle 解析期间即使找不到要导入的依赖,也不会导致解析失败。它们的区别是,动态导入每次加载包中的类都会尝试去查找动态导入包,而可选导入包只有在 bundle 解析时才进行连接尝试
DynamicImport-Package: *
DynamicImport-Package: com.edu.*;type=1
不推荐使用,尽量用 Import-Package。
3.6 Bundle-Classpath
Bundle-Classpath 标记有默认值 ".",它代表该 bundle 的根目录,或者说代表该 Bundle 的 JAR 文件
可以设置多个,多个用逗号隔开
一旦定义了 Bundle-Classpath 就需要显示加入 "."
按照声明的顺序搜索 bundle 类路径条目
Bundle-Classpath: .,lib/xxx.jar
一般用于非 bundle 包的引用,不推荐使用,违反了 bundle 的使用原则。
4. 系统 bundle
- 系统 bundle 的 bundle ID 为 0
- 系统 bundle 的 getLocation() 返回的是字符串 "System Bundle"
- BundleContex.getBundle(0) 或 BundleContex.get("SystemBundle") 方法中获取到系统 bundle 的对象实例
- 系统 bundle 的启动级别固定为 0,且不能修改
5. bundle 依赖的常见错误
java.lang.ClassNotFoundException
bundle 没有导入相应的包,或有导入,但被 include/exclude 限制
org.osgi.framework.BundleException: Unable to resolvecom.edu.osgi bank
bundle 有导入,但没有其它的 bundle 导出该包
6. bundle 生成插件
6.1 maven-jar-plugin
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.4</version>
<configuration>
<archive>
<manifestEntries>
<Bundle-ManifestVersion>2</Bundle-ManifestVersion>
<Bundle-SymbolicName>com.github.binarylei.demo-osgi</Bundle-SymbolicName>
<Bundle-Version>1.0.0</Bundle-Version>
<Import-Package>org.osgi.framework</Import-Package>
<Bundle-Activator>com.github.binarylei.HelloBundleActivator</Bundle-Activator>
</manifestEntries>
</archive>
</configuration>
</plugin>
6.2 maven-bundle-plugin
7. bundle 的生命周期
OSGi 系列(三)之 bundle 详解的更多相关文章
- Hexo系列(三) 常用命令详解
Hexo 框架可以帮助我们快速创建一个属于自己的博客网站,熟悉 Hexo 框架提供的命令有利于我们管理博客 1.hexo init hexo init 命令用于初始化本地文件夹为网站的根目录 $ he ...
- elasticsearch系列三:索引详解(分词器、文档管理、路由详解(集群))
一.分词器 1. 认识分词器 1.1 Analyzer 分析器 在ES中一个Analyzer 由下面三种组件组合而成: character filter :字符过滤器,对文本进行字符过滤处理,如 ...
- PE文件学习系列三-PE头详解
合肥程序员群:49313181. 合肥实名程序员群:128131462 (不愿透露姓名和信息者勿加入) Q Q:408365330 E-Mail:egojit@qq.com 最近比较忙 ...
- Android——Android Bundle详解(转)
Android Bundle详解 1 Bundle介绍 Bundle主要用于传递数据:它保存的数据,是以key-value(键值对)的形式存在的. 我们经常使用Bundle在Activity之间传递数 ...
- ASP.NET MVC深入浅出系列(持续更新) ORM系列之Entity FrameWork详解(持续更新) 第十六节:语法总结(3)(C#6.0和C#7.0新语法) 第三节:深度剖析各类数据结构(Array、List、Queue、Stack)及线程安全问题和yeild关键字 各种通讯连接方式 设计模式篇 第十二节: 总结Quartz.Net几种部署模式(IIS、Exe、服务部署【借
ASP.NET MVC深入浅出系列(持续更新) 一. ASP.NET体系 从事.Net开发以来,最先接触的Web开发框架是Asp.Net WebForm,该框架高度封装,为了隐藏Http的无状态模 ...
- 【C/C++开发】C++11 并发指南三(std::mutex 详解)
本系列文章主要介绍 C++11 并发编程,计划分为 9 章介绍 C++11 的并发和多线程编程,分别如下: C++11 并发指南一(C++11 多线程初探)(本章计划 1-2 篇,已完成 1 篇) C ...
- Spring第三天,详解Bean的生命周期,学会后让面试官无话可说!
点击下方链接回顾往期 不要再说不会Spring了!Spring第一天,学会进大厂! Spring第二天,你必须知道容器注册组件的几种方式!学废它吊打面试官! 今天讲解Spring中Bean的生命周期. ...
- [转]hibernate三种状态详解
本文来自 http://blog.sina.com.cn/u/2924525911 hibernate 三种状态详解 (2013-04-15 21:24:23) 转载▼ 分类: hibernate ...
- 多表连接的三种方式详解 hash join、merge join、 nested loop
在多表联合查询的时候,如果我们查看它的执行计划,就会发现里面有多表之间的连接方式.多表之间的连接有三种方式:Nested Loops,Hash Join 和 Sort Merge Join.具体适用哪 ...
随机推荐
- python3解析XML文件
软硬件环境 Ubuntu 15.10 32bit Python 3.5.1 PyQt 5.5.1 前言 Python解析XML的方法挺多,本文主要是利用ElementTree来完成. 实例讲解 解析X ...
- oracle一个用户操作多个表空间中表的问题
首先,授权给指定用户. 一个用户的默认表空间只能有一个,但是你可以试下用下面的语句为其授权在别的表空间中创建对像: alter user username quota 0||unlimited on ...
- 19.OGNL与ValueStack(VS)-OGNL入门
转自:https://wenku.baidu.com/view/84fa86ae360cba1aa911da02.html 下面我们在com.asm.vo.User类中增加一个字段private Ad ...
- 1.Redis的应用场景
转自:http://www.runoob.com/redis/redis-tutorial.html Redis开创了一种新的数据存储思路,使用Redis,我们不用在面对功能单调的数据库时,把精力放在 ...
- Spring Boot @Trasactionl 失效, JDK,CGLIB动态代理
来自: https://www.cnblogs.com/sweetchildomine/p/6978037.html?utm_source=itdadao&utm_medium=referra ...
- Python之风湿理论值函数即变量
一,风湿历练:函数即变量,这样执行程序是不会报错的 def foo(): print ("from foo") bar() def bar(): print "form ...
- 搭建Turbine时,报错误:Property or field 'default' cannot be found on object of type 'com.netflix.appinfo.InstanceInfo'
Spring Boot + Eureka Server + Hystrix with Turbine: empty turbine.stream 配置的时候遇到了问题: Property or fie ...
- 转载 JS组件Bootstrap Select2使用方法详解
JS组件Bootstrap Select2使用方法详解 作者:懒得安分 字体:[增加 减小] 类型:转载 时间:2016-01-26我要评论 这篇文章主要为大家介绍了JS组件Bootstrap Sel ...
- node系列:全局与本地
查看:默认和当前的 全局与本地 全局路径:npm config get prefix 本地路径:npm config get cache 修改 修改就会创建对应目录(文件夹) 修改本地路径:npm c ...
- nginx配置【转】
转自:http://www.ha97.com/5194.html #定义Nginx运行的用户和用户组user www www; #nginx进程数,建议设置为等于CPU总核心数.worker_proc ...