---
title: "jar文件包中读资源的常用方法"
author: "winzenghua"
date: "2006-09-21T14:12:00Z"
tags: []
slug: "jar"
draft: false
lastmod: "2006-09-21T14:12:00Z"
id: 987997
url: "https://java4gis.iteye.com/blog/987997"
---

可能有不少初学者会有这样的困惑（以前我也有过）：在你的代码里调用了一些资源文件，如图片，音乐等，在调试环境或单独运行的时候可以正常显示或播放，而 一旦打包到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)) &gt;= 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));

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