javax.enterprise.deploy.model

Interface J2eeApplicationObject

All Superinterfaces:
DeployableObject

public interface J2eeApplicationObject
extends DeployableObject

J2eeApplicationObject is an interface that represents a J2EE application (EAR); it maintains a DeployableObject for each module in the archive.

Method Summary

void
addXpathListener(ModuleType type, String xpath, XpathListener xpl)
Register a listener for changes in XPath that are related to this deployableObject.
DDBean[]
getChildBean(ModuleType type, String xpath)
Return a list of DDBean instances based upon an XPath; all deployment descriptors of the specified type are searched.
DeployableObject
getDeployableObject(String uri)
Return the DeployableObject of the specified URI designator.
DeployableObject[]
getDeployableObjects()
Return the all DeployableObjects in this application.
DeployableObject[]
getDeployableObjects(ModuleType type)
Return the all DeployableObjects of the specified type.
String[]
getModuleUris()
Return the list of URIs for all modules in the application.
String[]
getModuleUris(ModuleType type)
Return the list of URIs of the designated module type.
String[]
getText(ModuleType type, String xpath)
Return the text value from the XPath; search only the deployment descriptors of the specified type.
void
removeXpathListener(ModuleType type, String xpath, XpathListener xpl)
Unregister the listener for an XPath.

Methods inherited from interface javax.enterprise.deploy.model.DeployableObject

entries, getChildBean, getClassFromScope, getDDBeanRoot, getDDBeanRoot, getEntry, getModuleDTDVersion, getText, getType

Method Details

addXpathListener

public void addXpathListener(ModuleType type,
                             String xpath,
                             XpathListener xpl)
Register a listener for changes in XPath that are related to this deployableObject.
Parameters:
type - The type of deployment descriptor to query.
xpath - The xpath to listen for.
xpl - The listener.

getChildBean

public DDBean[] getChildBean(ModuleType type,
                             String xpath)
Return a list of DDBean instances based upon an XPath; all deployment descriptors of the specified type are searched.
Parameters:
type - The type of deployment descriptor to query.
xpath - An XPath string referring to a location in the deployment descriptor
Returns:
The list of DDBeans or null if there are no matches.

getDeployableObject

public DeployableObject getDeployableObject(String uri)
Return the DeployableObject of the specified URI designator.
Parameters:
uri - Describes where to get the module from.
Returns:
the DeployableObject describing the j2ee module at this uri or null if there is not match.

getDeployableObjects

public DeployableObject[] getDeployableObjects()
Return the all DeployableObjects in this application.
Returns:
the DeployableObject instances describing the j2ee modules in this application or null if there are none available.

getDeployableObjects

public DeployableObject[] getDeployableObjects(ModuleType type)
Return the all DeployableObjects of the specified type.
Parameters:
type - The type of module to return.
Returns:
the list of DeployableObjects describing the j2ee modules of this type or null if there are no matches.

getModuleUris

public String[] getModuleUris()
Return the list of URIs for all modules in the application.
Returns:
the Uris of the contained modules or null if the application is completely empty.

getModuleUris

public String[] getModuleUris(ModuleType type)
Return the list of URIs of the designated module type.
Parameters:
type - The type of module to return.
Returns:
the Uris of the contained modules or null if there are no matches.

getText

public String[] getText(ModuleType type,
                        String xpath)
Return the text value from the XPath; search only the deployment descriptors of the specified type.
Parameters:
type - The type of deployment descriptor to query.
xpath - The xpath to query for.
Returns:
The text values of this xpath or null if there are no matches.

removeXpathListener

public void removeXpathListener(ModuleType type,
                                String xpath,
                                XpathListener xpl)
Unregister the listener for an XPath.
Parameters:
type - The type of deployment descriptor to query.
xpath - The xpath to listen for.
xpl - The listener.