org.apache.cactus.integration.ant.deployment
Interface JarArchive

All Known Subinterfaces:
EarArchive, WarArchive
All Known Implementing Classes:
DefaultEarArchive, DefaultJarArchive, DefaultWarArchive

public interface JarArchive

Provide convenient methods to read information from a Jar archive.

Since:
Cactus 1.5
Version:
$Id: JarArchive.java,v 1.5.2.1 2003/10/25 17:22:05 vmassol Exp $
Author:
Vincent Massol

Method Summary
 boolean containsClass(java.lang.String theClassName)
          Returns whether a class of the specified name is contained in the archive.
 java.lang.String findResource(java.lang.String theName)
          Returns the full path of a named resource in the archive.
 java.io.InputStream getResource(java.lang.String thePath)
          Returns a resource from the archive as input stream.
 java.util.List getResources(java.lang.String thePath)
          Returns the list of resources in the specified directory.
 

Method Detail

containsClass

public boolean containsClass(java.lang.String theClassName)
                      throws java.io.IOException
Returns whether a class of the specified name is contained in the archive.

Parameters:
theClassName - The name of the class to search for
Returns:
Whether the class was found
Throws:
java.io.IOException - If an I/O error occurred reading the archive

findResource

public java.lang.String findResource(java.lang.String theName)
                              throws java.io.IOException
Returns the full path of a named resource in the archive.

Parameters:
theName - The name of the resource
Returns:
The full path to the resource inside the archive
Throws:
java.io.IOException - If an I/O error occurred reading the archive

getResource

public java.io.InputStream getResource(java.lang.String thePath)
                                throws java.io.IOException
Returns a resource from the archive as input stream.

Parameters:
thePath - 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:
java.io.IOException - If an I/O error occurs

getResources

public java.util.List getResources(java.lang.String thePath)
                            throws java.io.IOException
Returns the list of resources in the specified directory.

Parameters:
thePath - The directory
Returns:
The list of resources
Throws:
java.io.IOException - If an I/O error occurs


Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.