注册 登录  
 加关注
查看详情
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

淡泊明智

 
 
 

日志

 
 

Jar命令行打包(2009-06-09 20:59:45| 分类: java 技术)  

2012-04-18 22:37:58|  分类: java基础知识 |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |

1. JAR文件包

  JAR文件就是Java Archive File,顾名思意,它的应用是与Java息息相关的,是Java的一种文档格式。JAR文件非常类似ZIP文件。准确的说,它就是ZIP文件,所以叫它文件包。JAR文件与ZIP文件唯一的区别就是在JAR文件的内容中,包含了一个META-INF/MANIFEST.MF文件,这个文件是在生成JAR文件的时候自动创建的。举个例子,如果我们具有如下目录结构的一些文件:

  ../
  -- test
   -- Test.class

  把它压缩成ZIP文件test.zip,则这个ZIP文件的内部目录结构为:

  test.zp
  -- test
    -- Test.class

  如果我们使用JDK的jar命令把它打成JAR文件包test.jar,则这个JAR文件的内部目录结构为:

  test.jar
  -- META-INF
   -- MANIFEST.MF
  -- test
   --Test.class

2. 创建可执行的JAR文件包

  制作一个可执行的JAR文件包来发布你的程序是JAR文件包最典型的用法。

  Java程序是由若干个.class文件组成的。这些.class文件必须根据它们所属的包不同而分级分目录存放;运行前需要把所有用到的包的根目录指定给CLASSPATH环境变量或者java命令的-cp参数;运行时还要到控制台下去使用java命令来运行,如果需要直接双击运行必须写Windows的批处理文件(.bat)或者Linux的Shell程序。因此,许多人说,Java是一种方便开发者苦了用户的程序设计语言。

  其实不然,如果开发者能够制作一个可执行的JAR文件包交给用户,那么用户使用起来就需要方便了。在Windows下安装JRE(Java Runtime Environment)的时候,安装文件会将.jar文件映射给javaw.exe打开。那么,对于一个可执行的JAR文件包,用户只需要双击它就可以运行程序了,和阅读.chm文档一样方便(.chm 文档默认是由 hh.exe 打开的)。那么,现在的关键,就是如何来创建这个可执行的JAR文件包。

  创建可执行的JAR文件包,需要使用带cvfm参数的jar命令,同样以上述test目录为例,命令如下:

        这里test.jar和manifest.mf两个文件,分别是对应的参数f和m,其重头戏在manifest.mf。因为要创建可执行的JAR文件包,光靠指定一个manifest.mf文件是不够的,因为MANIFEST是JAR文件包的特征,可执行的JAR文件包和不可执行的JAR文件包都包含MANIFEST。关键在于可执行JAR文件包的MANIFEST,其内容包含了Main-Class一项。这在MANIFEST中书写格式如下:

  Main-Class: 可执行主类全名(包含包名)

  例如,假设上例中的Test.class是属于test包的,而且是可执行的类(定义了public static void main(String[]) 方法),那么这个manifest.mf可以编辑如下:

  Main-Class: test.Test <回车>

  这个manifest.mf可以放在任何位置,也可以是其它的文件名,只需要有Main-Class: test.Test一行,且该行以一个回车符结束即可。创建了manifest.mf文件之后,我们的目录结构变为:

  ../
  -- test
   -- Test.class
  -- manifest.mf

  这时候,需要到test目录的上级目录中去使用jar命令来创建JAR文件包。也就是在目录树中使用../表示的那个目录中,使用如下命令

        之后在../目录中创建test.jar,这个test.jar就是执行的JAR文件包。运行时只需要使用java -jar test.jar命令即可。

  需要注意的是,创建的JAR文件包中需要包含完整的、与Java程序的包结构对应的目录结构,就像上例一样。而Main-Class指定的类,也必须是完整的、包含包路径的类名,如上例的test.Test;而且在没有打成JAR文件包之前可以使用java<类名>来运行这个类,即在上例中java test.Test是可以正确运行的(当然要在CLASSPATH正确的情况下)。

