从Java档案(JAR)中读取文件

未分类 , , , , , 发表评论

Java 档案 (Java Archive, JAR) 文件是基于 Java 技术的打包方案。它们允许开发人员把所有相关的内容 (.class、图片、声音和支持文件等) 打包到一个单一的文件中。JAR 文件格式支持压缩、身份验证和版本,以及许多其它特性。

从 JAR 文件中得到它所包含的文件内容是件棘手的事情,但也不是不可以做到。这篇技巧就将告诉你如何从 JAR 文件中取得一个文件。我们会先取得这个 JAR 文件中的文件目录,然后读取指定的文件。

如果你熟悉常见的 ZIP 格式,你会发现 JAR 文件和它区别不大。JAR 文件提供了一个把多个文件打包到一个文件中的方法,而且被打包的每个文件都可以分别压缩。JAR 文件可以添加一个被称为 manifest 的东西,它们允许开发人员添加与内容有关的其它信息。例如,manifest 可以指明由 JAR 文件中的哪一个文件开始运行应用程序,或者指定这个库的版本等。

Java 2 SDK 标准版提供了一个 jar 工具,你可以通过它在控制台下读写 JAR 文件。然后,也许有些时候你想在你的程序中读写 JAR 文件。(这篇技巧仅涉及了在程序中读 JAR 文件的内容。)非常高兴,你可以做到,并且不需要考虑解压的问题,因为类库已经帮你处理了。你要用到的类都在 java.util.jar 包中。这里要用到的主要的类是 JarFile 类,它是一个 .jar 文件自身的引用。其中的每个文件则由 JarEntry 引用。

现在开始,传递一个参数给 JarFile 的构造函数创建一个 JarFile 实例,这个参数可能是 String 也可以是 File,它是一个 .jar 文件的位置:

JarFile jarFile = new JarFile(“thefile.jar”);

或者

File file = new File(“thefile.jar”);

JarFile jarFile = new JarFile(file);

它还有其它一些构造函数,支持身份验证和标记文件为删除。不过这里不会涉及到这些构造函数。

在你得到一个 JAR 文件的引用之后,你就可以读了其内容的目录了。JarFile 的 entries 方法返回一个所有条目的 Enumeration 对象,你还可以从 manifest 文件中获得它的属性、身份验证信息以及其它的信息,如条目的名称和大小。

Enumeration enum = jarFile.entries();

while (enum.hasMoreElements()) {

process(enum.nextElement());

}

以前提到过,每个个体都是一个 JarEntry。这个类有一些诸如 getName、getSize 和getCompressedSize 的方法。

记我们举例说明如何在程序中使用这些特性。下面的程序显示 JAR 文件的内容列表及各项的名称、大小和压缩后的大小。(这很类似于使用带 “t” 和 “v” 参数的 jar 命令。)

import java.io.*;

import java.util.*;

import java.util.jar.*;

public class JarDir {

public static void main (String args[])

throws IOException {

if (args.length != 1) {

System.out.println(“Please provide a JAR filename”);

System.exit(-1);

}

JarFile jarFile = new JarFile(args[0]);

Enumeration enum = jarFile.entries();

while (enum.hasMoreElements()) {

process(enum.nextElement());

}

}

private static void process(Object obj) {

JarEntry entry = (JarEntry)obj;

String name = entry.getName();

long size = entry.getSize();

long compressedSize = entry.getCompressedSize();

System.out.println(name + ” ” + size + ” ” + compressedSize);

}

}

如果你用 J2SE 1.4.1 中的 jce.jar 来试验上述的 JarDir 程序,你应该看像下面那样的输出 (在 … 处应该显示更多文件):

META-INF/MANIFEST.MF 5315 1910

META-INF/4JCEJARS.SF 5368 1958

META-INF/4JCEJARS.DSA 2207 1503

META-INF/ 0 2

javax/ 0 0

javax/crypto/ 0 0

javax/crypto/interfaces/ 0 0

javax/crypto/interfaces/DHKey.class 209 185

javax/crypto/interfaces/DHPublicKey.class 265 215

javax/crypto/interfaces/DHPrivateKey.class 267 215

javax/crypto/interfaces/PBEKey.class 268 224

javax/crypto/SecretKey.class 167 155

注意输入内容顶部包含 META-INF 的那几行,这是 menifest 和安全验证信息。其中大小为 0 的条目不是文件,而是目录。

要真正从 JAR 文件中读取文件内容,你必须获得相应条目的 InputStream。这不同于 JarEntry。JarEntry 仅包括了入口信息,却并未包含实际的内容。这很像 File 和 FileInputSteram 的区别。只访问 File,永远不会打开相应的文件,它只读取在目录中的信息。下面告诉你如何从一个条目得到 InputStream:

InputStream input = jarFile.getInputStream(entry);

得到输入流之后,你只需要像读其它流一样读它就行了。如果是一个文本流,要记得使用一个 Reader 来从流中获取字符。而对于字节流,如图片,则只好直接读取。

下面的程序演示了从一个 JAR 文件中读取内容。运行程序时,需要指定要从 JAR 文件中读取的文件名,这个文件必须是文本文件类型。

import java.io.*;

import java.util.jar.*;

public class JarRead {

public static void main (String args[])

throws IOException {

if (args.length != 2) {

System.out.println(“Please provide a JAR filename and file to read”);

System.exit(-1);

}

JarFile jarFile = new JarFile(args[0]);

JarEntry entry = jarFile.getJarEntry(args[1]);

InputStream input = jarFile.getInputStream(entry);

process(input);

jarFile.close();

}

private static void process(InputStream input)

throws IOException {

InputStreamReader isr =

new InputStreamReader(input);

BufferedReader reader = new BufferedReader(isr);

String line;

while ((line = reader.readLine()) != null) {

System.out.println(line);

}

reader.close();

}

}

假设你有一个名为 myfiles.jar 的 JAR 文件,其中有一个名为 spider.txt 文本文件,再假设那个 pider.txt 包含如下文本:

The itsy bitsy spider

Ran up the water spout

Down came the rain and

Washed the spider out

运行下面的命令以显示 JAR 文件中该文本文件的内容:

java JarRead myfiles.jar spider.txt

关于 JAR 文件更多的内容,请参阅 JAR file specification。

原文:http://developer.java.sun.com/developer/JDCTechTips/2003/tt0122.html#1

发表评论

电子邮件地址不会被公开。 必填项已用*标注

昵称 *