jar的基本操作
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
————————————————
发表于 @ 2008年01月25日 22:40:00|评论(loading...)|编辑