3. jar命令详解

  jar是随JDK安装的,在JDK安装目录下的bin目录中,Windows下文件名为jar.exe,Linux下文件名为jar。它的运行需要用到JDK安装目录下lib目录中的tools.jar文件。不过我们除了安装JDK什么也不需要做,因为SUN已经帮我们做好了。我们甚至不需要将tools.jar放到CLASSPATH中。

  使用不带任何的jar命令我们可以看到jar命令的用法如下:

        其中{ctxu}是jar命令的子命令,每次jar命令只能包含ctxu中的一个,它们分别表示:

  -c 创建新的JAR文件包
  -t 列出JAR文件包的内容列表
  -x 展开JAR文件包的指定文件或者所有文件
  -u 更新已存在的JAR文件包(添加文件到JAR文件包中)

  [vfm0M]中的选项可以任选,也可以不选,它们是jar命令的选项参数

  -v 生成详细报告并打印到标准输出
  -f 指定JAR文件名,通常这个参数是必须的
  -m 指定需要包含的MANIFEST清单文件
  -0 只存储,不压缩,这样产生的JAR文件包会比不用该参数产生的体积大,但速度更快
  -M 不产生所有项的清单(MANIFEST)文件,此参数会忽略-m参数

  [jar-文件]即需要生成、查看、更新或者解开的JAR文件包,它是-f参数的附属参数
  [manifest-文件] 即 MANIFEST 清单文件,它是 -m 参数的附属参数

  [-C 目录]表示转到指定目录下去执行这个jar命令的操作。它相当于先使用cd命令转该目录下再执行不带-C参数的jar命令,它只能在创建和更新JAR文件包的时候可用。

  文件名... 指定一个文件/目录列表,这些文件/目录就是要添加到JAR文件包中的文件/目录。如果指定了目录,那么jar命令打包的时候会自动把该目录中的所有文件和子目录打入包中。

  下面举一些例子来说明jar命令的用法:

  1) jar cf test.jar test

  该命令没有执行过程的显示,执行结果是在当前目录生成了test.jar 文件。如果当前目录已经存在test.jar,那么该文件将被覆盖。

  2) jar cvf test.jar test

  该命令与上例中的结果相同,但是由于v参数的作用,显示出了打包过程,如下:

  标明清单(manifest)
  增加:test/(读入= 0) (写出= 0)(存储了 0%)
  增加:test/Test.class(读入= 7) (写出= 6)(压缩了 14%)

  3) jar cvfM test.jar test

  该命令与 2) 结果类似,但在生成的test.jar中没有包含META-INF/MANIFEST文件,打包过程的信息也略有差别:

  增加:test/(读入= 0) (写出= 0)(存储了 0%)
  增加:test/Test.class(读入= 7) (写出= 6)(压缩了 14%)

  4) jar cvfm test.jar manifest.mf test

  运行结果与 2) 相似,显示信息也相同,只是生成JAR包中的META-INF/MANIFEST内容不同,是包含了manifest.mf的内容

  5) jar tf test.jar

  在test.jar已经存在的情况下,可以查看test.jar中的内容,如对于 2) 和 3) 生成的test.jar分别应该此命令,结果如下;

    对于 2)

    META-INF/
    META-INF/MANIFEST.MF
    test/
    test/Test.class

    对于 3)

    test/
    test/Test.class

  6) jar tvf test.jar

  除显示 5) 中显示的内容外,还包括包内文件的详细信息,如:

     0 Wed Jun 19 15:39:06 GMT 2002 META-INF/
    86 Wed Jun 19 15:39:06 GMT 2002 META-INF/MANIFEST.MF
     0 Wed Jun 19 15:33:04 GMT 2002 test/
     7 Wed Jun 19 15:33:04 GMT 2002 test/Test.class

  7) jar xf test.jar

  解开test.jar到当前目录,不显示任何信息,对于 2) 生成的test.jar,解开后的目录结构如下:
  ../
  -- META-INF
   -- MANIFEST
  -- test
   -- Test.class

  8) jar xvf test.jar

  运行结果与7) 相同,对于解压过程有详细信息显示,如:

  创建:META-INF/
  展开:META-INF/MANIFEST.MF
  创建:test/
  展开:test/Test.class

  9) jar uf test.jar manifest.mf

  在test.jar中添加了文件manifest.mf,此使用jar tf来查看test.jar可以发现test.jar中比原来多了一个manifest。这里顺便提一下,如果使用-m参数并指定manifest.mf文件,那么manifest.mf是作为清单文件MANIFEST来使用的,它的内容会被添加到MANIFEST中;但是,如果作为一般文件添加到JAR文件包中,它跟一般文件无异。

  10) jar uvf test.jar manifest.mf

  与 9) 结果相同,同时有详细信息显示,如:

  增加:manifest.mf(读入= 17) (写出= 19)(压缩了 -11%)

4. 关于JAR文件包的一些技巧

  1) 使用unzip来解压JAR文件

  在介绍JAR文件的时候就已经说过了,JAR文件实际上就是ZIP文件,所以可以使用常见的一些解压ZIP文件的工具来解压JAR文件,如Windows下的WinZip、WinRAR等和Linux下的unzip 等。使用WinZip和WinRAR等来解压是因为它们解压比较直观,方便。而使用unzip,则是因为它解压时可以使用-d参数指定目标目录。

  在解压一个JAR文件的时候是不能使用jar的-C参数来指定解压的目标的,因为-C 参数只在创建或者更新包的时候可用。那么需要将文件解压到某个指定目录下的时候就需要先将这具JAR文件拷贝到目标目录下,再进行解压,比较麻烦。如果使用unzip,就不需要这么麻烦了,只需要指定一个-d参数即可。如:

        2) 使用WinZip或者WinRAR等工具创建JAR文件

  上面提到JAR文件就是包含了META-INF/MANIFEST的ZIP文件,所以,只需要使用WinZip、WinRAR等工具创建所需要ZIP压缩包,再往这个ZIP压缩包中添加一个包含MANIFEST文件的META-INF目录即可。对于使用jar命令的-m参数指定清单文件的情况,只需要将这个MANIFEST按需要修改即可。

  3) 使用jar命令创建ZIP文件

  有些Linux下提供了unzip命令,但没有zip命令,所以需要可以对ZIP文件进行解压,即不能创建ZIP文件。如要创建一个ZIP文件,使用带-M参数的jar命令即可,因为-M参数表示制作JAR包的时候不添加MANIFEST清单,那么只需要在指定目标JAR文件的地方将.jar扩展名改为.zip扩展名,创建的就是一个不折不扣的ZIP文件了,如将上一节的第 3)个例子略作改动:

5. 关于Manifest.mf的一些说明

  Manifest-Version: 1.0
  Main-Class: main.Test
  Class-Path: ./lib/swt.jar ./lib/jface.jar

  其中Mainfest-Version为发布版本号,Main-Class为main函数所在的class,也是程序的入口。注意,中间是.号而不是通常意义下的/或者\。Class-Path为程序说引用的库,中间用空格隔开。所有冒号后面也均有一个空格。

  评论这张
 
阅读(316)| 评论(0)
推荐 转载

历史上的今天

评论

<#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
 
 
 
 
 
 
 
 
 
 
 
 
 
 

页脚

网易公司版权所有 ©1997-2018