MANIFEST.MF文件全面解析 - 千年宝虫

时间：2024-03-06 22:39:56

MANIFEST.MF文件全面解析

（一）简介

        

        当我们用Jar命令打完包后，会在根目录下面创建META-INF目录，该目录下面会有一些对该Jar包信息的描述，其中肯定会有一个MANIFEST.MF文件，该文件包含了该Jar包的版本、创建人和类搜索路径等信息，当然如果是可执行Jar包，会包含Main-Class属性，表明Main方法入口。下面是httpclient.jar中的MANIFEST.MF内容：

Manifest-Version: 1.0

Implementation-Title: HttpComponents Apache HttpClient

Implementation-Version: 4.3.1

Built-By: oleg

Specification-Vendor: The Apache Software Foundation

Created-By: Apache Maven 3.0.5

url: http://hc.apache.org/httpcomponents-client

X-Compile-Source-JDK: 1.5

Implementation-Vendor: The Apache Software Foundation

Implementation-Vendor-Id: org.apache

Build-Jdk: 1.7.0_21

Specification-Title: HttpComponents Apache HttpClient

Specification-Version: 4.3.1

Implementation-Build: tags/4.3.1-RC2/httpclient@r1528975; 2013-10-03 2

1:09:33+0200

X-Compile-Target-JDK: 1.5

Archiver-Version: Plexus Archiver

 （二）格式规则

  • 基本格式  属性名称：(空格)属性值 ;
  • 每行最多72个字符，换行继续必须以空格开头 ;
  • 文件最后一定是空行 ;
  • Class-Path 当前路径是jar包所在目录，如果要引用当前目录下一个子目录中的jar包，使用以下格式  子目录/jar包名称 子目录/jar名称,注意多个jar包之间用空格分隔, 在任何平台上路径分割符都是 /;

（三）内容分类

     如果我们把MANIFEST中的配置信息进行分类，可以归纳出下面几个大类：

      （1）一般属性

  • Manifest-Version   用来定义manifest文件的版本，例如：Manifest-Version: 1.0
  • Created-By   声明该文件的生成者，一般该属性是由jar命令行工具生成的，例如：Created-By: Apache Ant 1.5.3
  •   Signature-Version   定义jar文件的签名版本
  • Class-Path  应用程序或者类装载器使用该值来构建内部的类搜索路径

      （2）应用程序相关属性

  • Main-Class   定义jar文件的入口类，该类必须是一个可执行的类，一旦定义了该属性即可通过 java -jar xxx.jar来运行该jar文件。

       （3）包扩展属性

  • Implementation-Title     定义了扩展实现的标题
  • Implementation-Version  定义扩展实现的版本
  • Implementation-Vendor  定义扩展实现的组织
  • Implementation-Vendor-Id    定义扩展实现的组织的标识
  • Implementation-URL 定义该扩展包的下载地址(URL)
  • Specification-Title    定义扩展规范的标题
  •  Specification-Version      定义扩展规范的版本
  • Specification-Vendor      声明了维护该规范的组织
  • Sealed 定义jar文件是否封存，值可以是true或者false (这点我还不是很理解)

      （4）小程序(Applet)相关属性

  • Extendsion-List该属性指定了小程序需要的扩展信息列表，列表中的每个名字对应以下的属性
  • <extension>-Extension-Name    定义了Jar文件的唯一标识
  • <extension>-Specification-Version    定义扩展规范的版本
  • <extension>-Implementation-Version     定义了扩展实现的版本
  • <extension>-Implementation-Vendor-Id    定义了扩展实现的供应商版本编号
  • <extension>-Implementation-URL    该jar文件最新版本的下载地址

      （5）扩展标识属性

  • Extension-Name该属性定义了jar文件的唯一标识符

      （6）签名相关属性

 签名方面的属性我们可以来参照JavaMail所提供的mail.jar中的一段

Name: javax/mail/Address.class

Digest-Algorithms: SHA MD5

SHA-Digest: AjR7RqnN//cdYGouxbd06mSVfI4=

MD5-Digest: ZnTIQ2aQAtSNIOWXI1pQpw==

这段内容定义类签名的类名、计算摘要的算法名以及对应的摘要内容(使用BASE方法进行编码)

 

        （7）自定义属性

 除了前面提到的一些属性外，你也可以在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

 

（四）MANIFEST.MF信息的获取

 现在我们要获取ant.jar中的MANIFEST.MF文件的信息，那么我们可以通过java.util.jar这个类库来获取，代码如下：

       Java代码 

  1. package me.simplecd;  
  2.   
  3. import java.io.File;  
  4. import java.util.Map;  
  5. import java.util.jar.Attributes;  
  6. import java.util.jar.JarFile;  
  7. import java.util.jar.Manifest;  
  8. publicclass ManifestUtil {  
  9.     publicstaticvoid main(String[] args) throws Exception {  
  10.        JarFile jar=new JarFile(new File("F:\\workspace\\simplecd\\WebContent\\WEB-INF\\lib\\ant.jar"));  
  11.        Manifest manifest = jar.getManifest();  
  12.        Attributes mainAttributes = manifest.getMainAttributes();  
  13.        for(Map.Entry<Object, Object> attrEntry : mainAttributes.entrySet()){         System.out.println("main\t"+attrEntry.getKey()+"-->"+attrEntry.getValue());  
  14.        }  
  15.        Map<String, Attributes> entries = manifest.getEntries();  
  16.        for(Map.Entry<String, Attributes> entry : entries.entrySet()){  
  17.            Attributes values = entry.getValue();  
  18.            for(Map.Entry<Object, Object> attrEntry : values.entrySet()){  
  19.             System.out.println(attrEntry.getKey()+"-->"+attrEntry.getValue());  
  20.            }  
  21.        }  
  22.     }  
  23. }  

 

Ant.jar下面的MANIFEST.MF文件内容如下：

Manifest-Version: 1.0

Ant-Version: Apache Ant 1.9.2

Created-By: 1.6.0_27-b27 (Sun Microsystems Inc.)

Main-Class: org.apache.tools.ant.Main

 

Name: org/apache/tools/ant/

Extension-name: org.apache.tools.ant

Specification-Title: Apache Ant

Specification-Version: 1.9.2

Specification-Vendor: Apache Software Foundation

Implementation-Title: org.apache.tools.ant

Implementation-Version: 1.9.2

Implementation-Vendor: Apache Software Foundation

 

我们运行上面代码所得结果如下：

main   Ant-Version-->Apache Ant 1.9.2

main   Manifest-Version-->1.0

main   Created-By-->1.6.0_27-b27 (Sun Microsystems Inc.)

main   Main-Class-->org.apache.tools.ant.Main

Implementation-Vendor-->Apache Software Foundation

Implementation-Title-->org.apache.tools.ant

Specification-Title-->Apache Ant

Implementation-Version-->1.9.2

Specification-Version-->1.9.2

Extension-name-->org.apache.tools.ant

Specification-Vendor-->Apache Software Foundation

很明显空行上面的属性是通过Manifest类中的getMainAttributes方法获取的(运行结果红色的部分)，它是该文件中的主要信息，另外的是通过getEntries获取的(运行结果中蓝色的部分)。