JAVA從jar包中讀取資源文件

我們常常在代碼中讀取一些資源文件(比如圖片，音樂，文本等等)。在單獨運行的時候這些簡單的處理當然不會有問題。但是，如果我們把代碼打成一個jar包以後，即使將資源文件一併打包，這些東西也找不出來了。看看下面的代碼：

1. import java.io.*;   
   
2. public class Resource {   
   
3.     public  void getResource() throws IOException{   
   
4.         File file=new File("bin/resource/res.txt");   
   
5.         BufferedReader br=new BufferedReader(new FileReader(file));   
   
6.         String s="";   
   
7.         while((s=br.readLine())!=null)   
   
8.             System.out.println(s);   
   
9.     }   
   
10. }   

複製代碼

1. import java.io.*;
   
2. public class Resource {
   
3.         public  void getResource() throws IOException{
   
4.                 File file=new File("bin/resource/res.txt");
   
5.                 BufferedReader br=new BufferedReader(new FileReader(file));
   
6.                 String s="";
   
7.                 while((s=br.readLine())!=null)
   
8.                         System.out.println(s);
   
9.         }
   
10. }

複製代碼

這段代碼寫在Eclipse建立的java Project中，其目錄爲：(其中將資源文件res.txt放在了bin目錄下，以便打成jar包)3 Z3 }& ^+ |  w  v
      1、src/
              src/edu/hxraid/Resource.java- z% c2 m8 k+ [/ `
      2、bin/
              bin/resource/res.txt
              bin/edu/hxraid/Resource.class 
: u1 a& s1 |' ^+ Z( D( ]
      很顯然運行源代碼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文件(讀者也許對這段原因解釋有些費解，在下面我們會用一段代碼運行的結果來進一步闡述)。 1 P3 O( G& n$ N
1 B4 L' P4 k; z, n* V4 S& I
- _, \, b, F: U! b- W  }! m+ a9 C
0 U4 }( V1 L. i- ]2 n& g: T
          那麼把資源打入jar包，無論ResourceJar.jar在系統的什麼路徑下，jar包中的字節碼程序都可以找到該包中的資源。這會是幻想嗎？ - J2 w% P' Y/ U3 G- _
* |4 E* M) B8 h0 [( ~" e


" f! q- k  T7 A- `+ ?" M
      當然不是，我們可以用類裝載器(ClassLoader)來做到這一點： 1 ~. V4 d; {: ]0 C  L; L

         (1) ClassLoader 是類加載器的抽象類。它可以在運行時動態的獲取加載類的運行信息。 可以這樣說，當我們調用ResourceJar.jar中的Resource類時，JVM加載進Resource類，並記錄下Resource運行時信息(包括Resource所在jar包的路徑信息)。而ClassLoader類中的方法可以幫助我們動態的獲取這些信息:+ H' R, z  S& C5 e3 }- S
          ● public URL getResource(String name) 
            查找具有給定名稱的資源。資源是可以通過類代碼以與代碼基無關的方式訪問的一些數據(圖像、聲音、文本等)。並返回資源的URL對象。" |( y, y: z. L' s: G5 h# M+ A+ n
          ● public InputStream getResourceAsStream(String name); 
             返回讀取指定資源的輸入流。這個方法很重要，可以直接獲得jar包中文件的內容。 / J% _+ ^4 z4 U  {
' K/ x0 q& l2 n0 T
          ' y6 i1 ?$ f  x1 }# }
1 s8 ^* ?) C3 H" r2 p
          (2) ClassLoader是abstract的，不可能實例化對象，更加不可能通過ClassLoader調用上面兩個方法。所以我們真正寫代碼的時候，是通過Class類中的getResource()和getResourceAsStream()方法，這兩個方法會委託ClassLoader中的getResource()和getResourceAsStream()方法 。好了，現在我們重新寫一段Resource代碼,來看看上面那段費解的話是什麼意思了：

1. import java.io.*;   
   
2. import java.net.URL;   
   
3. public class Resource {   
   
4.     public  void getResource() throws IOException{     
   
5.               //查找指定資源的URL，其中res.txt仍然開始的bin目錄下    
   
6.         URL fileURL=this.getClass().getResource("/resource/res.txt");    
   
7.         System.out.println(fileURL.getFile());   
   
8.     }   
   
9.     public static void main(String[] args) throws IOException {   
   
10.         Resource res=new Resource();   
    
11.         res.getResource();   
    
12.     }   
    
13. }  

複製代碼

1. import java.io.*;
   
2. import java.net.URL;
   
3. public class Resource {
   
4.         public  void getResource() throws IOException{        
   
5.               //查找指定資源的URL，其中res.txt仍然開始的bin目錄下 
   
6.                 URL fileURL=this.getClass().getResource("/resource/res.txt");
   
7.                 System.out.println(fileURL.getFile());
   
8.         }
   
9.         public static void main(String[] args) throws IOException {
   
10.                 Resource res=new Resource();
    
11.                 res.getResource();
    
12.         }
    
13. }

複製代碼

運行這段源代碼結果：/E:/Code_Factory/WANWAN/bin/resource/res.txt  (../ Code_Factory/WANWAN/.. 是java project所在的路徑) - h5 N( r6 e* m. ?2 `  c
  Q. ]  b4 x  d- e' S; _: g. G
           我們將這段代碼打包成ResourceJar.jar ,並將ResourceJar.jar放在其他路徑下(比如 c:\ResourceJar.jar)。然後另外創建一個java project並導入ResourceJar.jar，寫一段調用jar包中Resource類的測試代碼：

1. import java.io.IOException;   
   
2. public class TEST {   
   
3.     public static void main(String[] args) throws IOException {   
   
4.         Resource res=new Resource();   
   
5.         res.getResource();   
   
6.     }   
   
7. }  

複製代碼

1. import java.io.IOException;
   
2. public class TEST {
   
3.         public static void main(String[] args) throws IOException {
   
4.                 Resource res=new Resource();
   
5.                 res.getResource();
   
6.         }
   
7. }  

複製代碼

這時的運行結果是：file:/C:/ResourceJar.jar!/resource/res.txt % c7 t/ ~/ Q6 O+ J, l% m" S



           我們成功的在運行時動態獲得了res.txt的位置。然而，問題來了，你是否可以通過下面這樣的代碼來得到res.txt文件？
                      File f=new File("C:/ResourceJar.jar!/resource/res.txt");( Z) G# p9 f; C4 r8 ]3 z
            當然不可能，因爲".../ResourceJar.jar!/resource/...."並不是文件資源定位符的格式 (jar中資源有其專門的URL形式： jar:<url>!/{entry} )。所以，如果jar包中的類源代碼用File f=new File(相對路徑);的形式，是不可能定位到文件資源的。這也是爲什麼源代碼1打包成jar文件後，調用jar包時會報出FileNotFoundException的癥結所在了。 7 K: u6 ?3 h% o. h: s6 u


6 s/ {1 M$ n1 u: d1 ^: I% s
          (3) 我們不能用常規操作文件的方法來讀取ResourceJar.jar中的資源文件res.txt，但可以通過Class類的getResourceAsStream()方法來獲取 ，這種方法是如何讀取jar中的資源文件的，這一點對於我們來說是透明的。我們將Resource.java改寫成：

1. import java.io.*;   
   
2. public class Resource {   
   
3.     public void getResource() throws IOException{   
   
4.         //返回讀取指定資源的輸入流   
   
5.         InputStream is=this.getClass().getResourceAsStream("/resource/res.txt");    
   
6.         BufferedReader br=new BufferedReader(new InputStreamReader(is));   
   
7.         String s="";   
   
8.         while((s=br.readLine())!=null)   
   
9.             System.out.println(s);   
   
10.     }   
    
11. }

複製代碼

1. import java.io.*;
   
2. public class Resource {
   
3.         public void getResource() throws IOException{
   
4.                 //返回讀取指定資源的輸入流
   
5.                 InputStream is=this.getClass().getResourceAsStream("/resource/res.txt"); 
   
6.                 BufferedReader br=new BufferedReader(new InputStreamReader(is));
   
7.                 String s="";
   
8.                 while((s=br.readLine())!=null)
   
9.                         System.out.println(s);
   
10.         }
    
11. }  

複製代碼

我們將java工程下/bin目錄中的edu/hxraid/Resource.class和資源文件resource/res.txt一併打包進ResourceJar.jar中，不管jar包在系統的任何目錄下，調用jar包中的Resource類都可以獲得jar包中的res.txt資源，再也不會找不到res.txt文件了。