jar 用法详解

1.理论知识

jar 命令详解

 　 jar 是随 JDK 安装的，在 JDK 安装目录下的 bin 目录中，Windows 下文件名为 jar.exe，Linux 下文件名为 jar。它的运行需要用到 JDK 安装目录下 lib 目录中的 tools.jar 文件。不过我们除了安装 JDK 什么也不需要做，因为 SUM 已经帮我们做好了。我们甚至不需要将 tools.jar 放到 CLASSPATH 中。

　　使用不带任何的 jar 命令我们可以看到 jar 命令的用法如下：

　　jar {ctxu}[vfm0M] [jar-文件] [manifest-文件] [-C 目录] 文件名 ...

 　　其中 {ctxu} 是 jar 命令的子命令，每次 jar 命令只能包含 ctxu 中的一个，它们分别表示：

　　-c　创建新的 JAR 文件包

　　-t　列出 JAR 文件包的内容列表

　　-x　展开 JAR 文件包的指定文件或者所有文件

　　-u　更新已存在的 JAR 文件包 (添加文件到 JAR 文件包中)

　　[vfm0M] 中的选项可以任选，也可以不选，它们是 jar 命令的选项参数

　　-v　生成详细报告并打印到标准输出

　　-f　指定 JAR 文件名，通常这个参数是必须的

　　-m　指定需要包含的 MANIFEST 清单文件

　　-0　只存储，不压缩，这样产生的 JAR文件包会比不用该参数产生的体积大，但速度更快

　　-M　不产生所有项的清单（MANIFEST〕文件，此参数会忽略 -m 参数

 

　　[jar-文件] 即需要生成、查看、更新或者解开的 JAR 文件包，它是 -f 参数的附属参数

　　[manifest-文件] 即 MANIFEST 清单文件，它是 -m 参数的附属参数

　　[-C 目录] 表示转到指定目录下去执行这个 jar 命令的操作。它相当于先使用 cd 命令转该目录下再执行不带 -C 参数的 jar 命令，它只能在创建和更新 JAR 文件包的时候可用。

　　文件名 ... 指定一个文件/目录列表，这些文件/目录就是要添加到 JAR 文件包中的文件/目录。如果指定了目录，那么 jar 命令打包的时候会自动把该目录中的所有文件和子目录打入包中。

 　　下面举一些例子来说明 jar 命令的用法：

假设：目录zzh\test下有java编译文件：Test.class

在目录zzh下执行：

 　　1) jar cf test.jar test

　　该命令没有执行过程的显示，执行结果是在当前目录生成了 test.jar 文件。如果当前目录已经存在 test.jar，那么该文件将被覆盖。

　　2) jar cvf test.jar test

 　　该命令与上例中的结果相同，但是由于 v 参数的作用，显示出了打包过程，如下：

 

　　标明清单(manifest)

　　增加：test/(读入= 0) (写出= 0)(存储了 0%)

　　增加：test/Test.class(读入= 7) (写出= 6)(压缩了 14%)

 

　　3) jar cvfM test.jar test

 

　　该命令与 2) 结果类似，但在生成的 test.jar 中没有包含 META-INF/MANIFEST 文件，打包过程的信息也略有差别：

 

　　增加：test/(读入= 0) (写出= 0)(存储了 0%)

　　增加：test/Test.class(读入= 7) (写出= 6)(压缩了 14%)

 

　　4) jar cvfm test.jar manifest.mf test

 

　　运行结果与 2) 相似，显示信息也相同，只是生成 JAR 包中的 META-INF/MANIFEST 内容不同，是包含了 manifest.mf 的内容

 

　　5) jar tf test.jar

 

　　在 test.jar 已经存在的情况下，可以查看 test.jar 中的内容，如对于 2) 和 3) 生成的 test.jar 分别应该此命令，结果如下；

 

　　对于 2)

 

　　META-INF/

　　META-INF/MANIFEST.MF

　　test/

　　test/Test.class

 

　　对于 3)

 

　　test/

　　test/Test.class

 

　　6) jar tvf test.jar

 

　　除显示 5) 中显示的内容外，还包括包内文件的详细信息，如：

 

　　　　 0 Wed Jun 1915:39:06 GMT 2002 META-INF/

　　　　86 Wed Jun 19 15:39:06 GMT 2002 META-INF/MANIFEST.MF

　　　　 0 Wed Jun 19 15:33:04 GMT 2002 test/

　　　　 7 Wed Jun 19 15:33:04 GMT 2002 test/Test.class

 

　　7) jar xf test.jar

 

　　解开 test.jar 到当前目录，不显示任何信息，对于 2) 生成的 test.jar，解开后的目录结构如下：

 

　　|-- META-INF

　　|　 `-- MANIFEST

　　`-- test

