javax.enterprise.deploy.model
Interface DeployableObject

All Known Subinterfaces:

J2eeApplicationObject

public interface DeployableObject

The DeployableObject interface is an abstract representation of a J2EE deployable module (JAR, WAR, RAR, EAR). A DeployableObject provides access to the module's deployment descriptor and class files.

Version:

$Rev: 467553 $ $Date: 2006-10-25 06:01:51 +0200 (Wed, 25 Oct 2006) $

Method Summary

java.util.Enumeration	entries() Returns an enumeration of the module file entries.
DDBean[]	getChildBean(java.lang.String xpath) Return an array of standard beans representing the XML content returned based upon the XPath.
java.lang.Class	getClassFromScope(java.lang.String className) Retrieve the specified class from this deployable module.
DDBeanRoot	getDDBeanRoot() Return the top level standard bean representing the root of the deployment descriptor.
DDBeanRoot	getDDBeanRoot(java.lang.String filename) Returns a DDBeanRoot object for the XML instance document named.
java.io.InputStream	getEntry(java.lang.String name) Returns the InputStream for the given entry name.
java.lang.String	getModuleDTDVersion() Deprecated. As of version 1.1, replace by DDBeanRoot.getDDBeanRootVersion()
java.lang.String[]	getText(java.lang.String xpath)
ModuleType	getType() Return the ModuleType of deployment descriptor (i.e., EAR, JAR, WAR, RAR) this deployable object represents.

Method Detail

getType

ModuleType getType()

Return the ModuleType of deployment descriptor (i.e., EAR, JAR, WAR, RAR) this deployable object represents. Values are found in DeploymentManager.

Returns:

The ModuleType of deployable object

getDDBeanRoot

DDBeanRoot getDDBeanRoot()

Return the top level standard bean representing the root of the deployment descriptor.

Returns:

A standard bean representing the deployment descriptor.

getChildBean

DDBean[] getChildBean(java.lang.String xpath)

Return an array of standard beans representing the XML content returned based upon the XPath.

Parameters:

xpath - AAn XPath string identifying the data to be extracted from the deployment descriptor.

Returns:

an array of DDBeans or null if no matching data is found.

getText

java.lang.String[] getText(java.lang.String xpath)

Parameters:

xpath - An xpath string referring to a location in the deployment descriptor

Returns:

a list XML content or null if no matching data is found.

getClassFromScope

java.lang.Class getClassFromScope(java.lang.String className)

Retrieve the specified class from this deployable module.

One use: to get all finder methods from an EJB. If the tool is attempting to package a module and retrieve a class from the package, the class request may fail. The class may not yet be available. The tool should respect the manifest Class-Path entries.

Parameters:

className - Class to retrieve.

Returns:

Class representation of the class

getModuleDTDVersion

java.lang.String getModuleDTDVersion()

Deprecated. As of version 1.1, replace by DDBeanRoot.getDDBeanRootVersion()

A convenience method to return the deployment descriptor document version number of the primary deployment descriptor for the module (e.g. web.xml, ejb-jar.xml, ra.xml, application.xml, and application-client.xml.) The version number for documents webservices.xml , webservicesclient.xml and the like are not returned by this method. DDBeanRoot.getDDBeanRootVersion should be used instead. This method is being deprecated. DDBeanRoot.getDDBeanRootVersion should be used instead.

Returns:

a string that is the version number of the XML instance document. Null is returned if no version number can be found.

getDDBeanRoot

DDBeanRoot getDDBeanRoot(java.lang.String filename)
                         throws java.io.FileNotFoundException,
                                DDBeanCreateException

Returns a DDBeanRoot object for the XML instance document named. This method should be used to return DDBeanRoot objects for non deployment descriptor XML instance documents such as WSDL files.

Parameters:

filename - the full path name from the root of the module of the xml instance document for which a DDBeanRoot object is to be returned.

Returns:

a DDBeanRoot object for the XML data.

Throws:

java.io.FileNotFoundException - if the named file can not be found

DDBeanCreateException - if an error is encountered creating the DDBeanRoot object.

Since:

1.1

entries

java.util.Enumeration entries()

Returns an enumeration of the module file entries. All elements in the enumeration are of type String. Each String represents a file name relative to the root of the module.

Returns:

an enumeration of the archive file entries.

Since:

1.1

getEntry

java.io.InputStream getEntry(java.lang.String name)

Returns the InputStream for the given entry name. The file name must be relative to the root of the module.

Parameters:

name - the file name relative to the root of the module.

Returns:

the InputStream for the given entry name or null if not found.

Since:

1.1