manifest go manifest公文

转载

索姆拉 2024-05-17 07:35:20

文章标签 manifest go Java SUN EXT 编程 文章分类 架构后端开发

在打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 
activation.jar

Class-Path表示基于其他的2个jar包，并且以空格隔开表示有个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.) activation.jar

Manifest for  impDB.jar : 
       Manifest-Version:1.0
        Created-By:1.5.08 (Sun   Microsystems   Inc.) .jar
       Main-Class: com.pantosoft.impdb.ImpMain 

Manifest for  ExpDB.jar : 
       Manifest-Version:1.0
        Created-By:1.5.08 (Sun   Microsystems   Inc.) .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 技巧：