java中的manifest文件格式

在打jar包时，我们有时需要对manifest文件进行描述，在这里记录manifest相关的格式，以供日后参考。

manifest基本格式：

manifest 文件的格式 是很简单的，每一行都是 名－值 对应的:属性名开头，接着是 ":" ，然后是属性值，每行最多72个字符，如果需要增加，你可以在下一行续行，续行以空格开头，以空格开头的行都会被视为前一行的续行，所有在开头的属性都是全局的。

有main函数的jar包的manifest的格式：

       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)

       Main-Class: com.pantosoft.impdb.ImpMain

       Manifest-Version表示使用1.0的manifest文件

       Created-By表示使用了的sun的1.5.08的jar生成

       Main-Class表示有主函数的类

基于其他jar并有main函数的manifest的格式：

       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)

       Main-Class: com.pantosoft.impdb.ImpMain

       Class-Path:mail.jar activation.jar

       Class-Path表示基于其他的2个jar包，并且以空格隔开表示有个jar包。如有路径，侧表示如下：

       Class-Path:ext/mail.jar ext/activation.jar

基于其他jar并有多个main函数的manifest的格式：

还有一种Multiple Main Classes情况，如果你的应用程序可能有命令行版本和GUI版本，或者一些不同的应用共享很多相同的代码，这时你可能有多个Main Class，我们建议你采取这样的策略：把共享的类打成lib包，然后把不同的应用打成不  同的包，分别标志主类：如下

       Manifest for impDB.jar :

       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)

       Class-Path:mail.jar activation.jar

       Manifest for impDB.jar :

       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)

       Class-Path:impDB.jar

       Main-Class: com.pantosoft.impdb.ImpMain

       Manifest for ExpDB.jar :

       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)

       Class-Path:expDB.jar

       Main-Class: com.pantosoft.impdb.ExpMain

       在 impDB.jar 和  ExpDB.jar 的manifest文件中分别注明各自的 Main Class

Package Versioning：

完成发布后，如果使用者想了解 ，哪些代码是谁的？目前是什么版本？使用什么版本的类库？解决的方法很多，manifest提供了一个较好的方法，你可以在manifest文件中描述每一个包的信息。Java 秉承了实现说明与描述分离的原则，package 的描述 定义了package 是什么，实现说明定义了谁提供了描述的实现，描述和实现包含名、版本号和提供者。要得到这些信息，可以查看JVM的系统属性（使用 java.lang.System.getProperty() ）在manifest文件中，我可以为每个package定义描述和实现版本，声明名字，并加入描述属性和实现属性，这些属性是：

Specification-Title
Specification-Version
Specification-Vendor
Implementation-Title
Implementation-Version
Implementation-Vendor

当要提供一个类库或编程接口时，描述信息显得是很重要，见以下范例：

Manifest-Version:1.0
Created-By:1.5.08 (Sun   Microsystems   Inc.)
Class-Path: mail.jar activation.jar

Name: com/example/myapp/
Specification-Title: MyApp
Specification-Version: 2.4
Specification-Vendor: example.com
Implementation-Title: com.example.myapp
Implementation-Version: 2002-03-05-A
Implementation-Vendor: example.com

Package Version 查询：

在manifest文件中加入package描述后，就可以使用Java提供的java.lang.Package class进行Package 的信息查询，这里列举3个最基本的获取package object的方法：

1.Package.getPackages():返回系统中所有定义的package列表
2.Package.getPackage(String packagename):按名返回package
3.Class.getPackage():返回给定class所在的package

使用这方法就可以动态的获取package信息. 需要注意的是如果给定的package中没有class被加载,则也无法获得package 对象

Manifest 技巧：

1. 总是以Manifest-Version属性开头
2. 每行最长72个字符，如果超过的化，采用续行
3. 确认每行都以回车结束，否则改行将会被忽略
4. 如果Class-Path 中的存在路径，使用"/"分隔目录，与平台无关
5. 使用空行分隔主属性和package属性
6. 使用"/"而不是"."来分隔package 和class ,比如 com/example/myapp/
7. class 要以.class结尾，package 要以 / 结尾