One-Jar之旅

1 问题的提出

作为一个经常使用Java编程的程序员，当我在发布我的Java程序的时候，我习惯于这样组织所有的程序和资源：主程序放到JVM系统变量“user.dir”所指向的目录中（假设是MyAppDir目录），程序所用到的工具类（通常是打好包的jar文件）放到MyAppDir/lib/目录，其他资源（如图片等）放到MyAppDir/res/目录，然后写一个批处理文件，在里面设置好环境变量和各种路径，最后将所有的这些东西交给用户。但是如果这个程序不是很大的话，是不是心里觉得这么多目录和文件有点不够简洁？会不会觉得运行bat文件出来的那个Dos窗口有点碍眼？会不会羡慕Windows编程人员可以把所有资源和程序都放到一个exe文件中？下面我们就来着手解决这些问题。

2 解决方案

我们先提出一个实际的例子来说明这个问题：我的应用程序的主类为cn.edu.hlju.ica.app.Main，它位于mainApp.jar中。Main类需要用到位于tools.jar中的com.util.Tool类。通常的做法是将tools.jar放到MyAppDir/lib/目录下，然后执行

java –classpath .;./lib/tools.jar –jar mainApp.jar

但是如果我想把tools.jar和mainApp.jar打包到一起，把它们都放到OneJarApp.jar中，然后只需要执行

java –jar OneJarApp.jar

这样该多好啊，尤其是当你需要的jar文件比较多的时候，无论是这些jar包的组织，还是bat文件的书写都是挺麻烦的事。下面我们就分析一下解决方法。

n 第一种：也是最容易想到的方法，就上例来说，我们可以将tools.jar和mainApp.jar都展开，然后将com.util.Tool（本来位于tools.jar中）和cn.edu.hlju.ica.app.Main（本来位于mainApp.jar中）一起打包成OneJarApp.jar。有很多开发环境如JBuilder或干脆用jar命令都可以很容易做到，但是这样做会产生一些很严重的问题：如果Main类不只需要一个而是需要两个分别位于toolsOne.jar和toolsTwo.jar中的类com/a/A.class和com/b/B.class，而A和B都需要引用在各自的jar文件中com/目录下的一个资源，比如说是com/log4J.property，这时如果将它们展开，并入到一个jar文件的时候，你该选择哪一个资源呢？再有，如果toolsTwo.jar的许可明确要求你再重新发布之前不能修改它，你该怎么办？这种方法显然不够通用，而且在某些情况下回出现问题。

n 第二种：在回过头来看我们的实例，既然不能把现有的tools.jar文件展开，那我们干脆就把它和mainApp.jar一起打包成OneJarApp.jar中行吗？即下面的组织形式：

OneJarApp.jar

|--META-INF/MANIFEST.MF

|--mainApp.jar

|--cn/edu/hlju/ica/app/Main.class

|--tools.jar

|--com.util.Tool

然后我们在MANIFEST.MF中制定Class-Path属性，希望类装载器在启动程序的同时也可以正确

的装载其他jar文件。很不幸，这样做是行不通的。因为系统类装载器并不能从嵌入的jar

（tools.jar就是嵌入到了OneJarApp.jar中）文件中读取所需的类。所以我们需要使用自定义类

装载器来完成这项工作，不过不用担心，开源工程One-JAR已经为我们做好了相关工作，我们只需

很少几步操作就可以达成目的。

3 One-Jar简介

One-Jar是SourceForge上的一个开源工程，它使用自定义的类装载器从嵌入的jar文件中载入类和资源，从而可以使原来的程序中所有用到的jar文件（包括主类所在的jar文件）都打包到一个jar文件中，且原来的程序不需要做任何修改，然后我们就可以简单的通过java –jar OneJarApp.jar来运行该应用程序，是不是很理想？

该工程短小精悍，只有三个类，分别是：

com.simontuffs.onejar.JarClassLoader

com.simontuffs.onejar.Boot

com.simontuffs.onejar.Handler

它的实现原理是：程序运行之初首先由One-Jar接手，它先通过其自定义的类装载器装载嵌入的各个jar文件，然后利用reflectionAPI调用你的应用程序的主函数，使你的应用程序得以执行。但是它对各个嵌入的jar文件在宿主jar文件中的位置有一定的要求，即含有主类的jar文件必须放在宿主jar文件的main/目录下，其他的jar文件放到宿主jar文件的lib/目录下。还是上面的例子，主类cn.edu.hlju.ica.app.Main位于mainApp.jar中，Main所用到的com.util.Tool位于tools.jar中，最终要将它们都打包成OneJarApp.jar，其目录结构应如下

OneJarApp.jar

|--META-INF/MANIFEST.MF

|--main

|--mainApp.jar

|--META-INF/MANIFEST.MF

|--cn/edu/hlju/ica/app/Main.class

|--bin

|--tools.jar

|--com.util.Tool

|--com/simontuffs/onejar

|-- Boot.class

|-- Handler.class

|-- JarClassLoader.class

注意，这里的（红色）MANIFEST.MF是One-JAR工程自带的

，而不是你的应用程序的（绿色）MANIFEST.MF（你应用程序的MANIFEST.MF在mainApp.jar中

）；而One—Jar工程的三个类也必须包含在OneJarApp.jar中。

下面是各个类的代码

