jar文件使用详解

式被广泛使用，因此易与使用，有很多中工具可以操作这种格式的文件。也正是因为这个原因，jar文件本身并不能表达所包含应用程序的标签信息。

　　Manifest 因此得以出现

　　为了要提供存档的标签信息，jar 文件指定了一个特定目录来存放标签信息：META-INF 目录，其中我们来关注该目录中的MANIFEST.MF文件，他就是JAR的manifest文件，他包含了JAR文件的内容描述，并在运行时向JVM提供应用程序的信息，大多数JAR文件含有一个默认生成的manifest 文件,执行JAR命令或使用zip工具，都可以产生它

　　如果是由jar命令产生的 manifest 文件，形如:

　　Manifest-Version: 1.0

　　Created-By:1.4.0-beta

　　(Sun Microsystems Inc.)

　　这些信息没甚么用,仅仅告诉我们使用的是1.0的manifest文件,第一行定义manifest的格式，第二行说明使用 SUN 的JDK1.4的jar工具生成该文件，如果manifest文件是由其他 （如ant） 创建的，那将会出现 “Created-By: Ant 1.2” 之类的内容，如果你是自己创建manifest文件，你可以加入自己的一些相关信息.

　　基础格式

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

　　所有在开头的属性都是全局的，你也可以定义特定class 或package的属性，稍后将介绍这种

manifest文件作用：

　　1、把manifest文件插入JAR文件，用来描述jar文件

　　使用 m 选项，把指定文件名的manifest文件 传入，例如

　　jar cvfm myapplication.jar myapplication.mf -C classdir

　　如果你使用ant来创建时，在ant 的build.xml 加入如下条目

　　<target name="jar">

　　<jar jarfile ="myapplication.jar"

　　manifest="myapplication.mf">

　　<fileset dir="classdir"

　　includes="**/*.class"/>

　　</jar>

　　</target>

　　运行Java程序

　　现在我们来体验一下manifest文件的作用，如果现在我们有一个Java 应用程序打包在myapplication.jar中， main class为 com.example.myapp.MyAppMain ，那么我们可以用以下的命令来运行

　　java -classpath myapplication.jar com.example.myapp.MyAppMain

　　这显然太麻烦了，现在我们来创建自己的manifest文件，如下：

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Main-Class: com.example.myapp.MyAppMain

　　这样我们就可以使用如下的命令来运行程序了：（明显简单多了，也不会造成无谓的拼写错误）

　　java -jar myapplication.jar

管理JAR的依赖资源

　　很少Java应用会仅仅只有一个jar文件，一般还需要 其他类库。比如我的应用程序用到了Sun 的 Javamail classes ，在classpath中我需要包含activation.jar 和 mail.jar,这样在运行程序时,相比上面的例子,我们要增加一些:

　　java -classpath mail.jar:activation.jar -jar myapplication.jar

　　在不同的操作系统中,jar包间的分隔符也不一样，在UNIX用“：”，在window中使用 “；”，这样也不方便

　　同样，我们改写我们的manifest文件，如下

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Main-Class: com.example.myapp.MyAppMain

　　Class-Path: mail.jar activation.jar

　　（加入了Class-Path: mail.jar activation.jar，用空格分隔两个jar包）

　　这样我们仍然可以使用和上例中相同的命令来执行该程序：

　　java -jar myapplication.jar

　　Class-Path属性中包含了用空格分隔的jar文件，在这些jar文件名中要对特定的字符使用逃逸符，比如空格，要表示成"%20"，在路径的表示中，都采用“/”来分隔目录，无论是在什么操作系统中，(即使在window中)，而且这里用的是相对路径（相对于本身的JAR文件）：

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Main-Class: com.example.myapp.MyAppMain

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

       上面的方法打包后生成的jar文件中不包括ext/mail.jar ext/activation.jar两个包，要运行生成的包，必须同时存在Class-Path中的包，且相对位置不能改变。这样运行一个包，要附带几个包，很不方便，那有什么办法让这些包都集成一个包中呢？当然可以。这里介绍一种方法：将所引用到的包全部解压到同一个目录下（当前目录切换到此目录），自己的包也在该目录下，manifest.mf文件(此时无须再包含Class-Path属性)和图片文件也放在此目录下（当前目录不包含不相关文件），然后将当前目录下所有文件打包，命令如下：

当前目录>jar cvfm my.jar manifest.mf -C ./ *

用法：jar {ctxu}[vfm0Mi] [jar-文件] [manifest-文件] [-C 目录] 文件名

"-C ./"中"./"代表当前目录，其与后面的"*"之间有空格，"*"代表所有文件，这样就将引用的包加进来了，可以双击运行。虽然图片文件也打到包中了，但好象没有用，当存在于包外时有用。

另外,你也可以加入一些其他必要的文件:jar cvmf MANIFEST.MF a.jar *.class *.png   这样你就可以把程序中需要的一些图片文件打包到jar包中了。

但是把图片打包到jar中可能会存在这样的情况，就是不打包时还可以加载图片，打了包之后程序加载不上图片，那么你的程序需要稍微改一下，在新建图标对象的时候：

Icon pica=new ImageIcon(a.class.getResource("pica.png"));
Icon picb=new ImageIcon(a.class.getResource("picb.png"));

其中a.class是你的主类名，这样就可以加载上图片了。




　　Implementation-Title

　　Implementation-Version

　　Implementation-Vendor

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

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　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 技巧

　　总是以Manifest-Version属性开头

　　每行最长72个字符，如果超过的化，采用续行

　　确认每行都以回车结束，否则改行将会被忽略

　　如果Class-Path 中的存在路径，使用"/"分隔目录，与平台无关

　　使用空行分隔主属性和package属性

　　使用"/"而不是"."来分隔package 和class ,比如 com/example/myapp/

　　class 要以.class结尾，package 要以 / 结尾




　　Multiple Main Classes（多主类）

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

　　Manifest for myapplicationlib.jar:

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Class-Path: mail.jar activation.jar

　　Manifest for myappconsole.jar:

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Class-Path: myapplicationlib.jar

　　Main-Class: com.example.myapp.MyAppMain

　　Manifest for myappadmin.jar:

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Class-Path: myapplicationlib.jar

　　Main-Class: com.example.myapp.MyAdminTool

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

　　2、用来描述包 Package Versioning

　　完成发布后，如果使用者想了解 ，哪些代码是谁的？目前是什么版本？使用什么版本的类库？解决的方法很多 ，manifest提供了一个较好的方法，你可以在manifest文件中描述每一个包的信息。

　　Java 秉承了实现说明与描述分离的原则，package 的描述 定义了package 是什么，实现说明 定义了谁提供了描述的实现，描述和实现包含 名、版本号和提供者。要得到这些信息，可以查看JVM的系统属性（使用 java.lang.System.getProperty() ）

　　在manifest文件中，我可以为每个package定义描述和实现版本，声明名字，并加入描述属性和实现属性，这些属性是

　　Specification-Title

　　Specification-Version

　　Specification-Vendor
引用自：http://hi.baidu.com/suofang/blog/item/271e8682f943c291f603a629.html