JAR 包中的 MANIFEST.MF 文件详解以及编写规范
参考百度百科的解释如下:
http://baike.baidu.com/item/MANIFEST.MF
MANIFEST.MF:这个 manifest 文件定义了与扩展和包相关的数据。单词 “manifest” 的意思是 “显示”
打开 Java 的 JAR 文件我们经常可以看到文件中包含着一个 META-INF 目录,这个目录下会有一些文件,其中必有一个 MANIFEST.MF,这个文件描述了该 Jar 文件的很多信息,下面将详细介绍 MANIFEST.MF 文件的内容,先来看 struts.jar 中包含的 MANIFEST.MF 文件内容:
Manifest-Version: 1.0
Created-By: Apache Ant 1.5.1
Extension-Name: Struts Framework
Specification-Title: Struts Framework
Specification-Vendor: Apache Software Foundation
Specification-Version: 1.1
Implementation-Title: Struts Framework
Implementation-Vendor: Apache Software Foundation
Implementation-Vendor-Id: org.apache
Implementation-Version: 1.1
Class-Path: commons-beanutils.jar commons-collections.jar commons-digester.jar commons-logging.jar commons-validator.jar jakarta-oro.jar struts-legacy.jar
如果我们把 MANIFEST 中的配置信息进行分类,可以归纳出下面几个大类:
一。一般属性
1. Manifest-Version
用来定义 manifest 文件的版本,例如:Manifest-Version: 1.0
2. Created-By
声明该文件的生成者,一般该属性是由 jar 命令行工具生成的,例如:Created-By: Apache Ant 1.5.1
3. Signature-Version
定义 jar 文件的签名版本
4. Class-Path
应用程序或者类装载器使用该值来构建内部的类搜索路径
二。应用程序相关属性
1. Main-Class
定义 jar 文件的入口类,该类必须是一个可执行的类,一旦定义了该属性即可通过 java -jar x.jar 来运行该 jar 文件。
三。小程序 (Applet) 相关属性
1. Extendsion-List
该属性指定了小程序需要的扩展信息列表,列表中的每个名字对应以下的属性
2. <extension>-Extension-Name
3. <extension>-Specification-Version
4. <extension>-Implementation-Version
5. <extension>-Implementation-Vendor-Id
5. <extension>-Implementation-URL
四。扩展标识属性
1. Extension-Name
该属性定义了 jar 文件的标识,例如 Extension-Name: Struts Framework
五。包扩展属性
1. Implementation-Title 定义了扩展实现的标题
2. Implementation-Version 定义扩展实现的版本
3. Implementation-Vendor 定义扩展实现的组织
4. Implementation-Vendor-Id 定义扩展实现的组织的标识
5. Implementation-URL : 定义该扩展包的下载地址 (URL)
6. Specification-Title 定义扩展规范的标题
7. Specification-Version 定义扩展规范的版本
8. Specification-Vendor 声明了维护该规范的组织
9. Sealed 定义 jar 文件是否封存,值可以是 true 或者 false (这点我还不是很理解)
六。签名相关属性
签名方面的属性我们可以来参照 JavaMail 所提供的 mail.jar 中的一段
Name: javax/mail/Address.class
Digest-Algorithms: SHA MD5
SHA-Digest: AjR7RqnN//cdYGouxbd06mSVfI4=
MD5-Digest: ZnTIQ2aQAtSNIOWXI1pQpw==
这段内容定义类签名的类名、计算摘要的算法名以及对应的摘要内容 (使用 BASE64 方法进行编码)
七。自定义属性
除了前面提到的一些属性外,你也可以在 MANIFEST.MF 中增加自己的属性以及响应的值,例如 J2ME 程序 jar 包中就可能包含着如下信息
MicroEdition-Configuration: CLDC-1.0
MIDlet-Name: J2ME_MOBBER Midlet Suite
MIDlet-Info-URL: http://www.javayou.com/
MIDlet-Icon: /icon.png
MIDlet-Vendor: Midlet Suite Vendor
MIDlet-1: mobber,/icon.png,mobber
MIDlet-Version: 1.0.0
MicroEdition-Profile: MIDP-1.0
MIDlet-Description: Communicator
关键在于我们怎么来读取这些信息呢?其实很简单,JDK 给我们提供了用于处理这些信息的 API,详细的信息请见 java.util.jar 包中,我们可以通过给 JarFile 传递一个 jar 文件的路径,然后调用 JarFile 的 getManifest 方法来获取 Manifest 信息。
备注:更详细的说明,参考 oracle 提供的文档:http://docs.oracle.com/javase/1.5.0/docs/guide/jar/jar.html(这个地址其实是有规律的,试下后面的版本号更新到特定的)