Java 技巧 49:如何从 JAR 和 zip 档案文件中提取 Java 资源
您是刚开始接触 JAR 文件吗?这个新类可帮您解决问题!作者:John D. Mitchell 和 Arthur Choi摘要
将一类 Java 资源打包在一个 Java ARchive (JAR) 文件中是缩短下载时间、增强安全性和增强可管理性的极好方法。这篇技巧说明如何很容易地从 JAR 文件中提取资源以供您自己使用。 
多数 Java 程序员都非常清楚使用 JAR 文件将组成 Java 解决方案的各种资源(即 .class 文件、声音和图像)打包的优点。(如果您不熟悉 JAR 文件,请参阅后文的参考资源部分。)刚开始使用 JAR 文件的人常问的一个问题是:“如何从 JAR 文件中提取图像呢?”本文将回答这个问题,并会提供一个类,这个类使从 JAR 文件中提取任何资源变得非常简单! 
加载 GIF 图像
假定我们有一个 JAR 文件,其中包含我们的应用程序要使用的一组 .gif 图像。下面就是使用 JarResources 访问 JAR 文件中的图像文件的方法:     JarResources jar = new JarResources ("Images.jar");
    Image logo =
 Toolkit.getDefaultToolkit().createImage (jar.getResource ("logo.gif");
这段代码说明我们可以创建一个 JarResources 对象,并将其初始化为包含我们要使用的资源的 JAR 文件 -- Images.jar。随后我们使用 JarResources 的 getResource() 方法将来自 logo.gif 文件的原始数据提供给 AWT Toolkit 的 createImage() 方法。 命名说明
JarResource 是一个非常简单的示例,它说明了如何使用 Java 1.1 所提供的各种功能来处理 JAR 和 zip 档案文件。 关于命名的简要说明。Java 中的归档支持实际上是以流行的 zip 归档格式为起点的(请参阅 "Java Tip 21: Use archive files to speed up applet loading")。因此,在最初实现处理档案文件的 Java 支持时,所有类文件以及诸如此类的东西并未放在 java.util.zip 包中;这些类通常以 "Zip" 开头。但在转向 Java 1.1 时,功能已发生了变化,档案文件的名称也更具有 Java 特征。因此,现在我们称之为 JAR 文件的文件基本上是 zip 文件。 工作方式
JarResources 类的重要数据域用来跟踪和存储指定 JAR 文件的内容: public final class JarResources {   public boolean debugOn=false;   private Hashtable htSizes=new Hashtable(); 
   private Hashtable htJarContents=new Hashtable();   private String jarFileName;
这样,该类的实例化设置 JAR 文件的名称,然后转到 init() 方法完成全部实际工作。    public JarResources(String jarFileName) {
      this.jarFileName=jarFileName;
      init();
   }
现在,init() 方法只将指定 JAR 文件的整个内容加载到一个 hashtable(通过资源名访问)中。 这是一个相当有用的方法,下面我们对它作进一步的分析。ZipFile 类为我们提供了对 JAR/zip 档案头信息的基本访问方法。这类似于文件系统中的目录信息。下面我们列出 ZipFile 中的所有条目,并用档案中每个资源的大小添充 htSizes hashtable:    private void init() {
      try {
          ZipFile zf=new ZipFile(jarFileName);
          Enumeration e=zf.entries();
          while (e.hasMoreElements()) {
              ZipEntry ze=(ZipEntry)e.nextElement();
              if (debugOn) {
                 System.out.println(dumpZipEntry(ze));
              }
              htSizes.put(ze.getName(),new Integer((int)ze.getSize()));
          }
          zf.close();
接下来,我们使用 ZipInputStream 类访问档案。ZipInputStream 类完成了全部魔术,允许我们单独读取档案中的每个资源。我们从档案中读取组成每个资源的精确字节数,并将其存储在 htJarContents hashtable 中,您可以通过资源名访问这些数据:           FileInputStream fis=new FileInputStream(jarFileName);
          BufferedInputStream bis=new BufferedInputStream(fis);
          ZipInputStream zis=new ZipInputStream(bis);
          ZipEntry ze=null;
          while ((ze=zis.getNextEntry())!=null) {
             if (ze.isDirectory()) {
                continue;
             }
             if (debugOn) {
                System.out.println(
                   "ze.getName()="+ze.getName()+","+"getSize()="+ze.getSize()
                   );
             }
             int size=(int)ze.getSize();
             // -1 表示大小未知。
             if (size==-1) {
                size=((Integer)htSizes.get(ze.getName())).intValue();
             }
             byte[] b=new byte[(int)size];
             int rb=0;
             int chunk=0;
             while (((int)size - rb) > 0) {
                 chunk=zis.read(b,rb,(int)size - rb);
                 if (chunk==-1) {
                    break;
                 }
                 rb+=chunk;
             }
             // 添加到内部资源 hashtable 中
             htJarContents.put(ze.getName(),b);
             if (debugOn) {
                System.out.println(
                   ze.getName()+" rb="+rb+
                   ",size="+size+
                   ",csize="+ze.getCompressedSize()
                   );
             }
          }
       } catch (NullPointerException e) {
          System.out.println("done.");
       } catch (FileNotFoundException e) {
          e.printStackTrace();
       } catch (IOException e) {
          e.printStackTrace();
       }
   }
请注意,用来标识每个资源的名称是档案中资源的限定路径名,例如,不是包中的类名 -- 即 java.util.zip 包中的 ZipEntry 类将被命名为 "java/util/zip/ZipEntry",而不是 "java.util.zip.ZipEntry"。 代码的最后一个重要部分是简单的测试驱动程序。该测试驱动程序是一个简单的应用程序,它接收 JAR/zip 档案名和资源名。它试图发现档案中的资源文件,然后将成功或失败的消息报告出来:    public static void main(String[] args) throws IOException {
       if (args.length!=2) {
          System.err.println(
             "usage: java JarResources "
             );
          System.exit(1);
       }
       JarResources jr=new JarResources(args[0]);
       byte[] buff=jr.getResource(args[1]);
       if (buff==null) {
          System.out.println("Could not find "+args[1]+".");
       } else {
          System.out.println("Found "+args[1]+ " (length="+buff.length+").");
       }
   }} // JarResources 类结束。
您已了解了这个类。一个易于使用的类,它隐藏了使用打包在 JAR 文件中的资源的全部棘手问题。 练习
现在您对从档案文件中提取资源已有了一定的认识,下面是可用来修改和扩展 JarResources 类的一些说明: 
不在构造期间一次性加载全部内容,而要延迟加载。对于大型 JAR 文件,构造期间可能没有足够的内存加载全部文件。 不只是提供类似 getResource() 这样的一般读方法,我们还可提供资源特定的读方法 -- 例如,用来返回 Java Image 对象的 getImage() 方法,用来返回 Java Class 对象的 getClass() 方法(在自定义的类加载程序的协助下),等等。如果 JAR 文件足够小,则我们可以根据它们的扩展名(.gif、.class 等等)预先构建全部资源。 某些方法应该提供关于给定 JAR 文件本身(基本上是 ZipFile 的包装)的信息,包括:Jar/zip 的条目数;返回全部资源名的 Enumerator;返回特定条目长度(和其他属性)的读方法;允许编制索引的读方法,这仅仅是举几个例子。 可对 JarResources 进行扩展,以供 applet 使用。通过利用 applet 参数和 URLConnection 类,就可以从网络上下载 JAR 内容,而不是将档案作为本地文件打开。此外,我们还可将该类扩展为一个自定义的 Java 内容处理程序。 
小结
如果您曾经渴望知道如何从 JAR 文件中提取图像,那么您现在已学到了一种方法。有了本技巧提供的这个新类,您就不仅可以用 JAR 文件处理图像,而且可以将提取魔术用于 JAR 文件中的任何资源。 作者简介 
Arthur Choi 目前是 IBM 的一位顾问程序员。他曾先后在几个公司任职,包括 SamSung Network Laboratory 和 MITRE。他参与过的项目包括客户机/服务器系统、分布式对象计算和网络管理。他在各种操作系统环境下用过多种语言。他于 1981 年开始用 FORTRAN IV 和 COBOL 进行编程。后来他转向 C 和 C++,最近两年他一直在用 Java 工作。他最感兴趣的 Java 应用是广域网中的数据仓库和因特网上的并行处理和分布式处理(使用基于代理的编程)。Reach Arthur 的电子邮件地址为 [email protected]。 
John Mitchell,先后做过雇员、咨询人员,现在是自己公司的老板,过去十年他所投资的领域包括前沿计算机软件的开发、对其他开发人员提供建议和培训。他的咨询范围包括 Java 技术、编译器、解释器、基于 Web 应用和因特网商务等。John 是 Making Sense of Java: A Guide for Managers and the Rest of Us 一书的作者之一,并在编程杂志上发表了许多文章。除了为 JavaWorld 撰写 Java Tips 专栏之外,他还主持着 comp.lang.tcl.announce 和 comp.binaries.geos 新闻组。Reach John 的电子邮件地址为 [email protected]。 
 
参考资源 这是类文件 JarResources.java 
JarResources.java 
JARs 
http://www.javasoft.com/products/jdk/1.1/docs/guide/jar/index.html 
有关 Java 的归档支持的详细信息,请参阅 "Java Tip 21: Use archive files to speed up applet loading" 
http://www.javaworld.com/javatips/jw-javatip21.html