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