nl.knowledgeplaza.util
Class JarResources

java.lang.Object
  nl.knowledgeplaza.util.JarResources

public class JarResources
extends Object

Access all resources included in a Zip or Jar file. Per default the complete file is NOT kept in memory, but each resource is extracted separately. For better performance, the whole resource may be read into memory (cacheAll). If an InputStream is used, only one resource can be read (because InputStreams cannot be reversed), or all entries must be kept in memory (cacheAll).

Field Summary

static String

SOURCECODE_VERSION Standard variable for determining version of a class file.

Constructor Summary

JarResources(File file)

JarResources(File file, boolean cacheAll)

JarResources(InputStream is, boolean cacheAll)
creates a JarResources.

JarResources(String jarFileName)

JarResources(String jarFileName, boolean cacheAll)

Method Summary

boolean	getCacheAll() CacheAll
byte[]	getResource(String name) Extracts a jar resource
byte[]	getResource2(String name) Extracts a jar resource, IOException just returns null
InputStream	getResourceAsStream(String name) Extracts a jar resource as a blob.
InputStream	getResourceAsStream2(String name) Extracts a jar resource, IOException just returns null
String[]	getResourceNames() Extracts a jar resource
void	setCacheAll(boolean value)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SOURCECODE_VERSION

public static final String SOURCECODE_VERSION

Standard variable for determining version of a class file.

See Also:

Constant Field Values

Constructor Detail

JarResources

public JarResources(String jarFileName)
             throws FileNotFoundException

Parameters:

jarFileName - a jar or zip filename

Throws:

FileNotFoundException

JarResources

public JarResources(String jarFileName,
                    boolean cacheAll)
             throws FileNotFoundException

Parameters:

jarFileName - a jar or zip filename

cacheAll - read whole file into memory (uncompressed!)

Throws:

FileNotFoundException

JarResources

public JarResources(File file)
             throws FileNotFoundException

Parameters:

file - a jar or zip file

Throws:

FileNotFoundException

JarResources

public JarResources(File file,
                    boolean cacheAll)
             throws FileNotFoundException

Parameters:

file - a jar or zip file

cacheAll - read whole file into memory (uncompressed!)

Throws:

FileNotFoundException

JarResources

public JarResources(InputStream is,
                    boolean cacheAll)

creates a JarResources.

Parameters:

is - an jar or zip inputstream

cacheAll - read all in memory (this is required to be able to access multiple resources)

Method Detail

getCacheAll

public boolean getCacheAll()

CacheAll

setCacheAll

public void setCacheAll(boolean value)

getResourceNames

public String[] getResourceNames()
                          throws IOException

Extracts a jar resource

Parameters:

name - a resource name.

Throws:

IOException

getResource

public byte[] getResource(String name)
                   throws IOException

Extracts a jar resource

Parameters:

name - a resource name.

Throws:

IOException

getResource2

public byte[] getResource2(String name)

Extracts a jar resource, IOException just returns null

Parameters:

name - a resource name.

getResourceAsStream

public InputStream getResourceAsStream(String name)
                                throws IOException

Extracts a jar resource as a blob.

Parameters:

name - a resource name.

Throws:

IOException

getResourceAsStream2

public InputStream getResourceAsStream2(String name)

Extracts a jar resource, IOException just returns null

Parameters:

name - a resource name.