[Java基础] 深刻jar包：从jar包中读取资源文件

转载： http://hxraid.iteye.com/blog/483115?page=3#comments

   咱们经常在代码中读取一些资源文件(好比图片，音乐，文本等等)。在单独运行的时候这些简单的处理固然不会有问题。可是，若是咱们把代码打成一个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包)
      一、src/
              src/edu/hxraid/Resource.java
      二、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文件了。