【IT168 技术文档】可能有不少初学者会有这样的困惑:在你的代码里调用了一些资源文件,如图片,音乐等,在调试环境或单独运行的时候可以正常显示或播放,而一旦打包到jar文件中,这些东东就再也出不来了,除非把这个jar放到原来未打包以前的目录下,但通常jar是单独发布的。这里介绍一个解决这类问题的方法。
getResource和getResourceAsStream
问题的根源还是在于老生常谈的所谓class path,不信的话你在系统环境变量里的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));
再这种方式下动画可以正常显示了。