MANIFEST文件语法介绍

*MF概述

      MANIFEST.MF文件(以下简称MF), 记录jar文件的元信息, 它的文件格式类似properties文件的key-value.同时, OSGi对MF的属性进行了扩展, 这些扩展信息提供给OSGi框架处理, 这样一个普通的jar就成为一个OSGi管理下的bundle.

      此文的目的, 是介绍MF文件的语法格式, 和一些OSGi下的特殊表示(如属性的指令).

 

*MF语法说明

---标准MF和OSGi扩展MF

1)标准MF格式, Property-Name: value

提醒: 属性名后的冒号和属性值之间, 留有一个空格.

2)OSGi的MF格式, Property-Name: clause(, clause)*

clause ::= target(;parameter)*(,target2(;parameter)*)*

parameter ::= attribute=value | directive:=value

说明如下:

这里的target表示Property-Name对应的值, 语法上target之间用逗号分割, target内部参数用分号分割;每一个target可能会有一些相关的参数,

这些参数有两种表示格式, 一种称为属性(attribute), 一种称为指令(derective);

attribute表示的含义是一般的key/value表示, 如Export-Package: org.osgi.framework.hooks.service;uses:="org.osgi.frame

work";version="1.0"中的version就是'org.osgi.framework.hooks.service'这个target的一个属性. 需要注意的是属性的value加上引号, 否则value中有空格等情况会解析错误.

而directive是和osgi处理相关的信息, 如Bundle-SymbolicName: osgi.core;singleton:=true中的'singleton:=true'就表示'osgi.core'的一个指令.

3)OSGi的MF简写格式, 用于简化不同target有相同参数的情况, 格式如下:  clause ::= target;(target;)*parameter(;parameter)*

说明, 多个target可以写在一起, 之间用分号隔离, 这样子后面的参数就是这些target共享的.

 

*注意事项

---属性名规范:

不区分大小写;

name可以是字母,数字,下划线('_'),连字符('-');

---单行不能超过72个字符; 超过时另起一行并必须以一个空格开始, 表示和上一行连接在一起;

 

*示例, '#'后内容是注释说明, 用于说明前面的内容, MF没有注释语法

Manifest-Version: 1.0 　　　　#'1.0'之前一定需要一个空格
Created-By: 1.5.0_11 (Sun Microsystems Inc.)
Bundle-License: http://opensource.org/licenses/apache2.0.php; link="ht
 tp://www.apache.org/licenses/LICENSE-2.0"; description="Apache Licens
 e, Version 2.0"
Import-Package: javax.security.auth
Bnd-LastModified: 1251758748937
Export-Package: org.osgi.framework.hooks.service;uses:="org.osgi.frame 　#'uses:'是osgi相关指令, 解决bundle依赖一致性问题
 work";version="1.0",org.osgi.framework;uses:="javax.security.auth.x50
 0";version="1.5",org.osgi.framework.launch;uses:="org.osgi.framework"
 ;version="1.0",org.osgi.service.condpermadmin;uses:="org.osgi.framewo
 rk,org.osgi.service.permissionadmin";version="1.1",org.osgi.service.p　　#'version'是osgi相关参数
 ackageadmin;uses:="org.osgi.framework";version="1.2",org.osgi.service
 .permissionadmin;version="1.2",org.osgi.service.startlevel;uses:="org
 .osgi.framework";version="1.1",org.osgi.service.url;version="1.0"
Bundle-Version: 4.2.0.200908310645
Bundle-Copyright: Copyright (c) OSGi Alliance (2000, 2009). All Rights
  Reserved.
Bundle-Name: osgi.core
Bundle-Description: OSGi Service Platform Release 4 Version 4.2, Core 
 Interfaces and Classes for use in compiling bundles.
Bundle-Vendor: OSGi Alliance
Bundle-ManifestVersion: 2
Bundle-SymbolicName: org.osgi.core;singleton:=true
Tool: Bnd-0.0.356
DynamicImport-Package: *
Bundle-RequiredExecutionEnvironment: J2SE-1.5,
 JavaSE-1.6　　#换行必须以一个空格开始, 之后的内容连接至上一行　　
Bundle-ActivationPolicy: lazy

　　

转载于:https://www.cnblogs.com/bronte/articles/2671040.html