怎么看jar的javadoc jar如何查看内容

转载

mob64ca140f29e5 2024-07-28 17:26:27

文章标签 怎么看jar的javadoc 操作系统开发工具 web.xml jar 文章分类 Java 后端开发

[b]JAVA jar打包时MANIFEST.MF格式约定[/b]
[url]http://www.thinksaas.cn/topics/0/340/340208.html[/url]

Manifest-Version: 1.0 
Created-By: Fat Jar Eclipse Plug-In 
Main-Class: com.lwf.main.TestMain
Class-Path: ./JAR/lib/lwf.jar 
./JAR/lib/tt.jar

在上面内容中注意几点：

[color=red]

1、Main-Class: com.lwf.main.TestMain与Class-Path:之间不能有空格，写的时候把Main-Class: com.lwf.main.TestMain写完后直接回车接着写Class-Path:。

2、Main-Class:后面有个空格再写内容com.lwf.main.TestMain

3、Class-Path: ./JAR/lib/lwf.jar ./JAR/lib/tt.jar这一行中，不同lib中间有一个空格，最后一个jar写完后要回车

[/color]

[b]java中的manifest文件格式[/b]

[url]http://huanghuizz.iteye.com/blog/503932[/url]

在打jar包时，我们有时需要对manifest文件进行描述，在这里记录manifest相关的格式，以供日后参考。

manifest基本格式：

manifest 文件的格式是很简单的，每一行都是名－值对应的:属性名开头，接着是 ":" ，然后是属性值，每行最多72个字符，如果需要增加，你可以在下一行续行，续行以空格开头，以空格开头的行都会被视为前一行的续行，所有在开头的属性都是全局的。

有main函数的jar包的manifest的格式：

Manifest-Version:1.0

Created-By:1.5.08 (Sun Microsystems Inc.)

Main-Class: com.pantosoft.impdb.ImpMain

Manifest-Version表示使用1.0的manifest文件

Created-By表示使用了的sun的1.5.08的jar生成

Main-Class表示有主函数的类

基于其他jar并有main函数的manifest的格式：

Manifest-Version:1.0

Created-By:1.5.08 (Sun Microsystems Inc.)

Main-Class: com.pantosoft.impdb.ImpMain

Class-Path:mail.jar activation.jar

Class-Path表示基于其他的2个jar包，并且以空格隔开表示有个jar包。如有路径，侧表示如下：

Class-Path:ext/mail.jar ext/activation.jar

基于其他jar并有多个main函数的manifest的格式：

还有一种Multiple Main Classes情况，如果你的应用程序可能有命令行版本和GUI版本，或者一些不同的应用共享很多相同的代码，这时你可能有多个Main Class，我们建议你采取这样的策略：把共享的类打成lib包，然后把不同的应用打成不同的包，分别标志主类：如下

Manifest for impDB.jar :
       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)
       Class-Path:mail.jar activation.jar

       Manifest for impDB.jar :
       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)
       Class-Path:impDB.jar
       Main-Class: com.pantosoft.impdb.ImpMain

       Manifest for ExpDB.jar :
       Manifest-Version:1.0
       Created-By:1.5.08 (Sun   Microsystems   Inc.)
       Class-Path:expDB.jar
       Main-Class: com.pantosoft.impdb.ExpMain

在 impDB.jar 和 ExpDB.jar 的manifest文件中分别注明各自的 Main Class

Package Versioning：

完成发布后，如果使用者想了解，哪些代码是谁的？目前是什么版本？使用什么版本的类库？解决的方法很多，manifest提供了一个较好的方法，你可以在manifest文件中描述每一个包的信息。Java 秉承了实现说明与描述分离的原则，package 的描述定义了package 是什么，实现说明定义了谁提供了描述的实现，描述和实现包含名、版本号和提供者。要得到这些信息，可以查看JVM的系统属性（使用 java.lang.System.getProperty() ）在manifest文件中，我可以为每个package定义描述和实现版本，声明名字，并加入描述属性和实现属性，这些属性是：

Specification-Title

Specification-Version

Specification-Vendor

Implementation-Title

Implementation-Version

Implementation-Vendor

当要提供一个类库或编程接口时，描述信息显得是很重要，见以下范例：

Manifest-Version:1.0
Created-By:1.5.08 (Sun   Microsystems   Inc.)
Class-Path: mail.jar activation.jar

