创建可执行的Jar文件

创建可执行的Jar文件

   假定我们已经创建好了一个GUI程序,但我们使用的是java命令从命令行启动。很显然,这会让Windows用户感到不舒服。一个较好的解决办法是将这个(或这些)class文件打包成一个可执行的jar文件。具体来说,我们可以按照如下的步骤来进行:

1.       创建一个Manifest.mf文件

该文件至少有如下三行:

Manifest-Version: 1.0

Main-Class: WinDumper

   第一行放置当前Manifest文件的版本,第二行则是放置的是Main-Class,Java要从其main函数启动(这也表明该Main-Class属性标注的class-----在上面的例子中是WinDumper(注意不加class扩展名)----必须得有一个main函数).第三行是一个空行,如果没有这个空行,运行生成的jar文件将不会成功.

   关于Manifest文件的规范,可以参考Javadoc(docs/guide/jar/jar.html).

2.       使用jar命令创建Jar文件

与java命令一样,jar命令对应着实用工具jar(位于java安装目录下的bin/jar.exe).在命令行中键入jar并回车,可以看到jar命令的使用方法和两个示例:

用法：jar {ctxu}[vfm0Mi] [jar-文件] [manifest-文件] [-C 目录] 文件名 ...

选项：

   -c  创建新的存档

   -t  列出存档内容的列表

   -x  展开存档中的命名的（或所有的〕文件

   -u  更新已存在的存档

   -v  生成详细输出到标准输出上

   -f  指定存档文件名

   -m  包含来自标明文件的标明信息

   -0  只存储方式；未用ZIP压缩格式

   -M  不产生所有项的清单（manifest〕文件

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

   -C  改变到指定的目录，并且包含下列文件：

如果一个文件名是一个目录，它将被递归处理。

清单（manifest〕文件名和存档文件名都需要被指定，按'm' 和 'f'标志指定的相同顺序。

示例1：将两个class文件存档到一个名为 'classes.jar' 的存档文件中：

      jar cvf classes.jar Foo.class Bar.class

示例2：用一个存在的清单（manifest）文件 'mymanifest' 将 foo/ 目录下的所有

          文件存档到一个名为 'classes.jar' 的存档文件中：

      jar cvfm classes.jar mymanifest -C foo/ .

根据这两个有用的示例,我们可以很容易掌握jar命令的用法.需要提醒的是,在将class打包的时候需要将所有涉及到的包进行打包.对于系统提供的class,比如javax.swing.JTextField之类,不必理会它们.当你使用了附加的class时,你得保证这一点.

下面是一个例子:

C:\Documents and Settings\eboy\Desktop>jar cvfm WinDumper.jar Manifest.mf WinDum

per.class WinDumper$1.class WinDumper$2.class -C D:/MyJava com/zg/util/Console.c

lass -C D:/MyJava com/zg/util/MySqlConnection.class -C E:/mmmysql org/gjt/mm/mys

ql/ -C D:/MyJava com/zg/util/Dumper.class

  这里我们将生成的jar文件命名为WinDumper.jar,并使用了前面创建的Manifest.mf文件.在这个参数后的参数用来表示要打包的文件(可以不是class文件,比如可以打包图片等等资源).在这里,我们编译WinDumper.java源程序,生成了WinDumper.class,WinDumper$1.class和WinDumper$2.class三个class文件,很显然这三个是必须打包的.另外,在WinDumper中我们还使用了位于D:/MyJava/com/zg/util文件夹下的Console.class,而这个class对应的原文件的第一句非注释性语句是:package com.zg.util;于是,我们使用参数-C将目录改变至D:/MyJava 并在其后紧跟com/zg/util/Console.class 来完成对其打包.”-C D:/MyJava com/zg/util/MySqlConnection.class”一句情况类似,完成了对com.zg.util.MySqlConnection.class的打包.由于WinDumper类使用了MySql数据库,必须对数据库中涉及的类(如Driver类)进行打包.由于这些类可能互相引用,我们将E:/mmmysql/org/git/mm/mysql/ 目录下的所有文件进行打包.

   类是否被完全打包?这不能通过运行jar文件来得知,如果你如此,可能会得到如下的结果:

或是一个僵死的界面。如果你遭遇这些情况,你得考虑是否打包了所有的类。我们可以这样来测试这个问题:

使用命令行方式:java –jar YourJarFile.jar

来运行Jar文件,如果出现任何异常,你可以在控制台上收到消息。

    打包完成后,生成的WinDumper.jar文件具有这样的文件布局(由于一个jar文件就是一个压缩文件,我们可以使用WinRAR之类的工具将其开启):

   在一个名为META-INF的文件夹中放置的是Manifest.mf文件,不过这个文件已经被修改过了,我们查看其内容如下:

Manifest-Version: 1.0

Created-By: 1.4.2(Sun Microsystem Inc.)

Main-Class: WinDumper

文件被添加了Create-By属性,在文件最后是2个空行.我们同时发现了这样的目录结构:

            com/zg/util/ 以及 org/gjt/mm/mysql/

这与我们添加文件的目录是相同的(想想com/zg/util/Console.class等等的添加方式).[可以想象,如果我们没有使用-C参数,而是直接写作D:/MyJava/com/zg/util/Console.class,在Jar文件中将会出现D:/MyJava/com/zg/util/这样的目录结构,这会导致某些类无法装载].

3.       执行Jar文件

双击上面生成的Jar文件,javaw.exe将打开它.