java jar class_JAVA jar命令（一）-jar打包class文件

jar包本质上是将所有class文件、资源文件压缩打成一个包(也可以选择不压缩)，可选择在jar包中生成META-INF/MANIFEST.MF文件，MANIFEST.MF是清单文件，里面可以记录主类、classpath等信息，供虚拟机使用。

接下来的一段时间里，我们将以以下路径学习jar命令和清单文件的相关知识

jar打包class文件

带包class文件jar打包

清单文件的使用

在这篇文章里我们将使用简单的java程序来熟悉jar命令的使用，因为是出于熟练使用jar的目的，下面的操作中可能会啰里啰嗦、重复使用jar命令，以下是本片文章的目录，精简版直接看 jar命令的选项

一 jar命令的选项

用法

选项

本节中使用到的命令

二 只有一个class文件的可执行jar的实现

方法一将Mainjar全部解压修改MANIFESTMF文件后再重新打包

方法二生成jar包的时候为其指定清单文件

方法三为jar包指定清单文件

方法四为jar更新文件文件是清单文件

三 多个class的打包

一. jar命令的选项

用法：

大括号中的选项是必选的，中括号里选项是可选的，jar-file是jar文件；manifest-file是清单文件，即jar包中的META-INF/MANIFEST.MF文件

jar {ctxui}[vfmn0PMe] [jar-file] [manifest-file] [entry-point] [-C dir] files ...

1

选项：

-c  (create)创建新档案

-t  列出档案目录

-x  从档案中提取指定的 (或所有) 文件

-u  (update)更新现有档案

-v  在标准输出中生成详细输出

-f  指定档案文件名

-m  包含指定清单文件中的清单信息

-n  创建新档案后执行 Pack200 规范化

-e  为捆绑到可执行 jar 文件的独立应用程序

指定应用程序入口点

-0  仅存储; 不使用任何 ZIP 压缩

-P  保留文件名中的前导 '/' (绝对路径) 和 ".." (父目录) 组件

-M  不创建条目的清单文件

-i  为指定的 jar 文件生成索引信息

-C  更改为指定的目录并包含以下文件

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

本节中使用到的命令

jar uf xx.jar [file … | path]是需要注意的，它在更新完jar文件后会生成新的清单文件，这一点在本篇文章的 “方法4：为jar更新文件，文件是清单文件” 中有实例说明

jar cf xx.jar [file ... | path]  将file等文件或path目录打包成xx.jar

jar cvf xx.jar [file ... | path]  同上，显示详细信息

jar cmf manifest-file xx.jar [file ... | path]  将file等文件或path目录打包到xx.jar，并制定它的清单文件

jar cMf xx.jar [file ... | path]  将file等文件或path目录打包到xx.jar，包中不生成清单文件

jar uf xx.jar [file ... | path]  将file等文件或目录更新到xx.jar，务必注意！！！这个更新会重新生成清单文件

jar uMf xx.jar [file ... | path]  同上，但不会生成清单文件

jar umf manifest-file xx.jar {file ... | path}  将file等文件或path目录更新到xx.jar

jar tf xx.jar  列出xx.jar中所有文件

jar xf xx.jar  把xx.jar中所有文件提取到当前目录

jar xf xx.jar {file ...}  把xx.jar中file等文件提取到当前目录

1

2

3

4

5

6

7

8

9

10

二. 只有一个class文件的可执行jar的实现

首先创建一个jarDemo文件夹，里面放置我们的测试类

mkdir jarDemo

cd jarDemo

touch Main.java

1

2

3

在Main.java里面添加我们的hello world代码，并javac编译

public class Main{

public static void main(String ... args){

System.out.println("hello world");

}

}

1

2

3

4

5

javac Main.java

1

然后将生成的Main.class打包，c选项是创建一个新的jar包，f是指定jar包的名字

jar cf Main.jar Main.class

1

如果附加使用v选项，则会列出详细的打包信息

jar cvf Main.jar Main.class

1

我们可以通过t选项来查看生成的jar中的文件，输出的内容也就是包目录和包文件，可以看到是默认生成MANIFEST.MF文件的

jar tf Main.jar

输出：

META-INF/

META-INF/MANIFEST.MF

Main.class

1

2

3

4

5

6

当然我们也可以通过M选项不生成MANIFEST.MF文件，可以看到包中只有Main.class一个文件

rm Main.jar

jar cMf Main.jar Main.class

jar tf Main.jar

输出：

Main.class

1

2

3

4

5

6

虽然我们已经将Main.class打包了，并且Main.class有main(String … args)入口方法，可是这个jar还是不能执行，因为虚拟机并不知道这个包中的哪个class中是有main方法的

java -jar Main.jar

输出：

Main.jar中没有主清单属性

1

2

3

4

下面还是恢复到有MANIFEST.MF文件的Main.jar包，我们要将他解压，在MANIFEST.MF中添加主类属性

解压jar包的方法有很多种，我们解压的目的是为了查看默认生成的MANIFEST.MF文件，并做修改，最后生成一个可执行的jar包，因为我们的目的是出于熟练使用jar命名，下面我们将使用多个方法实现这个目标

方法一：将Main.jar全部解压，修改MANIFEST.MF文件后再重新打包

因为jar解压命令只能解压到当前目录，这样会造成文件混乱，我们新建一个uncompress文件夹，将Main.jar拷贝到这个文件夹后再解压，可以看到，jar包中所有文件，x选项是提出全部或指定文件，这个例子里是提出全部文件，实际中可以用f选项提出指定文件，比如 >> jar xf Main.jar META-INF/MANIFEST.MF

