从jar包中读取资源文件(转)

本文介绍如何在Java项目中正确地从Jar包加载资源文件,如图片、音乐和文本等,并探讨了使用ClassLoader方法来实现这一目标的具体实践。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

转自: http://www.iteye.com/topic/483115

我们常常在代码中读取一些资源文件 ( 比如图片,音乐,文本等等 ) 。在单独运行的时候这些简单的处理当然不会有问题。但是,如果我们把代码打成一个 jar 包以后,即使将资源文件一并打包,这些东西也找不出来了。看看下面的代码:

// 源代码 1

package edu.hxraid;

import java.io.*;

public class Resource {

        public  void getResource() throws IOException{

               File file=new File("bin/resource/res.txt");

               BufferedReader br=new BufferedReader(new FileReader(file));

               String s="";

               while((s=br.readLine())!=null)

                       System.out.println(s);

        }

}      

这段代码写在 Eclipse 建立的 Java Project 中,其目录为: ( 其中将资源文件 res.txt 放在了 bin 目录下,以便打成 jar )
      1 src/
              src/edu/hxraid/Resource.java
      2 bin/
              bin/resource/res.txt
              bin/edu/hxraid/Resource.class

      很显然运行源代码 1 是能够找到资源文件 res.txt 。但当我们把整个工程打成 jar 包以后 (ResourceJar.jar) ,这个 jar 包内的目录为:
              edu/hxraid/Resource.class
              resource/res.txt

          而这时 jar 包中 Resource.class 字节 码: ldc <String "bin/resource/res.txt"> [20] 将无法定位到 jar 包中的 res.txt 位置上。就算把 bin/ 目录去掉: ldc <String "resource/res.txt"> [20] 仍然无法定位到 jar 包中 res.txt 上。

      这主要是因为 jar 包是一个单独的文件而非文件夹,绝对不可能通过 "file:/e:/.../ ResourceJar.jar /resource /res.txt" 这种形式的文件 URL 来定位 res.txt 。所以即使是相对路径,也无法定位到 jar 文件内的 txt 文件 ( 读者也许对这段原因解释有些费解,在下面我们会用一段代码运行的结果来进一步阐述 )

         那么把资源打入 jar 包,无论 ResourceJar.jar 在系统的什么路径下, jar 包中的字节码程序都可以找到该包中的资源。这会是幻想吗?  

      当然不是,我们可以用类装载器 (ClassLoader) 来做到这一点:

       (1) ClassLoader 是类加载器的抽象类。它可以在运行时动态的获取加载类的运行信息。 可以这样说,当我们调用 ResourceJar.jar 中的 Resource 类时, JVM 加载进 Resource 类,并记录下 Resource 运行时信息 ( 包括 Resource 所在 jar 包的路径信息 ) 。而 ClassLoader 类中的方法可以帮助我们动态的获取这些信息 :
          ● public URL getResource(String name)
            查找具有给定名称的资源。资源是可以通过类代码以与代码基无关的方式访问的一些数据 ( 图像、声音、文本等 ) 。并返回资源的 URL 对象。
          ● public InputStream getResourceAsStream(String name);
             返回读取指定资源的输入流。这个方法很重要,可以直接获得 jar 包中文件的内容。          

          (2) ClassLoader abstract 的,不可能实例化对象,更加不可能通过 ClassLoader 调用上面两个方法。所以我们真正写代码的时候,是通过 Class 类中的 getResource() getResourceAsStream() 方法,这两个方法会委托 ClassLoader 中的 getResource() getResourceAsStream() 方法 。好了,现在我们重新写一段 Resource 代码 , 来看看上面那段费解的话是什么意思了:

// 源代码 2

package edu.hxraid;

import java.io.*;

import java.net.URL;

public class Resource {

        public  void getResource() throws IOException{       

              // 查找指定资源的 URL ,其中 res.txt 仍然开始的 bin 目录下

               URL fileURL=this.getClass().getResource("/resource/res.txt");

               System.out.println(fileURL.getFile());

        }

        public static void main(String[] args) throws IOException {

               Resource res=new Resource();

               res.getResource();

        }

}

运行这段源代码结果: /E:/Code_Factory/WANWAN/bin/resource/res.txt  (../ Code_Factory/WANWAN/.. java project 所在的路径 )

           我们将这段代码打包成 ResourceJar.jar , 并将 ResourceJar.jar 放在其他路径下 ( 比如 c:\ResourceJar.jar) 。然后另外创建一个 java project 并导入 ResourceJar.jar ,写一段调用 jar 包中 Resource 类的测试代码:

import java.io.IOException;

import edu.hxraid.Resource;

public class TEST {

        public static void main(String[] args) throws IOException {

               Resource res=new Resource();

               res.getResource();

        }

}

      这时的运行结果是: file:/C:/ResourceJar.jar!/resource/res.txt

    我们成功的在运行时动态获得了 res.txt 的位置。然而,问题来了,你是否可以通过下面这样的代码来得到 res.txt 文件?
                      File f=new File("C:/ResourceJar.jar!/resource/res.txt");
      当然不可能,因为 ".../ResourceJar.jar!/resource/...." 并不是文件资源定位符的格式 (jar 中资源有其专门的 URL 形式: jar:<url>!/{entry} ) 。所以,如果 jar 包中的类源代码用 File f=new File( 相对路径 ); 的形式,是不可能定位到文件资源的。这也是为什么源代码 1 打包成 jar 文件后,调用 jar 包时会报出 FileNotFoundException 的症结所在了。

       (3) 我们不能用常规操作文件的方法来读取 ResourceJar.jar 中的资源文件 res.txt 但可以通过 Class 类的 getResourceAsStream() 方法来获取 ,这种方法是如何读取 jar 中的资源文件的,这一点对于我们来说是透明的。我们将 Resource.java 改写成:

// 源代码 3

package edu.hxraid;

import java.io.*;

public class Resource {

        public void getResource() throws IOException{

               // 返回读取指定资源的输入流

               InputStream is=this.getClass().getResourceAsStream("/resource/res.txt");

               BufferedReader br=new BufferedReader(new InputStreamReader(is));

               String s="";

               while((s=br.readLine())!=null)

                       System.out.println(s);

        }

}

     我们将 java 工程下 /bin 目录中的 edu/hxraid/Resource.class 和资源文件 resource/res.txt 一并打包进 ResourceJar.jar 中,不管 jar 包在系统的任何目录下,调用 jar 包中的 Resource 类都可以获得 jar 包中的 res.txt 资源,再 也不会找不到 res.txt 文件了。

今天写了个程序突然发现源代码可以读,但打入 jar 包后就不行了。最后花了我 2 个多小时才搞明白为什么: 原来我的资源文件名是 BigramDict.dct
但是我在源代码里面写成了: /ICTCLAS_DICT/b igramDict.dct ( 首字母小写了 )

本来这是个小问题,但是源代码
  InputStream is=this.getClass().getResourceAsStream("/ICTCLAS_DICT/bigramDict.dct");
运行的时候是可以找到 BigramDict.dct 的。一旦把 BigramDict.dct 打入 jar 包,就找不到了。

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值