MANIFEST.MF文件全面解析和简单的实战用途

                                                        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-Name 定义了Jar文件的唯一标识 -Specification-Version 定义扩展规范的版本 -Implementation-Version 定义了扩展实现的版本 -Implementation-Vendor-Id 定义了扩展实现的供应商版本编号 -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代码

package me.simplecd; 
import java.io.File; 
import java.util.Map; 
import java.util.jar.Attributes; 
import java.util.jar.JarFile; 
import java.util.jar.Manifest; 
publicclass ManifestUtil { 
        publicstaticvoid main(String[] args) throws Exception {
        JarFile jar=new JarFile(new File("F:\\workspace\\simplecd\\WebContent\\WEB-INF\\lib\\ant.jar")); 
        Manifest manifest = jar.getManifest();
        Attributes mainAttributes = manifest.getMainAttributes(); 
        for(Map.Entry attrEntry : mainAttributes.entrySet()){ 
        System.out.println("main\t"+attrEntry.getKey()+"-->"+attrEntry.getValue());
        }
        Map entries = manifest.getEntries(); 
        for(Map.Entry entry : entries.entrySet()){ 
        Attributes values = entry.getValue(); 
        for(Map.Entry attrEntry : values.entrySet()){
        System.out.println(attrEntry.getKey()+"-->"+attrEntry.getValue()); 
        }
        }
         }
       }
  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

      

                                                  MANIFEST.MF的用途

可以用的上的有:

    1. Main-Class 指定程序的入口,这样可以直接用java -jar xxx.jar来运行程序。

    2. Class-Path 指定jar包的依赖关系,class loader会依据这个路径来搜索class。

我平时用mf文件一般说来都是让jar成为可以直接运行这一目的。虽然目的这么简单,但是每次打包还是很容易出现各种各样的问题让人头痛。mf总是没有被应用,或者是出错了。

首先给出一个简单而标准的例子:

Manifest-Version: 1.0
Main-Class: ui.JFrameMain
Class-Path: jtds-1.2.jar c3p0-0.9.1.2.jar 
esri_mo20.jar esri_mo20res.jar jsde83_sdk.jar

解释一下:

Manifest-Version mf文件版本号,这行照抄

Main-Class 包含main函数的类,程序的入口

Class-Path 用到的一些包

分析一下要点:

要点1:每行的“:”(冒号)用来分隔键值对。冒号后边一定要跟一个空格!!!

也就是说务必写为:

Main-Class:(空格)YouClassName

Class-Path:(空格)Class1.Jar

否则JBuilder会报("Manifest.mf": Error reading manifest: java.io.IOException: invalid header field
) 这样的错。不再IDE帮助下做的JAR会发现MF没有起到应有的作用。顺便说一下以前我看到JBuilder报另一个个错大概说是什么换行符不对,好像也 是由于这个问题引发的。原先总以为是windows里边的回车是由回车,换行2个字符构成而造成的。现在看来好像不是这样,是因为少了冒号后边那个空格。

要点2:Class-Path里边的内容用空格分隔而不是逗号或者分号。(唉。。。我总是下意识的用分号)

也就是说务必写成:

Class-Path:(空格)Class1.jar(空格)Class2.jar(空格)Class3.Jar

要点3:有的文章说MF文件每行不能超过七十多的字符,我的经验是如果在JBuilder里编辑MF超过了也无妨,一般我是尽量一行写完。续行挺麻烦又要以空格开头什么的。我也经常直接用winRar打开jar然后直接编辑里边的mf文件,这是个好方法,很直接了当,缺点就是如果改坏了也不会报错,只是MF有的部分失效了,好像运行时也会说"错误的MF文件版本"。

介绍几个技巧:

技巧1:使用winRar打开jar,双击MF文件,就可以编辑了,编辑完了Ctrl+S保存。特方便。也可以在外边写好一个Manifest.mf,然后直接拖入覆盖以前的。

技巧2:写一个run.bat来运行你的jar。run.bat大体内容如下:

java -jar yours.jar

pause

后边加一个pause就可以让你看到具体哪里出错了,一般来说问题如果出在MF上,那么往往就是哪个包,哪个类没有找到的NoClassDef这种异常。

转载于:https://my.oschina.net/QAAQ/blog/755006

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值