Name: com/example/myapp/
Specification-Title: MyApp
Specification-Version: 2.4
Specification-Vendor: example.com
Implementation-Title: com.example.myapp
Implementation-Version: 2002-03-05-A
Implementation-Vendor: example.com

Package Version 查询：

在manifest文件中加入package描述后，就可以使用Java提供的java.lang.Package class进行Package 的信息查询，这里列举3个最基本的获取package object的方法：

1.Package.getPackages():返回系统中所有定义的package列表

2.Package.getPackage(String packagename):按名返回package

3.Class.getPackage():返回给定class所在的package

使用这方法就可以动态的获取package信息. 需要注意的是如果给定的package中没有class被加载,则也无法获得package 对象

Manifest 技巧：

[quote]总是以Manifest-Version属性开头

每行最长72个字符，如果超过的化，采用续行

确认每行都以回车结束，否则改行将会被忽略

如果Class-Path 中的存在路径，使用"/"分隔目录，与平台无关

使用空行分隔主属性和package属性

使用"/"而不是"."来分隔package 和class ,比如 com/example/myapp/

class 要以.class结尾，package 要以 / 结尾

[/quote]

[b]多个.class 打包成 .jar[/b]

[url][/url]

Java jar命令

比如您的class包存放路径为 d:/com/demo (demo是个目录，下面含有子文件夹及class文件)

具体操作如下：

1、打开dos窗口，进入demo目录

cd d:/com/demo

2、执行 jar cvf demo.jar * 回车

3、在demo目录下面你会发现demo.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/ .

来个小例子试试看：

我们只有一个HelloWorld，如下：

public class HelloWorld{ 
    public static void main(String[ ] args){ 
        System.out.println(“Hi, Hello World!”); 
    } 
}

将这个java文件存到C盘跟目录下，ok，接下来，

在先前打开的命令提示符下(跳转到C盘提示符下)，我们输入javac HelloWorld.java，然后继续输入：jar cvf hello.jar HelloWorld.class，回车后去你的C盘看看，多了什么，没错 hello.jar 。

基本的步骤我们现在都知道了，你可以自己去尝试一下随着jar后面的参数的不同，结果有什么变化。

紧接着我们看看如何运行我们的jar包。

在进入正题之前，你要先打开我们刚刚做好的jar包看看，多了什么呢，META-INF目录？再看看里面是什么，还有一个MANIFEST.MF文件是不是？用文本编辑器(我这里是UltraEdit)打开它看看：

Manifest-Version: 1.0 
Created-By: 1.4.2 (Sun Microsystems Inc.)

就是这样。这里我们对它进行修改，加一句：Main-Class: HelloWorld (在第三行)。这个就是我们之前写的那个类，也就是我们的入口类。也即，

Manifest-Version: 1.0 
Created-By: 1.4.2 (Sun Microsystems Inc.) 
Main-Class: HelloWorld

接下来，我们在命令提示符里执行：

jar umf MANIFEST.MF app.jar (应该是hello.jar吧)

这样我们使用了我们自己的MANIFEST.MF文件对原来默认的进行了更新。你不妨可以再进去看看是不是添上了Main-Class: HelloWorld这一句。 (是吗，我怎么没试出来，提示java.io.FileNotFoundException:MANIFEST.MF（系统找不到指定的文件）怎么回事？)

Ok，这个最后的一步了，来验证我们做的一切，在命令提示符中输入：

java -jar hello.jar(执行)

出现了什么， Hi, Hello World!

我们再来看看jar文件在tomcat中发布，注意：在tomcat中我们就不能再用jar这种格式，而改war格式，它是专门用于web应用的，其实整个过程下来基本上和jar是类似的：

先准备我们要打包的资源。

找到存放tomcat的webapps目录，进到其中，新建一个文件夹，这里命名为hello，再进去新建WEB-INF文件夹，再进去新建classes文件夹，此时我们也将我们唯一的servlet，HelloWorld.java放到这里，在与classes目录同级下建立一文件web.xml。Ok，目前我们初步建立了一个简单的web应用。

如果运行机上装有中文版WinRaR解压软件，并且将.jar文件与该软件

作了关联，那么双击.jar文件时相当与解压，这样便无法运行java程

序，这时就需要再编写一个.bat文件，内容如下：

javaw -jar Tom.jar

这时只要运行.bat文件就可以了。

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。