　　　　`-- Test.class

 

　　8) jar xvf test.jar

 

　　运行结果与 7) 相同，对于解压过程有详细信息显示，如：

 

　　　创建：META-INF/

　　展开：META-INF/MANIFEST.MF

　　　创建：test/

　　展开：test/Test.class

 

　　9) jar uf test.jar manifest.mf

　　在 test.jar 中添加了文件 manifest.mf，此使用 jar tf 来查看 test.jar 可以发现 test.jar 中比原来多了一个 manifest。这里顺便提一下，如果使用 -m 参数并指定 manifest.mf 文件，那么 manifest.mf 是作为清单文件 MANIFEST 来使用的，它的内容会被添加到 MANIFEST 中；但是，如果作为一般文件添加到 JAR 文件包中，它跟一般文件无异。

　　10) jar uvf test.jar manifest.mf

　　与 9) 结果相同，同时有详细信息显示，如：

 

　　增加：manifest.mf(读入= 17) (写出= 19)(压缩了 -11%)

2.实例

情景： 目录 D:\workspace_job\java_test\com\zzh\test下有java源文件：HelloWorld.java

1.例子1

HelloWorld.java源码：

public class HelloWorld {
public static void main(String[] args) 
{
System.out.println("Hello World!");
}
}

编译后的文件HelloWorld.class。

在test目录下新建文件manifest.mf，文件内容：Main-Class: HelloWorld。注意：Main-Class：后加空格，最后要回车换行。

进入目录test，执行命令：jar cvfm HelloWorld.jar manifest.mf HelloWorld.class，

结果如下：

得到HelloWorld.jar。

查看HelloWorld.jar包内容：执行命令 jar tf HelloWorld.jar，结果如下：

若是解压缩HelloWorld.jar,我们会发现内部的MANIFEST.MF的内容为:

Manifest-Version: 1.0
Created-By: 1.6.0_38 (Sun Microsystems Inc.)
Main-Class: HelloWorld

执行HelloWorld.jar命令：java -jar HelloWorld.jar，结果输出：Hello World！

2.例子2

将例子1中的HelloWorld.java加上包：package com.zzh.test; 其余的都与例子1一模一样，重新打包HelloWorld.jar,执行命令java -jar HelloWorld.jar,结果如下：

分析：清单文件MANIFEST.MF中的Main-Class的值是类的全名称，包括包名！

3.例子3

将例子2中的manafest.mf内容改为：Main-Class: com.zzh.test.HelloWorld， 其余的都与例子2一模一样，重新打包HelloWorld.jar,执行命令java -jar HelloWorld.jar,结果如下：

分析：jar包中需要把类中对应的包目录也打包进去！即可以理解为：从jar包内部的根目录依据包名和类名查找指定的类。而此例中，只打包了HelloWorld.class文件，并没有把com\zzh\test目录打包进去。

此例中HelloWorld.jar包内部的结构为：

显然依据 Main-Class: com.zzh.test.HelloWorld，要从jar包内部的目录 com\zzh\test\找到对应的HelloWorld.class文件，显然找不到com\zzh\test\HelloWorld.class文件。

4.例子4

将例子3中的manifest.mf移到java_test目录，在java_test目录执行打包命令：jar cvfm HelloWrold.jar manifest.mf com,结果如下：

查看生成的HelloWorld.jar内部结构：jar tf HelloWorld.jar，结果如下：

可见把com\zzh\test目录打包到HelloWorld.jar包中了。执行jar：java -jar HelloWorld.jar，结果如下：

5.例子5

将例子5中的manifest.mf移到workspace_job目录，在workspace_job目录执行打包：jar cvfm HelloWrold.jar manifest.mf java_test，

查看生成的HelloWorld.jar包内部结构：jar tf HelloWorld.jar,结果如下：

执行jar包：java -jar HelloWorld.jar，结果如下：

分析：jar包根目录下并没有对应的com\zzh\test目录，而是java_test\com\zzh\test目录！

6.例子6

将HelloWorld.java 代码改为：

package com.zzh.test;
import org.apache.commons.lang3.StringUtils;
public class HelloWorld {


public static void main(String[] args) 
{
String msg = "Hello World!";
        if(StringUtils.isNotBlank(msg)) {
            System.out.println(msg);
      }
}
}

manifest.mf改为：

Main-Class: com.zzh.test.HelloWorld
Class-Path: lib\commons-lang3-3.1.jar

在java_test目录下新建一个文件夹lib，内部放commons-lang3-3.1.jar包。

编译HelloWorld.java：在D:\workspace_job\java_test\com\zzh\test目录下执行：javac -classpath D:\workspace_job\java_test\lib\commons-lang3-3.1.jar HelloWorld.java。

在java_test目录下执行：jar cvfm HelloWorld.jar manifest.mf com，生成HelloWorld.jar。执行java -jar HelloWorld.jar输出：Hello World！

将lib文件夹删除（此时HelloWorld.jar所在的目录没有lib文件夹了），再执行java -jar HelloWorld.jar，此时会抛错，提示找不到类StringUtils：

错误分析：HelloWorld.java内部引用StringUtils.java这个类，该类在 commons-lang3-3.1.jar包中。HelloWorld.jar的MANIFEST.MF文件中指明了运行HelloWorld.jar时用的classpath：  Class-Path: lib\commons-lang3-3.1.jar。该路径是针对HelloWorld.jar位置的路径的，也就是说必须把HelloWorld.jar和lib放在同一个目录下。即文件清单中的Class-Path指定的路径是相对于本身jar包的路径的。

该例说明了：jar包中若是要引用外部的jar包，则需呀在NANIFEST.MF文件中用Class-Path指定外部jar的路径，该路径是相对本身jar包的相对路径。若是有多个外部jar，则用空格分开，不能用正则表达式如lib\*.jar这种类型。