mkdir uncompress

cp Main.jar uncompress

cd uncompress

jar xf Main.jar

ls -RF

输出：

META-INF/   Main.class  Main.jar

./META-INF:

MANIFEST.MF

1

2

3

4

5

6

7

8

9

10

11

打开META-INF/MANIFEST.MF文件，看到默认生成的清单文件很简单，只有两行

Manifest-Version: 1.0

Created-By: 1.8.0_101 (Oracle Corporation)

1

2

添加上添加上主类属性，注意冒号后面一定要留一个空格，最后一定要多留一个换行符

Manifest-Version: 1.0

Created-By: 1.8.0_101 (Oracle Corporation)

Main-Class: Main

1

2

3

然后使用再将uncompress中所有目录、文件全部打包，注意先将原来的Main.jar删除，最后就可以运行这个新的有主类属性的Main.jar啦

rm Main.jar

jar cMf Main.jar .

java -jar Main.jar

输出：

hello world

1

2

3

4

5

6

注意上面这个jar命令使用的M选项是不生成清单，因为原本uncompress目录里就有，如果还是使用jar cf命令，生成的清单和上面第一次打包生成清单的是一样的，没有Main-Class: Main主类

rm Main.jar

jar cf Main.jar .

java -jar Main.jar

输出：

Main.jar中没有主清单属性

1

2

3

4

5

6

方法二：生成jar包的时候为其指定清单文件

还是那个方法一的uncompress目录，我们把META-INF下的MANIFEST.MF移到uncompress目录下，删除Main.jar，和META-INF目录，让uncompress中只有Main.class和MANIFEST.MF两个文件，MANIFEST.MF是有主类属性的清单文件

mv META-INF/MANIFEST .

rm Main.jar

rm -r META-INF

ls -RF

输出：

MANIFEST.MF Main.class

1

2

3

4

5

6

7

接下了指定清单文件，生成Main.jar，m选项可以指定一个清单文件

jar cmf MANIFEST.MF Main.jar Main.class

java -jar Main.jar

输出：

hello world

1

2

3

4

5

方法三：为jar包指定清单文件

还记得最早那个jardemo目录里的那个清单里没有主类的Main.jar吗，我们为它更新有主类的清单文件

jardemo/uncompress目录下的的MANIFEST.MF是有主类的，我们把它移到jardemo目录下

cd desktop/jardemo

mv uncompress/MANIFEST.MF .

rm -r uncompress

ls -RF

输出：

MANIFEST.MF Main.class  Main.jar    Main.java

1

2

3

4

5

6

7

使用u选项更新jar包，使用m选项指定清单文件，输出了一些警告信息，因为新的清单文件和Main.jar包中原来的清单信息有两个字段是重名的

jar -umf MANIFEST.MF Main.jar

输出：

三月 13, 2017 10:50:50 下午 java.util.jar.Attributes read

WARNING: Duplicate name in Manifest: Manifest-Version.

Ensure that the manifest does not have duplicate entries, and

that blank lines separate individual sections in both your

manifest and in the META-INF/MANIFEST.MF entry in the jar file.

三月 13, 2017 10:50:50 下午 java.util.jar.Attributes read

WARNING: Duplicate name in Manifest: Created-By.

Ensure that the manifest does not have duplicate entries, and

that blank lines separate individual sections in both your

manifest and in the META-INF/MANIFEST.MF entry in the jar file.

1

2

3

4

5

6

7

8

9

10

11

12

13

再运行这个jar

java -jar Main.jar

输出：

hello world

1

2

3

4

方法四：为jar更新文件，文件是清单文件

使用这个方法主要是为了再次熟悉一下u选项和理解包的概念

我们在jardemo目录里删除有主类清单的Main.jar，再次生成最早的MANIFEST.MF中没有主类的Main.jar

jar cf Main.jar Main.class

1

jar包中的MANIFEST.MF里记录了主类，而MANIFEST.MF只是jar包中的一个文件，我们将Main.jar中没有主类的MANIFEST.MF替换为有主类的MANIFEST.MF和方法三是同样的效果，首先要讲有主类的MANIFEST.MF放在合适的路径里面，我们之前看到jar包中的文件是放在META-INF目录里的，使用u来更新jar，注意需要使用M来忽视清单文件

mkdir META-INF

mv MANIFEST.MF META-INF

jar uMf Main.jar META-INF/MANIFEST.MF

java -jar Main.jar

输出：

hello world

1

2

3

4

5

6

7

三. 多个class的打包

上一节中，jarDemo目录中有Main.java和有主类信息的清单文件MANIFEST.MF，我们只保留这两个个文件，其他全部删掉，然后新建一个Say.java文件

ls -RF

输出：

META-INF/   Main.java   Say.java

./META-INF:

MANIFEST.MF

1

2

3

4

5

6

7

在新建的Say.java：

public class Say{

public static void say(String str){

System.out.println("This is " + str);

}

}

1

2

3

4

5

修改Main.java文件，让它调用Say类中的Say.say(…)方法

public class Main{

public static void main(String ... args){

System.out.println("hello world");

Say.say("Charles");

}

}

1

2

3

4

5

6

我们编译文件并打包，注意指定一个那个有主类属性的MANIFEST.MF

javac *.java

jar cmf Main.jar META-INF/MANIFEST.MF Main.class Say.class

java -jar Main.jar

输出：

hello world

This is Charles