java 如何從jar包中讀取資源文件

在代碼中讀取一些資源文件(比如圖片，音樂，文本等等)，在集成環境(Eclipse)中運行的時候沒有問題。但當打包成一個可執行的jar包（將資源文件一併打包）以後，這些資源文件找不到，如下代碼：
Java代碼  

//源代碼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代碼,來看看上面那段費解的話是什麼意思了：
Java代碼  

//源代碼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類的測試代碼：
Java代碼  

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的癥結所在了。
 注： 我們可以通過 new ImageIcon(類.class.getResource("XX.gif"))獲得ImageIcon對象，但如果你要獲得jar文件中的資源文件流，上面方法行不通。
          (3) 我們不能用常規操作文件的方法來讀取ResourceJar.jar中的資源文件res.txt，但可以通過Class類的getResourceAsStream()方法來獲取 ，這種方法是如何讀取jar中的資源文件的，這一點對於我們來說是透明的。我們將Resource.java改寫成：
Java代碼  

//源代碼3：
package edu.hxraid;
import java.io.*;
public class Resource {
    public void getResource() throws IOException{
        //返回讀取指定資源的輸入流
        InputStream is=this.getClass().getResourceAsStream("/resource/res.txt");
       //InputStream is=當前類.class.getResourceAsStream("XX.config");
        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文件了。

 (4) 上面方法只提供了從jar中讀資源文件功能，沒有提供改寫jar中資源文件方法，

    通過URL、URLConnection來得到jar中資源文件的輸入流（InputStream）和輸出流 (OutputStream)，不僅可以從jar中讀取資源文件而且還可以改寫jar中資源文件

URL url = 類.class.getResource("XX.config");
URLConnection  urlConnection=url.openConnection();
//讀資源文件
InputStream inputStream=urlConnection.getInputStream();
BufferedReader in=new BufferedReader(new InputStreamReader(inputStream,"utf-8"));
//寫資源文件
OutputStream outputStream=urlConnection.getOutputStream();
PrintStream printStream=new PrintStream(outputStream);

補充：剛測試了一下，利用URL、URLConnection來得到jar中資源文件的輸出流 (OutputStream)不好使，提示java.net.UnknownServiceException: protocol doesn't support output，由於上述改寫jar中資源文件方法不好使。

      我們可以換個角度，不要死扣非得讀寫jar中的資源文件，只有當軟件第一次啓動程序時纔讀jar中的資源文件，並將其備份到用戶主目錄或用戶當前目錄中，以後讀寫用戶目錄中的資源文件即可。首先我們把資源文件打包到jar中，程序第一次程序啓動時，仍然從jar中讀資源文件信息（顯然可以實現），並將所讀取的信息保存到內存中（如：每次啓動程序時，都將資源文件信息讀到List或Map集合中保存），程序運行期間對資源文件的更新都是對List和Map的更新，當第一次關閉程序時，纔將內存中保存的資源信息寫到System.getProperty("user.home")用戶主目錄（或System.getProperty("user.dir")用戶當前目錄）中，並生成一個與jar中資源文件一模一樣的文件，以後程序啓動時都從用戶目錄的資源文件中讀寫。只有當用戶目錄中的資源文件不存在時（這裏程序可以判斷一下），才從jar中的資源文件讀信息，因此jar中的資源文件只是起到原始備份作用。

       當然，這樣做會有2個問題(1)：就是每次程序安裝在一新機器上時，讀取的資源文件信息都是jar中的原始資源信息，中途我們可能更新過，解決方法：將更新的資源文件再一次打包到jar中(2):由於每次對資源文件信息的更新都是對對應的內存數據的更新，只有在關閉程序時才寫回到資源文件中，沒有隨改隨寫，這樣就可能造成這樣一種後果，如果程序不是很健壯，程序中途bug並無響應，此時只能強制關閉，務必造成更新的資源信息沒有寫回到資源文件中！！！解決方案：每次對內存中資源信息的更新後馬上寫回到文件中，利：保證了程序bug後資源文件仍然是最新的，弊：這樣會造成頻繁寫文件操作，程序性能降低，(也不一定哦，試具體程序來看，由於它是資源文件，一般不會更新很頻繁)。

（5）利用java.util.jar.JarFile?????沒試過

從一個jar文件讀取內容，然後寫回一個jar文件。

首先通過一個JarFile file = new JarFile(fileName);

然後file.entries()可以得到一個jar文件內部元素的迭代器。同過這個迭代器我們可以獲得所有的JarEntry,

然後通過InputStream is = jarFile.getInputStream(jarEntry);可以獲得這個JarEntry的輸入流。

最後將is的內容同過JarOutputStream out = new JarOutputStream(new FileOutputStream(distJar));的out的out.write(int data)方法寫入目標jar文件。