在JAR中打包使用JAR库

不知大家在写Java程序的时候有没有这种需求: 将引用其他第三方JAR库的项目打包成一个JAR文件执行.也就是说在你打包好的JAR文件里再包括那些你引用的第三方JAR文件,合成一个JAR包,这样仅仅需在Windows下双击,或在Linux终端下输入 java -jar yourjarfile.jar就可以方便执行.在最初一种普遍的做法是在打包的JAR文件里的META-INF/MANIFEST里使用Class-Path选项,像这样:

Manifest-Version: 1.0
Created-By: 1.7.0_06-b24 (Oracle Corporation)
Main-Class: YOUR.MAIN.CLASS.NAME.HERE
Class-Path: lib1.jar lib2.jar lib3.jar

但这样在执行这个JAR包时仍然须要将引用的lib1.jar,lib2.jar,lib3.jar放入你打包的JAR文件文件夹中.即使你将其打包进你的JAR包中,仍不能够独立执行.

曾经这样打包的问题一直困扰着我,难道在Java中就不能像exe打包程序那样一个文件单独跑吗?

直到今天再次遇到这个问题时,GOOGLE了一下找到了一个不错的解决方式.就是使用第三方工具包One-Jar.相应下载地址:http://sourceforge.net/projects/one-jar/

使用One-Jar很的简单.仅仅须要简单的几步,但在使用One-Jar之前须要事先自行将自己的项目使用jar命令打包成JAR包,当中不包含三方JAR包,再进行例如以下操作:

1.创建一个名为"root"的工作文件夹,当中再包括两个名为"main"和"lib"的子文件夹；

2.顾名思意,这里root/main用于存放你自己已经打包好了的JAR文件,并将它改名为main.jar,注意在打包你的class文件时,不要包括不论什么你引用的JAR包.而相应的root/lib才用来存放那些你引用的第三方JAR包.

3.从One-Jar官网中下载最新的One-Jar包.并将它解压放入到root文件夹中,相应的重名文件夹合并.同一时候去掉"src"文件夹.(注意在解包One-Jar时的隐藏文件).

4.再在root文件夹中新建一个名为boot-manifest.mf的文件,其内容例如以下:

Manifest-Version: 1.0
Main-Class: com.simontuffs.onejar.Boot
One-Jar-Main-Class: YOUR.MAIN.CLASS.NAME.HERE

5.最后一步,在命令行下输入cd root进入root文件夹,然后执行java的打包命令例如以下:

jar -cvfm ../你的程序名.jar boot-manifest.mf .

执行后,假设一切顺利,则会在root文件夹的上层文件夹中生成"你的程序名.jar"的文件,这时在windows环境中,你仅仅须要双击这个文件则能够执行启动你的程序.就这种一个文件,很的给力!哈哈

在进行One-Jar的打包时一定要注意它的相应文件夹结构,例如以下给出root文件夹具体的结构说明:

root文件夹
|  .version
|  one-jar-$project$.jar
|  OneJar.class
|  boot-manifest.mf          # 你新建的boot-manifest.mf
|  com/simontuffs/onejar     # One-Jar的源文件文件夹
   |  Boot.class, ...etc.
|  doc/one-jar-license.txt   # 相应的软件协议
|  main/main.jar             # 你的程序JAR
|  lib/a.jar ...etc.         # 你程序依赖的第三方JAR包

假设一切都是依照上面的文件夹结构来的,应该就不会有问题.事实上One-Jar不仅能够单独使用,还能够与Ant与Meavn等Java项目源代码管理软件结合使用,在这里就不细说了(哈哈, 关键是我没有试~),感兴趣能够到http://one-jar.sourceforge.net/index.php?page=getting-started&file=quickstart处查看.

条条道路通罗马,不只One-Jar能够,我还查了一下,还有UberJar或Shade也具有相同的功能.只只是它俩好像还须要依赖Maven.相应stackoverflow上大神的原话(处出:http://stackoverflow.com/questions/183292/classpath-including-jar-within-a-jar):

If you're trying to create a single jar that contains your application and it's required libraries, there are two ways (that I know of) to do that. The first is One-Jar, which uses a special classloader to allow the nesting of jars. The second is UberJar,
(or Shade), which explodes the included libraries and puts all the classes in the top-level jar.I should also mention that UberJar and Shade are plugins for Maven1 and Maven2 respectively. As mentioned below, you can also use the assembly plugin (which in
reality is much more powerful, but much harder to properly configure).

关于Java启动器为什不能使用Class-Path载入JAR包里面的JAR库,也在stackoverflow上找到了相应的解释说明(出处:http://stackoverflow.com/questions/12357136/reference-jars-inside-a-jar),例如以下:

The Java Launcher$AppClassLoader does not know how to load classes from a Jar inside a Jar with this kind of Class-Path. Trying to use jar:file:jarname.jar!/commons-logging.jar also leads down a dead-end.
This approach will only work if you install (i.e. scatter) the supporting Jar files into the directory where the jarname.jar file is installed.

最后关于One-Jar的原理的一点小小的猜想:我想就是使用Java库中的某个工具类,先事强制载入指定文件夹的JAR包于内存.然后使用反射机制调用META-INF/MANIFEST文件里One-Jar-Main-Class项指定类的main方法,实现程序启动的目地的吧.而详细怎么实现就要好好的研究One-Jar的源代码了~