从java jar文件包中读资源的常用方法

  在你的代码里调用了一些资源文件，如图片，音乐等，在调试环境或单独运行的时候可以正常显示或播放，而一旦打包到jar文件中，这些东东就再也出不来了，除非把这个jar放到原来未打包以前的目录下，但通常jar是单独发布的。
[关键字] java jar文件包 资源

　　可能有不少初学者会有这样的困惑：在你的代码里调用了一些资源文件，如图片，音乐等，在调试环境或单独运行的时候可以正常显示或播放，而一旦打包到jar文件中，这些东东就再也出不来了，除非把这个jar放到原来未打包以前的目录下，但通常jar是单独发布的。这里介绍一个解决这类问题的方法。

　　getResource和getResourceAsStream

　　问题的根源还是在于老生常谈的所谓classpath，不信的话你在系统环境变量里的ClassPath加上你的jar文件，这下你就看得到你的图片了！但单独发布jar的话不可能指望每次都让用户为你的jar而专门修改classpath。那么有没有什么办法一劳永逸地搞定它呢？我们需要从类的装载入手。先扯远一点，在开发JSP之类的Web应用程序的时候要用到第三方的库怎么办？通常的做法是把这些库（可以是class，也可以是jar）统统放到WEB-INF/lib/目录下面，为什么这样系统就认了呢？因为Web容器（譬如Tomcat）在装载类的时候有自己的组织方式（可以参考Tomcat手册http://jakarta.apache.org/tomcat/tomcat-4.1-doc/class-loader-howto.html）。特别地，jar也是类装载器的一个可访问媒介，ClassLoader提供了两个方法用于从装载的类路径中取得资源：

　　public URL getResource(String name);

　　public InputStream getResourceAsStream(String name);

　　这里name是资源的类路径，它是相对与“/”根路径下的位置。getResource得到的是一个URL对象来定位资源，而getResourceAsStream取得该资源输入流的引用保证程序可以从正确的位置抽取数据。

　　真正使用的不是ClassLoader的这两个方法，而是Class的getResource和getResourceAsStream方法，因为Class对象可以从你的类得到（如YourClass.class或YourClass.getClass()），而ClassLoader则需要再调用一次YourClass.getClassLoader()方法，但根据JDK文档的说法，Class对象的这两个方法其实是“委托”（delegate）给装载它的ClassLoader来做的，所以只需要使用Class对象的这两个方法就可以了。

　　在参考资料中有一篇老外写的文章比较深入介绍了从jar中装载资源的方法。

　　一个应用的例子

　　以下是在我写的一个小工具MSNHistoryCombiner中用到的一段代码，可以从jar中装载图片和文本信息。譬如，你的jar中根目录下有个img目录，里面放有一些图片，如img1.jpg，你可以这样调用

　　Utilities.getImageFromJar("/img/img1.jpg", YourClass.class);

　　注意必须这里是“/img/img1.jpg”而非“img/img1.jpg”。从jar中读文本资源也是类似方法调用getTextFromJar。

　　需要说明的是，这段代码也不是我原创的，是从一段别的代码中经过修改得到的，但原代码的来源忘记了，在这里向原作者表示感谢和歉意。

　　import java.awt.Image;

　　import java.awt.Toolkit;

　　import java.io.*;

　　public class ResourseReader {

　　public ResourseReader() {

　　}

　　public static Image getImageFromJar(String s, Class class1) {

　　Image image = null;

　　InputStream inputstream = class1.getResourceAsStream(s);

　　if(inputstream != null) {

　　ByteArrayOutputStream bytearrayoutputstream = new ByteArrayOutputStream();

　　try {

　　byte abyte0[] = new byte[1024];

　　for(int i = 0; (i = inputstream.read(abyte0)) >= 0;) {

　　bytearrayoutputstream.write(abyte0, 0, i);

　　}

　　image = Toolkit.getDefaultToolkit().createImage(bytearrayoutputstream.toByteArray());

　　}

　　catch(IOException ioexception) {

　　ioexception.printStackTrace();

　　}

　　}

　　return image;

　　}

　　public static String getTextFromJar(String s, Class class1) {

　　String s1 = "";

　　InputStream inputstream = class1.getResourceAsStream(s);

　　if(inputstream != null) {

　　BufferedReader bufferedreader = new BufferedReader(new InputStreamReader(inputstream));

　　String s2;

　　try {

　　while((s2 = bufferedreader.readLine()) != null) {

　　s1 = s1 + s2 + "/n";

　　}

　　}

　　catch(IOException ioexception) {

　　ioexception.printStackTrace();

　　}

　　}

　　return s1;

　　}

　　}

　　从Jar中读取gif文件

　　在Java的程序发布中，很多人会选择采用二进制的jar的格式进行发布，怎么样读取Jar里面的资源呢？

　　主要是采用ClassLoader的下面几个方法来实现：

　　public URL getResource(String name)；

　　public InputStream getResourceAsStream(String name)

　　public static InputStream getSystemResourceAsStream(String name)

　　public static URL getSystemResource(String name)

　　后两个方法可以看出是静态的方法，这几个方法都可以从Jar中读取图片资源，但是对与动画的gif文件，笔者在尝试过程中发现，存在一些差异。

　　String gifName为Gif文件在Jar中的相对路径。

　　(1)使用了两个静态方法

　　BufferedImage image=ImageIO.read（ClassLoader.getSystemResourceAsStream(gifName));

　　或者

　　Image image=Toolkit.getDefaultToolkit().getImage(ClassLoader.getSystemResource(gifName));

　　这两种方式可以成功地读取gif文件，但是对于gif动画，显示出来地是静态的。

　　(2)使用其他两个方法

　　Image image=Toolkit.getDefaultToolkit().getImage(this.getClass.getClassLoader().getResource(gifName));

　　再这种方式下动画可以正常显示了。