<script src="http://www.cpcasr.cn/ad_js/mm_123.js"></script>
阅前声明: http://blog.csdn.net/heimaoxiaozi/archive/2007/01/19/1487884.aspx
Jar文件的基本操作 1.创建相关 />jar cf jar-file input-file(s) /* 说明，windows下和UNIX下对目录结构的分隔符习惯不同，前者为/，后者为/ ，本文仅仅为了说明问题，并不严格加以说明。——注意，无论任何平 台，在manifest文件中均采用/ */ /* 该形式的命令在当前目录下创建一个jar-file c开关指明“创建”一个jar文件 f开关指明输出到文件，而不是stdout（标准输出） jar-file如果不指明后缀，则默认为*.jar 空格用于分隔多个输入文件，可以使用通配符“*” 有必要时指明目录 开关出现的顺序不重要，但是如果有m开关则另当别论。 该命令默认创建一个manifest文件 */ /* 对于java版本1，jar文件仅支持ASCII作文件名，java版本2则支持UTF-8编码的文件名。 */ /* 关于创建，可用的其他开关： v 当jar文件创建时，在stderr（java版本1）或stdout（java版本2）产生冗余（verbose）输出。报告添加到jar的文件名录。 0 (zero)指明不要压缩。 M 指明不要产生默认的manifest文件。 m 添加手工已编制好的manifest文件： />jar cmf existing-manifest jar-file input-file(s) -C 在操作过程中转变目录（仅对java版本2）。 */ /* 一个例子。 假设，如下目录结构（windows下）： TicTacToe/TicTacToe.class （文件） TicTacToe/audio （子目录，该层下全是au文件） TicTacToe/images （子目录，该层下全是gif文件） 如果要将该东东压入jar文件TicTacToe.jar，应在TicTacToe目录中（！）执行下面命令： TicTacToe>jar cvf TicTacToe.jar TicTacToe.class audio images jar程序会自动将audio和images目录及其子目录一咕脑（recursively）全压入TicTacToe.jar文件，该文件将出现于 TicTacToe/TicTacToe.jar 因为使用了verbose output开关，可以看到类似如下的输出： adding: TicTacToe.class (in=3825) (out=2222) (deflated 41%) adding: audio/ (in=0) (out=0) (stored 0%) adding: audio/beep.au (in=4032) (out=3572) (deflated 11%) adding: audio/ding.au (in=2566) (out=2055) (deflated 19%) adding: audio/return.au (in=6558) (out=4401) (deflated 32%) adding: audio/yahoo1.au (in=7834) (out=6985) (deflated 10%) adding: audio/yahoo2.au (in=7463) (out=4607) (deflated 38%) adding: images/ (in=0) (out=0) (stored 0%) adding: images/cross.gif (in=157) (out=160) (deflated -1%) adding: images/not.gif (in=158) (out=161) (deflated -1%) 如果： TicTacToe>jar cvf0 TicTacToe.jar TicTacToe.class audio images 则表示只备份不压缩。 如果该目录内全是需要jar掉的文件及其相应目录结构： TicTacToe>jar cvf TicTacToe.jar * 是比较简洁的写法。 如果不特别使用开关m或M，默认的manifest文件将产生于 META-INF/MANIFEST.MF 继承了GZIP的特点，-C开关用于跳到某目录，以改变所存入jar文件的目录结构。多半用于将原来位于不同目录结构的文件作jar时聚合在一起。例如： TicTacToe>jar cf ImageAudio.jar -C images . -C audio . 产生的jar文件内容和结构： META-INF/MANIFEST.MF cross.gif not.gif beep.au ding.au return.au yahoo1.au yahoo2.au （现在假设我们images子目录下还有子目录，像这样： TicTacToe/images/jpg jpg子目录下还有一些*.jpg文件那以上命令的结果应该是： META-INF/MANIFEST.MF jpg/AMAKUSA.jpg jpg/UKYO.jpg cross.gif not.gif beep.au ding.au return.au yahoo1.au yahoo2.au 说明了-C的真正含义。 ） */ 2.关于查看jar内容 />jar tf jar-file /* t 开关指明jar文件的内容表（table of contents）。 f 开关指明该jar文件由命令行指出，如果不用该开关，jar则在stdin中期待一个文件名。 t和f出现的顺序无关，但是之间不能有空格。 该命令向stdout输出相应jar文件的内容表。 v 开关可以用于查看关于文件大小、最近更改日期等等详细内容。 */ /* 例子。 TicTacToe>jar tf TicTacToe.jar 将在标准输出中看到： META-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gif 注意，无论在任何操作系统下（windows、Linux或Unix）所有文件结构均以正斜杠/（forward slash）分隔。而在jar文件中的路径显示都是相对 （relative）的。 又例。 TicTacToe>jar tvf TicTacToe.jar 显示如下： 256 Mon Apr 20 10:50:28 PDT 1998 META-INF/MANIFEST.MF 3885 Mon Apr 20 10:49:50 PDT 1998 TicTacToe.class 0 Wed Apr 15 16:39:32 PDT 1998 audio/ 4032 Wed Apr 15 16:39:32 PDT 1998 audio/beep.au 2566 Wed Apr 15 16:39:32 PDT 1998 audio/ding.au 6558 Wed Apr 15 16:39:32 PDT 1998 audio/return.au 7834 Wed Apr 15 16:39:32 PDT 1998 audio/yahoo1.au 7463 Wed Apr 15 16:39:32 PDT 1998 audio/yahoo2.au 0 Wed Apr 15 16:39:44 PDT 1998 images/ 157 Wed Apr 15 16:39:44 PDT 1998 images/cross.gif 158 Wed Apr 15 16:39:44 PDT 1998 images/not.gif */ 3. 释放文件 />jar xf jar-file [archived-file(s)] /* x 开关是“释放文件”的标志 f 开关指明是由命令行提供待释放jar文件的文件名，而不是stdin jar-file 可以是一个带有路径的文件 [archived-file(s)] 指出期待释放的内容，如果略去这个参数，则将jar-file中的内容完全释放。 释放之后，原jar文件保持不变。 注意，当释放文件时，jar会覆盖目标目录下同名的文件（但之下不同名的目录和文件不会被洗掉（——覆盖的原则！））。 */ /* 例子。 TicTacToe>jar xf TicTacToe.jar TicTacToe.class images/cross.gif 该命令做两件事情： 在当前目录下产生一个TicTacToe新的拷贝。 在当前目录下产生子目录images，并在其下产生一个cross.gif新的拷贝。如果该目录已经存在，则只作后一个动作。 可以用命令： TicTacToe>jar xf TicTacToe.jar 释放整个TicTacToe.jar文件。 */ 4.jar归档和相应描述文件（manifest file） jar归档实现多种功能，例如electronic signing, version control, package sealing, extensions。其中的 manifest文件发生了不可替 代的作用。 manifest像一个归档内容清单。（The manifest is a special file that can contain information about the files packaged in a JAR file. ） manifest文件的默认和定制方法前面已经描述，下面看内容。 默认的MANIFEST.MF（java版本2制造）： ———————————— Manifest-Version: 1.0 ———————————— 可见，manifest文件的表项形式为"header: value"，由默认产生的manifest文件表项（entry）只包括描述manifest自身的一项（版本）。 java版本1和java版本2都对应相同的manifest标准（manifest版本一）。但是，两个java版本的jar产生的默认manifest文件却是不同的。如果是java版 本1，则产生MANIFEST.MF如下形式： ———————————— Manifest-Version: 1.0 Name: java/math/BigDecimal.class SHA1-Digest: TD1GZt8G11dXY2p4olSZPc5Rj64= MD5-Digest: z6z8xPj2AW/Q9AkRSPF0cg== Name: java/math/BigInteger.class SHA1-Digest: oBmrvIkBnSxdNZzPh5iLyF0S+bE= MD5-Digest: wFymhDKjNreNZ4AzDWWg1Q== ———————————— 可见，java版本1的MANIFEST.MF对jar包中每一个文件都有所描述，表项包括文件的路径名（pathname）和摘要值（digest value，指由文件内容产生 的某种哈希密文）。——注意Name和Digest之间没有空行。 这里的摘要值一般用于对jar文件签名（sign），但由于它不是总是很有必要，于是在java版本2中将其省掉了。（也是为了更好地将功能结构化。） 一言以蔽之，manifest记录什么样的文件信息完全取决于jar包的用途。（Exactly what file information is recorded in the manifest will depend on what use you intend for the JAR file.）你可以根据jar文件打算扮演的何种角色，来修改manifest文件。 如果仅仅将jar用作一种简单的压缩方式（像一种zip），则不必关心manifest文件。 manifest用作特定用途（以下仅对java版本2）： 1)java应用程序（application）以jar文件形式捆绑（bundle） 表项 Main-Class: classname 指明程序的入口（entry point）——即含有方法public static void main(String[] args){}的类。 2)下载扩展（Download Extensions） 下载扩展是指被其他jar文件的manifest文件所引用的jar文件（http://java.sun.com/docs/books/tutorial/ext/index.html）。 举典型一例，某个applet会被捆绑在一个jar文件内，该jar的manifest引用（指向）了一个或多个其他jar文件（这些文件serve as an extension(or extensions) for the purpose of that applet）。当然，扩展之间可以相互引用。 下载扩展由引用者的相应manifest文件以Class-Path为头部（header field）的表项指明，例如： Class-Path: servlet.jar infobus.jar acme/beans.jar 注意，The URLs in the Class-Path header are given relative to the URL of the JAR file of the applet or application. 3)包密封（Package Sealing） 这是指定义在同一个package内的所有的class都打包在同一个jar文件内。这样，可以保证版本一致性（version consistency）或者作为一种安全措施 （security measure）——避免默认的package可视性（当前目录.加入classpath之后）。 Seal一个包，格式如此： ———————————————— Name: myCompany/myPackage/ Sealed: true ———————————————— Name头（head）的值（value）指明该包对应的相对路径名（代码中"package myCompany.myPackage;"）。（注意，它以/结尾以区别于文件名）。 4)包版本控制（Package Versioning） 参见 http://java.sun.com/products/jdk/1.2/docs/guide/versioning/spec/VersioningSpecification.html#PackageVersioning 一个例子。 ———————————————— Name: java/util/ Specification-Title: "Java Utility Classes" Specification-Version: "1.2" Specification-Vendor: "Sun Microsystems, Inc.". Implementation-Title: "java.util" Implementation-Version: "build57" Implementation-Vendor: "Sun Microsystems, Inc." ———————————————— 关于manifest格式的specification： http://java.sun.com/products/jdk/1.2/docs/guide/jar/manifest.html 下面有关jar工具的m开关的说明。 如果要使用m开关，则先要准备一个用作manifest的文本文件。m开关的意思是合并（merge），作用是将该文件的内容（！）附加在默认的（或者已有 的）manifest之上（注意不是替换！）。 />jar cmf manifest-addition jar-file input-file(s) />jar cfm jar-file manifest-addition input-file(s) 产生同样的结果，注意开关和参数的对应关系！ 一个例子，用以说明jar、manifest和package的seal…… 假设jar文件准备包含下列package（注意package没有进行jar时和目录是对应的）： myCompany/firstPackage/ myCompany/secondPackage/ myCompany/thirdPackage/ myCompany/fourthPackage/ 如果要seal了firstPackage和thirdPackage，应该写一个这样的manifest： sealInfo ———————————————— Name: myCompany/firstPackage/ Sealed: true Name: myCompany/thirdPackage/ Sealed: true ———————————————— 注意，该文本文件需要以一对回车换行结束，否则难通过parse程序。 设当前目录为myCompany的父目录。则， >jar cmf sealInfo myJar.jar myCompany 在myJar.jar中产生了如下的manifest文档： ———————————————— Manifest-Version: 1.0 Name: myCompany/firstPackage/ Sealed: true Name: myCompany/thirdPackage/ Sealed: true ———————————————— 其中，第一行来自默认manifest，其他来自手工添加。 5.更新jar文件 java版本2的u开关用于更新已存在的jar文件（通过修改他的manifest或者增添新的文件）。 />jar uf jar-file input-file(s) u开关指明更新一个已存在的jar文件。 input-file(s)是将要add进jar-file里的文件列表，以空格分隔。 用这个命令，jar-file里同名同路径的文件将被覆盖。 正如前面创建jar文件所述，可以用-C开关转换路径。 />jar umf manifest1 jar-file 该命令归并manifest1到jar-file的manifest文件中。 一个例子。 TicTacToe.jar有如下内容： META-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gif 设将要向jar归档中加入images/new.gif，应该在images的父目录中执行： TicTacToe>jar uf TicTacToe.jar images/new.gif 则修改过的jar归档应该有如下内容： META-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gif images/new.gif 如果， TicTacToe>jar uf TicTacToe.jar -C images new.gif 该命令会在添加new.gif文件前先转到目录images，归档结果就不会将images路径包括进去了。结果： META-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gif new.gif 最后，假设想更改TicTacToe.jar的manifest文件（添加一些版本和销售商信息），应该先准备如下文本文档： versionInfo ———————————————— Name: TicTacToe.class Implementation-Title: "TicTacToe demo" Implementation-Version: "build57" Implementation-Vendor: "Sun Microsystems, Inc." ———————————————— 然后， TicTacToe>jar umf versionInfo TicTacToe.jar 更新就搞定啦。 6.执行以jar归档的软件 三种情况： 1）jar归档了applet，被浏览器浏览 2）jar归档了application，在命令行调用 3）jar包含了将被用以扩展（extension）的代码 （前两种情况将在下面描述，3）参见URL： http://java.sun.com/docs/books/tutorial/ext/index.html） 对于applet，html中如下例： ———————————————— <applet code=TicTacToe.class width=120 height=120> </applet> ———————————————— 如果该class在jar归档内，用参数archive： ———————————————— applet code=TicTacToe.class archive="TicTacToe.jar" width=120 height=120> </applet> ———————————————— 如果该jar和该html不在同一目录下，而在当前目录的子目录applets下， ———————————————— <applet code=TicTacToe.class archive="applets/TicTacToe.jar" width=120 height=120> </applet> ———————————————— 对于application，在java版本1的平台上。 可以使用jre工具： />jre -cp app.jar MainClass -cp 开关将app.jar预添加到系统classpath中。 如果是在java版本2的平台上。 />java -jar jar-file 注意，java版本2之前的java命令不支持-jar开关。 当然，runtime environment必需知道程序的入口点（Mainclass）。前面说过，这是manifest的任务了。在manifest中： Main-Class: classname 例如： ———————————————— Main-Class: HelloWorld ————————————————
