org.codehaus.cargo.module

Class DefaultJarArchive

java.lang.Object

org.codehaus.cargo.module.DefaultJarArchive

All Implemented Interfaces:

JarArchive

Direct Known Subclasses:

DefaultEarArchive, DefaultEjbArchive, DefaultWarArchive

public class DefaultJarArchive
extends Object
implements JarArchive

Provide convenient methods to read information from a Jar archive.

Version:

$Id: DefaultJarArchive.java 1158 2006-07-29 10:55:48Z vmassol $

Constructor Summary

Constructors

Constructor and Description
DefaultJarArchive(InputStream inputStream) Constructor.
DefaultJarArchive(String file) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsClass(String className) Returns whether a class of the specified name is contained in the archive.
void	expandToPath(String path) Expand the archive to the specified directory.
String	findResource(String name) Returns the full path of a named resource in the archive.
protected JarInputStream	getContentAsStream() Returns the content of the archive as JarInputStream.
FileHandler	getFileHandler()
InputStream	getResource(String path) Returns a resource from the archive as input stream.
List	getResources(String path) Returns the list of resources in the specified directory in the archive.
void	setFileHandler(FileHandler fileHandler)
protected byte[]	streamToByteArray(InputStream inputStream) Read a stream into a byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultJarArchive

public DefaultJarArchive(String file)

Constructor.

Parameters:

file - The archive file

DefaultJarArchive

public DefaultJarArchive(InputStream inputStream)
                  throws IOException

Constructor.

Parameters:

inputStream - The input stream for the archive (it will be closed after the constructor returns)

Throws:

IOException - If there was a problem reading the WAR

Method Detail

getFileHandler

public FileHandler getFileHandler()

Returns:

the file utility class to use for performing all file I/O.

setFileHandler

public void setFileHandler(FileHandler fileHandler)

Parameters:

fileHandler - the file utility class to use for performing all file I/O.

containsClass

public boolean containsClass(String className)
                      throws IOException

Returns whether a class of the specified name is contained in the archive.

Specified by:

containsClass in interface JarArchive

Parameters:

className - The name of the class to search for

Returns:

Whether the class was found

Throws:

IOException - If an I/O error occurred reading the archive

See Also:

JarArchive.containsClass(String)

findResource

public final String findResource(String name)
                          throws IOException

Returns the full path of a named resource in the archive.

Specified by:

findResource in interface JarArchive

Parameters:

name - The name of the resource

Returns:

The full path to the resource inside the archive

Throws:

IOException - If an I/O error occurred reading the archive

See Also:

JarArchive.findResource(String)

getResource

public final InputStream getResource(String path)
                              throws IOException

Returns a resource from the archive as input stream.

Specified by:

getResource in interface JarArchive

Parameters:

path - The path to the resource in the archive

Returns:

An input stream containing the specified resource, or null if the resource was not found in the JAR

Throws:

IOException - If an I/O error occurs

See Also:

JarArchive.getResource(String)

getResources

public final List getResources(String path)
                        throws IOException

Returns the list of resources in the specified directory in the archive.

Specified by:

getResources in interface JarArchive

Parameters:

path - The directory

Returns:

The list of resources

Throws:

IOException - If an I/O error occurs

See Also:

JarArchive.getResources(String)

getContentAsStream

protected final JarInputStream getContentAsStream()
                                           throws IOException

Returns the content of the archive as JarInputStream.

Returns:

The input stream

Throws:

IOException - If an exception occurred reading the archive

expandToPath

public void expandToPath(String path)
                  throws IOException

Expand the archive to the specified directory.

Specified by:

expandToPath in interface JarArchive

Parameters:

path - The path to expand to

Throws:

IOException - If an I/O error occurs

See Also:

JarArchive.expandToPath(String)

streamToByteArray

protected byte[] streamToByteArray(InputStream inputStream)
                            throws IOException

Read a stream into a byte array.

Parameters:

inputStream - the input stream

Returns:

the byte array

Throws:

IOException - if an IO Exception