多数 java 程序员都非常清楚使用 jar 文件将组成 java 解决方案的各种资源(即 .class 文件、声音和图像)打包的优点。刚开始使用 jar 文件的人常问的一个问题是:“如何从 jar 文件中提取图像呢?”本文将回答这个问题,并会提供一个类,这个类使从 jar 文件中提取任何资源变得非常简单!
加载 gif 图像
假定我们有一个 jar 文件,其中包含我们的应用程序要使用的一组 .gif 图像。下面就是使用 jarresources 访问 jar 文件中的图像文件的方法:
jarresources jr=new jarresources("gifbundle.jar");
image logo=toolkit.getdefaulttoolkit().createimage(jr.getresources("logo.gif"));
这段代码说明我们可以创建一个jarresources对象,并将其初始化为包含我们要使用的资源的 jar 文件 -- images.jar。随后我们使用jarresources的getresource()方法将来自 logo.gif 文件的原始数据提供给 awt toolkit 的createimage()方法。
命名说明
jarresource 是一个非常简单的示例,它说明了如何使用 java 所提供的各种功能来处理 jar 和 zip 档案文件。
工作方式
jarreources类的重要数据域用来跟踪和存储指定 jar 文件的内容:
public final class jarresources {
public boolean debugon=false;
private hashtable htsizes=new hashtable();
private hashtable htjarcontents=new hashtable();
private string jarfilename;
|
这样,该类的实例化设置 jar 文件的名称,然后转到init()方法完成全部实际工作。
public jarresources(string jarfilename) {
this.jarfilename=jarfilename;
init();
}
|
现在,init()方法只将指定 jar 文件的整个内容加载到一个 hashtable(通过资源名访问)中。
这是一个相当有用的方法,下面我们对它作进一步的分析。zipfile类为我们提供了对 jar/zip 档案头信息的基本访问方法。这类似于文件系统中的目录信息。下面我们列出zipfile中的所有条目,并用档案中每个资源的大小添充 htsizes hashtable:
private void init() {
try {
// extracts just sizes only.
zipfile zf=new zipfile(jarfilename);
enumeration e=zf.entries();
while (e.hasmoreelements()) {
zipentry ze=(zipentry)e.nextelement();
if (debugon) {
system.out.println(dumpzipentry(ze));
}
htsizes.put(ze.getname(),new integer((int)ze.getsize()));
}
zf.close();
|
接下来,我们使用zipinputstream类访问档案。zipinputstream类完成了全部魔术,允许我们单独读取档案中的每个资源。我们从档案中读取组成每个资源的精确字节数,并将其存储在 htjarcontents hashtable 中,您可以通过资源名访问这些数据:
// extract resources and put them into the hashtable.
fileinputstream fis=new fileinputstream(jarfilename);
bufferedinputstream bis=new bufferedinputstream(fis);
zipinputstream zis=new zipinputstream(bis);
zipentry ze=null;
while ((ze=zis.getnextentry())!=null) {
if (ze.isdirectory()) {
continue;////啊哟!没有处理子目录中的资源啊
}
if (debugon) {
system.out.println(
"ze.getname()="+ze.getname()+","+"getsize()="+ze.getsize()
);
}
int size=(int)ze.getsize();
// -1 means unknown size.
if (size==-1) {
size=((integer)htsizes.get(ze.getname())).intvalue();
}
byte[] b=new byte[(int)size];
int rb=0;
int chunk=0;
while (((int)size - rb) > 0) {
chunk=zis.read(b,rb,(int)size - rb);
if (chunk==-1) {
break;
}
rb+=chunk;
}
// add to internal resource hashtable
htjarcontents.put(ze.getname(),b);
if (debugon) {
system.out.println(
ze.getname()+" rb="+rb+
",size="+size+
",csize="+ze.getcompressedsize()
);
}
}
} catch (nullpointerexception e) {
system.out.println("done.");
} catch (filenotfoundexception e) {
e.printstacktrace();
} catch (ioexception e) {
e.printstacktrace();
}
}
|
请注意,用来标识每个资源的名称是档案中资源的限定路径名,例如,不是包中的类名 -- 即 java.util.zip 包中的zipentry类将被命名为 "java/util/zip/zipentry",而不是 "java.util.zip.zipentry"。
其它方法:
/**
* dumps a zip entry into a string.
* @param ze a zipentry
*/
private string dumpzipentry(zipentry ze) {
stringbuffer sb=new stringbuffer();
if (ze.isdirectory()) {
sb.append("d ");
} else {
sb.append("f ");
}
if (ze.getmethod()==zipentry.stored) {
sb.append("stored ");
} else {
sb.append("defalted ");
}
sb.append(ze.getname());
sb.append("\t");
sb.append(""+ze.getsize());
if (ze.getmethod()==zipentry.deflated) {
sb.append("/"+ze.getcompressedsize());
}
return (sb.tostring());
}
/**
* extracts a jar resource as a blob.
* @param name a resource name.
*/
public byte[] getresource(string name) {
return (byte[])htjarcontents.get(name);
}
|
代码的最后一个重要部分是简单的测试驱动程序。该测试驱动程序是一个简单的应用程序,它接收 jar/zip 档案名和资源名。它试图发现档案中的资源文件,然后将成功或失败的消息报告出来:
public static void main(string[] args) throws ioexception {
if (args.length!=2) {
system.err.println(
"usage: java jarresources < jar file name> < resource name>"
);
system.exit(1);
}
jarresources jr=new jarresources(args[0]);
byte[] buff=jr.getresource(args[1]);
if (buff==null) {
system.out.println("could not find "+args[1]+".");
} else {
system.out.println("found "+args[1]+ " (length="+buff.length+").");
}
}
} // end of jarresources class.
|
您已了解了这个类。一个易于使用的类,它隐藏了使用打包在 jar 文件中的资源的全部棘手问题。
小结
如果您曾经渴望知道如何从 jar 文件中提取图像,那么您现在已学到了一种方法。有了本技巧提供的这个新类,您就不仅可以用 jar 文件处理图像,而且可以将提取魔术用于 jar 文件中的任何资源。