一、Jar命令打包java应用的用法
jar是标准的java打包命令,位于JAVA_HOME/bin/目录下面。主要功能是将多个文件打包成一个单独的jar文件。
创建jar文件
jar c[v0Mmfe] [manifest] [jarfile] [entrypoint] [-C dir] inputfiles [-Joption]
更新jar文件
jar u[v0Mmfe] [manifest] [jarfile] [entrypoint] [-C dir] inputfiles [-Joption]
解压jar文件
jar x[vf] [jarfile] [inputfiles] [-Joption]
显示Jar包结构
jar t[vf] [jarfile] [inputfiles] [-Joption]
添加索引到jar文件
jar i jarfile [-Joption]
其中[]代表可选
参数分析如下:
jarfile:被创建、更新、解压或者显示的目标jar文件,和-f选项一起使用
inputfiles:文件或者目录,多个文件或者目录用空格分开,表示需要被打包的文件或者目录,待解压的jar包中的文件或者目录,待显示的jar包的文件或者目录。如果是目录,将按照递归的方式处理。多个文件间以zip方式被压缩,除非添加0选项
manifest:指定manifest文件,和-m参数一起使用
entrypoint:指定类名作为应用的入口,和-e选项一起使用。特别说明,-m、-f、-e参数对应的的manifest、jarfile、entrypoint顺序要相同
-C dir:处理inputfiles时,指定后面inputfile的目录,可以有多个-C dir inputfile
-Joption:指定Java runtiome environment的参数,-J何option之间不能有空格
选项:
-c 创建新的jar包
-u 更新已有的jar包
-x 解压指定的jar包
-t 显示jar包内容
-f 和 jarfile一起使用
-v 输出详细信息
-0 不使用zip压缩
-M 生成jar包时不创建manifest文件(将指定文件作为 MANIFEST.MF 打包进jar)
-m 和manifest一起使用
-e 和entrypoint一起使用,指定程序的入口类,并将其写入到生成的manifest文件中,对应Main-Class。如果和manifest一起使用并且manifest中指名了Main-Class,打包将会出错
注意:-m 与 -f 的位置很重要。 如果 m 在 f 之前,那么manifest.txt 就要出现在 app.jar前面,反之亦然。
二、java打jar包的几种方式详解
一、制作只含有字节码文件的jar包
我们先来看只含有字节码文件,即只含有class文件的jar包怎么制作,这是最简单的形式
1、最简单的jar包——直接输出hello
最终生成的jar包结构
META-INF
Hello.class
方法步骤
(1)用记事本写一个Hello.java的文件
class Hello{ public static void main(String[] agrs){ System.out.println("hello"); } }
(2)用命令行进入到该目录下,编译这个文件
javac Hello.java
(3)将编译后的Hello.class文件打成jar包
jar -cvf hello.jar Hello.class
c表示要创建一个新的jar包,v表示创建的过程中在控制台输出创建过程的一些信息,f表示给生成的jar包命名
(4)运行jar包
java -jar hello.jar这时会报如下错误hello.jar中没有主清单属性
添加Main-Class属性
用压缩软件打开hello.jar,会发现里面多了一个META-INF文件夹,里面有一个MENIFEST.MF的文件,用记事本打开
1 Manifest-Version: 1.02 Created-By: 1.8.0_121 (Oracle Corporation)3
在第三行的位置写入 Main-Class: Hello (注意冒号后面有一个空格,整个文件最后有一行空行),保存
再次运行java -jar hello.jar,此时成功在控制台看到hello,成功
2、含有两个类的jar包——通过调用输出hello
最终生成的jar包结构
META-INF
Tom.class
Hello.class
方法步骤
(1)用记事本写一个Hello.java和一个Tom.java的文件
目的是让Hello调用Tom的speak方法
1 class Hello{2 public static void main(String[] agrs){3 Tom.speak();4 }5 }
1 class Tom{2 public static void speak(){3 System.out.println("hello");4 }5 }
(2)编译:javac Hello.java
此时Hello.java和Tom.java同时被编译,因为Hello中调用了Tom,在编译Hello的过程中发现还需要编译Tom
(3)打jar包,这次我们换一种方式直接定义Main-Class。
1 Manifest-Version: 1.02 Created-By: 1.8.0_121 (Oracle Corporation)3 Main-Class: Hello4
事先准备好上述的MENIFEST.MF文件,并存放在META-INF文件夹下,此时打jar包的命令如下
jar -cvfm hello.jar META-INF\MENIFEST.MFHello.class Tom.class
该命令表示用第一个文件当做MENIFEST.MF文件,hello.jar作为名称,将Hello.class和Tom.class打成jar包。其中多了一个参数m,表示要定义MENIFEST文件
(4)运行java -jar hello.jar,此时成功在控制台看到hello,成功
3、有目录结构的jar包——通过引包并调用输出hello
最终生成的jar包结构
META-INF
com
Tom.class
Hello.class
我们将上一个稍稍变化一下,将Tom这个类放在com包下,源文件目录结构变成
com
Tom.java
Hello.java
同时Tom.java需要在第一行声明自己的包名
package com;
Hello.java需要引入Tom这个类,同样要在第一行进行import
import com.Tom;
方法步骤
(1)编译Hello.java
(2)打jar包,同样准备好MENIFEST文件
jar -cvfm hello.jar META-INF\MENIFEST.MFHello.class com
注意,最后一个com表示把com这个文件夹下的所有文件都打进jar包
(3)运行java -jar hello.jar,此时成功在控制台看到hello,成功
(4)优化过程
我们注意到,com包下是有Tom.java源文件的,也被打进了jar包里,这样不太好,能不能优化一下javac命令,使所有的编译后文件编译到另一个隔离的地方呢,答案是可以的。
在编译Hello.java时,先新建一个target文件夹。然后我们用如下命令
javac Hello.java -d target
该命令表示,将所有编译后的文件,都放到target文件夹下。
将META-INF文件夹也复制到target目录下,进入这个目录,输入如下命令
jar -cvfm hello.jar META-INF\MENIFEST.MF*
注意最后一个位置变成了*,表示把当前目录下所有文件都打在jar包里
优化完毕
至此,我们可以总结出,制作一个只含有class字节码文件的jar包,以下命令足以
javac 要编译的文件 -d 目标位置
jar -cvfm 命名 MENIFEST文件 要打包的文件1 要打包的文件2
二、制作含有jar文件的jar包
我们将场景稍稍变得复杂一点,看看jar包中需要引入其他jar包的场景
1、两个jar包间相互调用——调用jar外的jar输出hello
最终生成的jar包结构
hello.jar
tom.jar
方法步骤
准备:将上述一中写好的那个不带包的tom.jar复制过来(目的是调用里面的speak方法)
(1)编写一个Hello.java并将其编译成Hello.class,注意,由于Hello里面引用了Tom类的speak方法,因此在打jar包时应使用-cp参数,将tom.jar包引入
javac -cp tom.jarHello.class
这里的 -cp 表示 -classpath,指的是把tom.jar加入classpath路径下
(2)将hello.class达成jar包,步骤略
(3)此时运行 java -jar 发现报错ClassNotFoundException:Tom
原因很简单,引入jar包需要在MENIFEST.MF文件中配置一个新属性:Class-Path,路径指向你需要的所有jar包
现在MENIFEST.MF这个文件应该变成
1 Manifest-Version: 1.02 Created-By: 1.8.0_121 (Oracle Corporation)3 Main-Class: Hello4 Class-Path: Tom.jar5
(4)好了,修改这个文件,再次运行,发现成功在控制台输出hello
tips:引入多个jar包,中间用空格隔开
至此,我们可以总结出,命令变化如下
javac-cpxxx.jar要编译的文件 -d 目标位置
jar -cvfm 命名 MENIFEST文件 要打包的文件1 要打包的文件2
2、jar包中含有jar包——调用jar内的jar输出hello
最终生成的jar包结构
META-INF
Hello.class
tom.jar
当项目中我们把所需要的第三方jar包也打进了我们自己的jar包中时,如果仍然按照上述操作方式,会报找不到Class异常。原因就是jar引用不到放在自己内部的jar包。
这种情况的具体实现细节比较复杂,我会在后一篇介绍一些知名的java应用是如何加载jar包的,来说明这种情况。实现方式的简单说明,可以先参考这篇文章:
http://www.cnblogs.com/adolfmc/archive/2012/10/07/2713562.html
三、制作含有资源文件的jar包
1、资源文件在jar包内部——读取jar内的文件
最终生成的jar包结构
META-INF
Hello.class
text.txt
方法步骤
1 import java.io.InputStream; 2 import java.io.BufferedReader; 3 import java.io.InputStreamReader; 45 class Hello{ 6 public static void main(String[] args) throws Exception{ 7 Hello hello = new Hello(); 8 InputStream is = hello.getClass().getResourceAsStream("text.txt"); 9 print(is);10 }11 12 /**13* 读取文件,输出里面的内容,通用方法14*/15 public static void print(InputStream inputStream) throws Exception {16 InputStreamReader reader = new InputStreamReader(inputStream, "utf-8");17 BufferedReader br = new BufferedReader(reader);18 String s = "";19 while ((s = br.readLine()) != null)20 System.out.println(s);21 inputStream.close();22 }23 }
2、资源文件在另一个jar包内部——读取另一个jar内的文件
最终生成的jar包结构
hello.jar
resource.jar
text.txt
方法步骤
同1一样,只不过需要在MENIFEST文件中将resource.jar加入classpath
1 import java.io.InputStream; 2 import java.io.BufferedReader; 3 import java.io.InputStreamReader; 45 class Hello{ 6 public static void main(String[] args) throws Exception{ 7 Hello hello = new Hello(); 8 InputStream is = hello.getClass().getResourceAsStream("text.txt"); 9 print(is);10 }11 12 /**13* 读取文件,输出里面的内容,通用方法14*/15 public static void print(InputStream inputStream) throws Exception {16 InputStreamReader reader = new InputStreamReader(inputStream, "utf-8");17 BufferedReader br = new BufferedReader(reader);18 String s = "";19 while ((s = br.readLine()) != null)20 System.out.println(s);21 inputStream.close();22 }23 }
3、资源文件在jar包外部——读取jar外的文件
最终生成的jar包结构
hello.jar
text.txt
方法步骤
1 import java.io.InputStream; 2 import java.io.BufferedReader; 3 import java.io.InputStreamReader; 4 import java.io.FileInputStream; 56 class Hello{ 7 public static void main(String[] args) throws Exception{ 8 Hello hello = new Hello(); 9 InputStream is = new FileInputStream("text.txt");10 print(is);11 }12 13 /**14* 读取文件,输出里面的内容,通用方法15*/16 public static void print(InputStream inputStream) throws Exception {17 InputStreamReader reader = new InputStreamReader(inputStream, "utf-8");18 BufferedReader br = new BufferedReader(reader);19 String s = "";20 while ((s = br.readLine()) != null)21 System.out.println(s);22 inputStream.close();23 }24 }
参考:https://www.cnblogs.com/mq0036/category/1141655.html