Package com.pnfsoftware.jeb.util.encoding.zip

Class JarBrowser

java.lang.Object

com.pnfsoftware.jeb.util.encoding.zip.JarBrowser

All Implemented Interfaces:

IGenericJarBrowser, IGenericZipBrowser, AutoCloseable

public class JarBrowser
extends Object
implements IGenericJarBrowser

An implementation of a Jar browser that uses the standard JDK implementation and falls back to the Apache Commons implementation on error.

Constructor Summary

Constructors

Constructor	Description
JarBrowser(File f, boolean verify)	Open a Jar archive, using the JDK implementation first and Apache Commons on fallback.

Method Summary

Modifier and Type	Method	Description
void	close()	Close the archive browser and release its backing resources.
Certificate[]	getCertificates(String name)	Get the certificates associated with a Jar entry.
Map<String,GenericZipEntry<?>>	getEntries()	Get the archive entries indexed by entry name.
GenericZipEntry<?>	getEntry(String name)	Get an archive entry by name.
InputStream	getEntryStream(String name)	Open a stream for an archive entry.
byte[]	readEntry(String name)	Read and decompress an archive entry.

Methods inherited from class java.lang.Object

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

Constructor Details

JarBrowser

public JarBrowser(File f,
 boolean verify)
           throws IOException

Open a Jar archive, using the JDK implementation first and Apache Commons on fallback.

Parameters:

f - Jar file

verify - true to verify signed entries when supported by the backing implementation

Throws:

IOException - if the archive cannot be opened

Method Details

close

public void close()
           throws IOException

Description copied from interface: IGenericZipBrowser

Close the archive browser and release its backing resources.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface IGenericZipBrowser

Throws:

IOException - if closing failed

getEntries

public Map<String,GenericZipEntry<?>> getEntries()

Description copied from interface: IGenericZipBrowser

Get the archive entries indexed by entry name.

Specified by:

getEntries in interface IGenericZipBrowser

Returns:

entry map

getEntry

public GenericZipEntry<?> getEntry(String name)

Description copied from interface: IGenericZipBrowser

Get an archive entry by name.

Specified by:

getEntry in interface IGenericZipBrowser

Parameters:

name - entry name

Returns:

entry descriptor, or null

readEntry

public byte[] readEntry(String name)
                 throws IOException

Description copied from interface: IGenericZipBrowser

Read and decompress an archive entry.

Specified by:

readEntry in interface IGenericZipBrowser

Parameters:

name - entry name

Returns:

decompressed entry bytes

Throws:

IOException - if the entry cannot be read

getEntryStream

public InputStream getEntryStream(String name)
                           throws IOException

Description copied from interface: IGenericZipBrowser

Open a stream for an archive entry.

Specified by:

getEntryStream in interface IGenericZipBrowser

Parameters:

name - entry name

Returns:

stream yielding decompressed entry bytes

Throws:

IOException - if the entry cannot be opened

getCertificates

public Certificate[] getCertificates(String name)

Description copied from interface: IGenericJarBrowser

Get the certificates associated with a Jar entry.

Specified by:

getCertificates in interface IGenericJarBrowser

Parameters:

name - entry name

Returns:

certificate chain, or null if unavailable