Main.java

package cn.edu.hlju.ica.app;

import com.util.*;

public class Main {

public static void main(String[] args) {

new Tool();

}

}

Tool.java

package com.util;

public class Tool {

static {

System.out.println("创建了一个Win32版的Tool实例");

}

}

目录结构如下

最外层的MANIFEST.MF文件内容如下：

Manifest-Version: 1.0

Main-Class: com.simontuffs.onejar.Boot

One-Jar-Expand: expand,doc

执行结果

4 扩展应用

仅仅做到以上功能是不够的，我们在解决实际问题时还会遇到一些更为复杂的情况。比如说如果我们要做串口通信的程序，需要用到SUN的串口包comm.jar，但是Windows平台和Linux平台的串口包虽然API名字相同但是内部实现却不同。所以如果我的程序需要跨平台使用的话，就需要在执行期动态选择相应的串口包。但是按照上面的方法，我们的两个串口包都要放宿主jar文件的lib/目录下，这时会发生什么情况呢？会不会发生混淆呢？答案是会，并且One-Jar也作了一些比较初级的处理操作。还是拿我们上面那个例子。我的程序要同时支持Windows平台和Linux平台，所以我的com.util.Tool有两个版本，分别打包到tools_windows.jar和tools_linux.jar中，然后我将它们都放到OneJarApp.jar的lib/目录下，执行-Done-jar.verbose来查看执行的详细信息：

我们看到，2的位置One-Jar的ClassLoader载入了Linux版的Tool；3的位置上，类装载器又试图载入Tool类的windows版，但是从下面画线部分我们可以看到，Tool的windows版并没有载入成功，因为类装载器不能两次载入同一个类，虽然它们实现不同，但是它们的名字一样，都是com.util.Tool，所以windows版就被之前载入的Linux版屏蔽了。从4看到程序可以正常运行。但是One-Jar并没有给我们控制到底选哪一个的权力，所以我们需要对One-Jar修改和扩充。

我们的目标是One-Jar的自定义的类装载器，我们只需要控制其类的装载过程，即JarClassLoader的load(String,String)方法，就可以达到我们的目的。我们首先看一下load()方法的主要部分：

public String load(String mainClass, String jarName) {

………省略

if (jarName == null) {

jarName = System.getProperty(JAVA_CLASS_PATH);

}

//获得jarName所代表的jar文件中所包含的的全部项目

JarFile jarFile = new JarFile(jarName);

Enumeration myEnum = jarFile.entries();

Manifest manifest = jarFile.getManifest();

while (myEnum.hasMoreElements()) {

JarEntry entry = (JarEntry)myEnum.nextElement();

if (entry.isDirectory())

continue;

………省略

//打印提示信息

INFO("caching " + jar);

VERBOSE("using jarFile.getInputStream(" + entry + ")");

{

// Note: loadByteCode consumes the input stream, so make sure //its scope

// does not extend beyond here.

//注意以下部分

InputStream is = jarFile.getInputStream(entry);

if (is == null)

throw new IOException("Unable to load resource /" + jar + " using " + this);

loadByteCode(is, jar);

}

………省略

}

请注意看红颜色的部分，One-Jar在这里直接用JarEntry entry生成输入流，再由loadByteCode()载入其字节

码，请注意，这里的entry就是要嵌入的jar文件对象，即tools_windows.jar或tools_linux.jar，如果我们在语句

InputStream is = jarFile.getInputStream(entry);

之前判断一下本地操作系统的类型，再结合jar文件的后缀”_windows”或”_linux”就可以选择性的载入与

本地操作系统相配的jar文件了。为此，我生成了JarClassLoaderEx类，它是JarClassLoader的子类，并且只

覆些了JarClassLoader的load(String,String)方法。我们需要通过JVM属性（我自己定义的属：loader.type）

进行控制，如果loader.type=exLoader，则选择采用JarClassLoaderEx，否则保持不变，仍然采用

JarClassLoader。为达到这一目的，我们需要在com.simontuffs.onejar.Boot类中判loader.type属性的值如果

是ExLoader就生成JarClassLoaderEx实例，否则就生成JarClassLoader实例。重要代码片断如下：

这里我定义了一个osType，用来判定本地操作系统的类型。接下来

我们通过jar文件的后缀，就可以判断它是否是适合本地平台了，如果不适合就跳过此jar文件的装载过程。上

面已经有了Windows版的Tool类，这里再给出Linux版的Tool类的实现：

Tool.java--------Linux版

package com.util;

public class Tool {

static {

System.out.println("创建了一个Linux版的Tool实例");

}

}

下面我们来看一下结果，首先我们设置JVM系统属性”os.name”为Windows系统时：

当我们设定”os.name”为Linux系统时：

5 后记

通过研究Boot类的代码我们可以看到，One-Jar有一个默认的设置JVM系统变量的的机制，即将一个one-jar.property的文件放到最终的jar文件的根目录下：

你可以在其中设置一些你自己的属性对，由One-Jar负责帮你将其添加加到JVM中。

6 结束语

至此，我们的One-Jar之旅也告一段落了，相信你看完这篇短文后也能自己动手定制属于你自己的One-Jar来实现更丰富的功能，充分享受开源给我们带来的美妙世界。我是用Eclipse来编写全部代码的，如果有需要源码的话，请和我联系。