com.sun.enterprise.deployment
Class RootDeploymentDescriptor

java.lang.Object
  java.util.Observable
      com.sun.enterprise.deployment.DynamicAttributesDescriptor
          com.sun.enterprise.deployment.Descriptor
              com.sun.enterprise.deployment.RootDeploymentDescriptor

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

BundleDescriptor, PersistenceUnitsDescriptor, WebServicesDescriptor

public abstract class RootDeploymentDescriptor
extends Descriptor

This descriptor contains all common information amongst root element of the J2EE Deployment Descriptors (application, ejb-jar, web-app, connector...).

Author:

Jerome Dochez

See Also:

Serialized Form

Field Summary

protected java.lang.ClassLoader	classLoader class loader associated to this module to load classes contained in the archive file
protected java.util.Map<java.lang.Class<? extends RootDeploymentDescriptor>,java.util.List<RootDeploymentDescriptor>>	extensions Extensions for this module descriptor, keyed by type, indexed using the instance's index
protected ModuleDescriptor	moduleDescriptor contains the information for this module (like it's module name)
protected java.lang.String	moduleID each module is uniquely identified with a moduleID

Fields inherited from class com.sun.enterprise.deployment.Descriptor

DESCRIPTION_CHANGED, DESCRIPTOR_CHANGED, docType, LARGE_ICON_CHANGED, NAME_CHANGED, SMALL_ICON_CHANGED

Constructor Summary

RootDeploymentDescriptor()
Construct a new RootDeploymentDescriptor

RootDeploymentDescriptor(java.lang.String name, java.lang.String description)
Construct a new RootDeploymentDescriptor with a name and description

Method Summary

<T extends RootDeploymentDescriptor> void	addExtensionDescriptor(java.lang.Class<? extends RootDeploymentDescriptor> type, T instance, java.lang.String index)
abstract java.lang.ClassLoader	getClassLoader()
abstract java.lang.String	getDefaultSpecVersion()
java.lang.String	getDisplayName()
java.util.Collection<RootDeploymentDescriptor>	getExtensionsDescriptors() This method returns all the extensions deployment descriptors in the scope
<T extends RootDeploymentDescriptor> T	getExtensionsDescriptors(java.lang.Class<? extends RootDeploymentDescriptor> type, java.lang.String index) This method returns one extension of the passed type in the scope with the right index
<T extends RootDeploymentDescriptor> java.util.Collection<T>	getExtensionsDescriptors(java.lang.Class<T> type) This method returns all extensions of the passed type in the scope
RootDeploymentDescriptor	getMainDescriptor()
ModuleDescriptor	getModuleDescriptor()
abstract java.lang.String	getModuleID()
abstract XModuleType	getModuleType()
java.lang.String	getName() as of J2EE1.4, get/setName are deprecated, people should use the set/getDisplayName or the set/getModuleID.
java.lang.String	getSchemaLocation()
java.lang.String	getSpecVersion()
abstract boolean	isApplication()
boolean	isDDWithNoAnnotationAllowed()
abstract boolean	isEmpty() Return true if this root deployment descriptor does not describe anything
boolean	isExtensionDescriptor()
boolean	isFullAttribute() Get the full attribute of the deployment descriptor
boolean	isFullFlag()
void	print(java.lang.StringBuffer toStringBuffer) print a meaningful string for this object
void	setClassLoader(java.lang.ClassLoader classLoader) Sets the class loader for this application
void	setDisplayName(java.lang.String name) sets the display name for this bundle
void	setFullAttribute(java.lang.String value) Sets the full attribute of the deployment descriptor
void	setFullFlag(boolean flag) Sets the full flag of the bundle descriptor.
void	setModuleDescriptor(ModuleDescriptor descriptor) Sets the module descriptor for this bundle
void	setModuleID(java.lang.String moduleID) each module is uniquely identified with a moduleID
void	setName(java.lang.String name) as of J2EE1.4, get/setName are deprecated, people should use the set/getDisplayName or the set/getModuleID.
void	setSchemaLocation(java.lang.String schemaLocation)
void	setSpecVersion(java.lang.String specVersion) Sets the specification version of the deployment descriptor

Methods inherited from class com.sun.enterprise.deployment.Descriptor

addDeploymentExtension, addPrefixMapping, createUniqueFilenameAmongst, createUniqueNameAmongst, createUniqueNameAmongstNamedDescriptors, fillDocType, getDeploymentExtensions, getDescription, getDocType, getLargeIconUri, getLocalizedDescription, getLocalizedDescriptions, getLocalizedDisplayName, getLocalizedDisplayNames, getLocalizedLargeIconUri, getLocalizedLargeIconUris, getLocalizedSmallIconUri, getLocalizedSmallIconUris, getPrefixMapping, getSmallIconUri, isBoundsChecking, setBoundsChecking, setDescription, setLargeIconUri, setLocalizedDescription, setLocalizedDisplayName, setLocalizedLargeIconUri, setLocalizedSmallIconUri, setSmallIconUri, visit

Methods inherited from class com.sun.enterprise.deployment.DynamicAttributesDescriptor

addExtraAttribute, getExtraAttribute, getExtraAttributes, removeExtraAttribute, toString

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Field Detail

moduleID

protected java.lang.String moduleID

each module is uniquely identified with a moduleID

classLoader

protected transient java.lang.ClassLoader classLoader

class loader associated to this module to load classes contained in the archive file

extensions

protected java.util.Map<java.lang.Class<? extends RootDeploymentDescriptor>,java.util.List<RootDeploymentDescriptor>> extensions

Extensions for this module descriptor, keyed by type, indexed using the instance's index

moduleDescriptor

protected ModuleDescriptor moduleDescriptor

contains the information for this module (like it's module name)

Constructor Detail

RootDeploymentDescriptor

public RootDeploymentDescriptor()

Construct a new RootDeploymentDescriptor

RootDeploymentDescriptor

public RootDeploymentDescriptor(java.lang.String name,
                                java.lang.String description)

Construct a new RootDeploymentDescriptor with a name and description

Method Detail

setModuleID

public void setModuleID(java.lang.String moduleID)

each module is uniquely identified with a moduleID

Parameters:

moduleID - for this module

getModuleID

public abstract java.lang.String getModuleID()

Returns:

the module ID for this module descriptor

getDefaultSpecVersion

public abstract java.lang.String getDefaultSpecVersion()

Returns:

the default version of the deployment descriptor loaded by this descriptor

isEmpty

public abstract boolean isEmpty()

Return true if this root deployment descriptor does not describe anything

Returns:

true if this root descriptor is empty

getSpecVersion

public java.lang.String getSpecVersion()

Returns:

the specification version of the deployment descriptor loaded by this descriptor

setSpecVersion

public void setSpecVersion(java.lang.String specVersion)

Sets the specification version of the deployment descriptor

Parameters:

specVersion - version number

getModuleType

public abstract XModuleType getModuleType()

Returns:

the module type for this bundle descriptor

setClassLoader

public void setClassLoader(java.lang.ClassLoader classLoader)

Sets the class loader for this application

getClassLoader

public abstract java.lang.ClassLoader getClassLoader()

Returns:

the class loader associated with this module

setDisplayName

public void setDisplayName(java.lang.String name)

sets the display name for this bundle

Overrides:

setDisplayName in class Descriptor

Parameters:

name - the display name

getDisplayName

public java.lang.String getDisplayName()

Overrides:

getDisplayName in class Descriptor

Returns:

the display name

setName

public void setName(java.lang.String name)

as of J2EE1.4, get/setName are deprecated, people should use the set/getDisplayName or the set/getModuleID.

Overrides:

setName in class Descriptor

Parameters:

name - the new name of the descriptor.

getName

public java.lang.String getName()

as of J2EE1.4, get/setName are deprecated, people should use the set/getDisplayName or the set/getModuleID. note : backward compatibility

Overrides:

getName in class Descriptor

Returns:

the name of this descriptor

setSchemaLocation

public void setSchemaLocation(java.lang.String schemaLocation)

getSchemaLocation

public java.lang.String getSchemaLocation()

getModuleDescriptor

public ModuleDescriptor getModuleDescriptor()

Returns:

the module descriptor for this bundle

setModuleDescriptor

public void setModuleDescriptor(ModuleDescriptor descriptor)

Sets the module descriptor for this bundle

Parameters:

descriptor - for the module

isApplication

public abstract boolean isApplication()

Returns:

true if this module is an application object

print

public void print(java.lang.StringBuffer toStringBuffer)

print a meaningful string for this object

Overrides:

print in class Descriptor

getExtensionsDescriptors

public java.util.Collection<RootDeploymentDescriptor> getExtensionsDescriptors()

This method returns all the extensions deployment descriptors in the scope

Returns:

an unmodifiable collection of extensions or empty collection if none.

getExtensionsDescriptors

public <T extends RootDeploymentDescriptor> java.util.Collection<T> getExtensionsDescriptors(java.lang.Class<T> type)

This method returns all extensions of the passed type in the scope

Parameters:

type - requested extension type

Returns:

an unmodifiable collection of extensions or empty collection if none.

getExtensionsDescriptors

public <T extends RootDeploymentDescriptor> T getExtensionsDescriptors(java.lang.Class<? extends RootDeploymentDescriptor> type,
                                                                       java.lang.String index)

This method returns one extension of the passed type in the scope with the right index

Parameters:

type - requested extension type

index - is the instance index

Returns:

an unmodifiable collection of extensions or empty collection if none.

addExtensionDescriptor

public <T extends RootDeploymentDescriptor> void addExtensionDescriptor(java.lang.Class<? extends RootDeploymentDescriptor> type,
                                                                        T instance,
                                                                        java.lang.String index)

isExtensionDescriptor

public boolean isExtensionDescriptor()

Returns:

whether this descriptor is an extension descriptor of a main descriptor, e.g. the EjbBundleDescriptor for ejb in war case should return true.

getMainDescriptor

public RootDeploymentDescriptor getMainDescriptor()

Returns:

the main descriptor associated with it if it's an extension descriptor, otherwise return itself

setFullFlag

public void setFullFlag(boolean flag)

Sets the full flag of the bundle descriptor. Once set, the annotations of the classes contained in the archive described by this bundle descriptor will be ignored.

Parameters:

flag - a boolean to set or unset the flag

setFullAttribute

public void setFullAttribute(java.lang.String value)

Sets the full attribute of the deployment descriptor

Parameters:

value - the full attribute

isFullAttribute

public boolean isFullAttribute()

Get the full attribute of the deployment descriptor

Returns:

the full attribute

isFullFlag

public boolean isFullFlag()

isDDWithNoAnnotationAllowed

public boolean isDDWithNoAnnotationAllowed()