com.sun.enterprise.deployment.node
Class DeploymentDescriptorNode<T>

java.lang.Object
  com.sun.enterprise.deployment.node.DeploymentDescriptorNode<T>

All Implemented Interfaces:

XMLNode<T>

Direct Known Subclasses:

AbsoluteOrderingNode, ActivationConfigNode, ActivationConfigNode, ActivationSpecNode, AdminObjectNode, AroundInvokeNode, AuthConstraintNode, AuthMechNode, BeanCacheNode, BeanPoolNode, CheckpointAtEndOfMethodNode, CmpFieldNode, CmpNode, ConcurrentMethodNode, ConfigPropertyNode, ConfigurableNode, ConnectionDefNode, ContainerTransactionNode, CookieConfigNode, DataSourceDefinitionNode, DataSourcePropertyNode, DefaultResourcePrincipalNode, DeploymentExtensionNode, DisplayableComponentNode, EjbApplicationExceptionNode, EjbInitNode, EjbInterceptorNode, EjbNode, EjbReferenceNode, EjbRefNode, EjbRelationNode, EjbRelationshipRoleNode, EjbRemoveNode, EntityManagerFactoryReferenceNode, EntityManagerReferenceNode, EnvEntryNode, ErrorPageNode, ExcludeListNode, ExtensionElementNode, FilterMappingNode, FinderNode, FlushAtEndOfMethodNode, GroupNode, InBoundRANode, InitParamNode, InjectionTargetNode, InterceptorBindingNode, IORConfigurationNode, JavaWebStartAccessNode, JspConfigNode, JspGroupNode, LicenseNode, LifecycleCallbackNode, LocaleEncodingMappingListNode, LocaleEncodingMappingNode, LocalizedNode, LoginConfigNode, MailConfigurationNode, MDBConnectionFactoryNode, MDBResourceAdapterNode, MessageDestinationRefNode, MessageDestinationRefNode, MessageDestinationRuntimeNode, MessageListenerNode, MessageNode, MessageSecurityBindingNode, MessageSecurityNode, MethodNode, MethodPermissionNode, MimeMappingNode, ModuleNode, MultipartConfigNode, NameValuePairNode, OrderingNode, OrderingOrderingNode, OutBoundRANode, PersistenceUnitNode, PrefetchDisabledNode, PrincipalNode, PropertiesNode, ProtectionNode, QueryNode, RANode, RelationshipsNode, ReliabilityConfigNode, RequiredConfigNode, ResourceEnvRefNode, ResourceEnvRefNode, ResourceRefNode, ResourceRefNode, RunAsNode, RuntimeBundleNode, RuntimeDescriptorNode, ScheduledTimerNode, SecurityConstraintNode, SecurityIdentityNode, SecurityPermissionNode, SecurityRoleNode, SecurityRoleRefNode, ServiceRefNode, ServiceRefPortInfoRuntimeNode, ServletMappingNode, ServletNode, SessionConfigNode, TagLibNode, TimeoutValueNode, UserDataConstraintNode, WebCacheNode, WebResourceCollectionNode, WebServiceEndpointRuntimeNode, WebServiceRuntimeNode, WLModuleNode, WLServiceRefNode, WLServiceRefPortInfoRuntimeNode, WLUnSupportedNode, WLWebServiceEndpointNode, WLWebServiceEndpointNode.ServiceEndpointAddressNode, WLWebServiceEndpointNode.WSDLNode

public abstract class DeploymentDescriptorNode<T>
extends java.lang.Object
implements XMLNode<T>

Superclass of all Nodes implementation XMLNode implementation represents all the DOL classes responsible for handling the XML deployment descriptors. These nodes are called by the SAX parser when reading and are constructed to build the DOM tree for saving the XML files. XMLNode are orgnalized like a tree with one root XMLNode (which implement the RootXMLNode interface) and sub XMLNodes responsible for handling subparts of the XML documents. Sub XMLNodes register themselfves to their parent XMLNode as handlers for a particular XML subtag of the tag handled by the parent XMLNode Each XMLNode is therefore associated with a xml tag (located anywhere in the tree of tags as defined by the DTD). It owns the responsibility for reading and writing the tag, its attributes and all subtags (by using delegation to sub XMLNode if necessary).

Version:

Author:

Jerome Dochez

Field Summary

protected java.lang.Object	abstractDescriptor
protected java.util.Hashtable	handlers
protected static LocalStringManagerImpl	localStrings
protected XMLNode	parentNode

Constructor Summary

DeploymentDescriptorNode()
Creates new DeploymentDescriptorNode

Method Summary

void	addDescriptor(java.lang.Object descriptor) Adds a new DOL descriptor instance to the descriptor instance associated with this XMLNode
protected void	addNamespaceDeclaration(org.w3c.dom.Element node, Descriptor descriptor) Any node can now declare its own namespace.
protected void	addNodeDescriptor(DeploymentDescriptorNode node) Adds a new DOL descriptor instance to the descriptor associated with this XMLNode
void	addPrefixMapping(java.lang.String prefix, java.lang.String uri) notify of a new prefix mapping used in this document
static org.w3c.dom.Element	appendChild(org.w3c.dom.Node parent, java.lang.String elementName) Append a new element child to the current node
void	appendQNameChild(java.lang.String elementName, org.w3c.dom.Node parent, java.lang.String namespaceUri, java.lang.String localPart, java.lang.String prefix)
static org.w3c.dom.Node	appendTextChild(org.w3c.dom.Node parent, java.lang.String elementName, int value) Append a new text child
static org.w3c.dom.Node	appendTextChild(org.w3c.dom.Node parent, java.lang.String elementName, java.lang.String text) Append a new text child
java.lang.String	composeQNameValue(java.lang.String prefix, java.lang.String localPart)
boolean	endElement(XMLElement element) receives notification of the end of an XML element by the Parser
static org.w3c.dom.Node	forceAppendTextChild(org.w3c.dom.Node parent, java.lang.String elementName, java.lang.String text) Append a new text child even if text is empty
T	getDescriptor()
protected java.util.Map	getDispatchTable() all sub-implementation of this class can use a dispatch table to map xml element to method name on the descriptor class for setting the element value.
XMLNode	getHandlerFor(XMLElement element) Return the XMLNode implementation respionsible for handling the sub-element of the current node
java.lang.String	getLocalPartFromQName(java.lang.String qname) Return local part from qname, where qname is an xsd:QName.
protected static org.w3c.dom.Document	getOwnerDocument(org.w3c.dom.Node node)
XMLNode	getParentNode()
java.lang.String	getPrefixFromQName(java.lang.String qname)
java.lang.String	getXMLPath()
protected XMLElement	getXMLRootTag()
boolean	handlesElement(XMLElement element) Return true if the XMLNode is responisble for handling the XML element
void	postParsing() notification of the end of XML parsing for this node
protected void	registerElementHandler(XMLElement element, java.lang.Class handler) register a new XMLNode handler for a particular XML tag.
protected void	registerElementHandler(XMLElement element, java.lang.Class handler, java.lang.String addMethodName) register a new XMLNode handler for a particular XML tag.
java.lang.String	resolvePrefix(XMLElement element, java.lang.String prefix) Resolve a QName prefix to its corresponding Namespace URI by searching up node chain starting with child.
static void	setAttribute(org.w3c.dom.Element parent, java.lang.String elementName, java.lang.String text) Append a new attribute to an element
static void	setAttributeNS(org.w3c.dom.Element element, java.lang.String prefix, java.lang.String namespaceURI) Set a namespace attribute on an element.
protected boolean	setAttributeValue(XMLElement elementName, XMLElement attributeName, java.lang.String value) parsed an attribute of an element
protected void	setDescriptorInfo(java.lang.Object target, java.lang.String methodName, java.lang.String value) call a setter method on a descriptor with a new value
void	setElementValue(XMLElement element, java.lang.String value) receives notification of the value for a particular tag
void	setParentNode(XMLNode parentNode) set the parent node for the current instance.
protected void	setXMLRootTag(XMLElement element) sets the XML tag associated with this XMLNode
void	startElement(XMLElement element, org.xml.sax.Attributes attributes) SAX Parser API implementation, we don't really care for now.
protected void	writeAroundInvokeDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator aroundInvokeDescs)
protected void	writeAroundTimeoutDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator aroundTimeoutDescs)
protected void	writeDataSourceDefinitionDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator<DataSourceDefinitionDescriptor> dsDefinitionDescIterator) write a list of datasource-definition descriptors to a DOM Tree
org.w3c.dom.Node	writeDescriptor(org.w3c.dom.Node parent, java.lang.String nodeName, T descriptor) write the descriptor class to a DOM tree and return it
org.w3c.dom.Node	writeDescriptor(org.w3c.dom.Node parent, T descriptor) write the descriptor class to a DOM tree and return it
protected void	writeEjbReferenceDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator refs) write the ejb references (local or remote) to the DOM tree
protected void	writeEntityManagerFactoryReferenceDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator entityMgrFactoryRefs) write a list of entity manager factory reference descriptors to a DOM Tree
protected void	writeEntityManagerReferenceDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator entityMgrRefs) write a list of entity manager reference descriptors to a DOM Tree
protected void	writeEnvEntryDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator envEntries) write a list of env entry descriptors to a DOM Tree
protected void	writeJNDIEnvironmentRefs(org.w3c.dom.Node node, JndiNameEnvironment descriptor) writes jndi environment references group nodes
protected void	writeLocalizedDescriptions(org.w3c.dom.Node node, Descriptor desc) writes iocalized descriptions (if any) to the DOM node
protected void	writeMessageDestinationRefDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator msgDestRefs) write a list of message destination reference descriptors to a DOM Tree
protected void	writePostActivateDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator postActivateDescs)
protected void	writePostConstructDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator<LifecycleCallbackDescriptor> postConstructDescs) write a list of post-construct descriptors to a DOM Tree
protected void	writePreDestroyDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator<LifecycleCallbackDescriptor> preDestroyDescs) write a list of pre-destroy descriptors to a DOM Tree
protected void	writePrePassivateDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator prePassivateDescs)
protected void	writeResourceEnvRefDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator resRefs) write a list of resource env reference descriptors to a DOM Tree
protected void	writeResourceRefDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator resRefs) write a list of resource reference descriptors to a DOM Tree
protected void	writeServiceReferenceDescriptors(org.w3c.dom.Node parentNode, java.util.Iterator refs)

Methods inherited from class java.lang.Object

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

Field Detail

handlers

protected java.util.Hashtable handlers

parentNode

protected XMLNode parentNode

abstractDescriptor

protected java.lang.Object abstractDescriptor

localStrings

protected static final LocalStringManagerImpl localStrings

Constructor Detail

DeploymentDescriptorNode

public DeploymentDescriptorNode()

Creates new DeploymentDescriptorNode

Method Detail

getDescriptor

public T getDescriptor()

Specified by:

getDescriptor in interface XMLNode<T>

Returns:

the descriptor instance to associate with this XMLNode

addDescriptor

public void addDescriptor(java.lang.Object descriptor)

Adds a new DOL descriptor instance to the descriptor instance associated with this XMLNode

Specified by:

addDescriptor in interface XMLNode<T>

Parameters:

descriptor - the new descriptor

addNodeDescriptor

protected void addNodeDescriptor(DeploymentDescriptorNode node)

Adds a new DOL descriptor instance to the descriptor associated with this XMLNode

Parameters:

node - the sub-node adding the descriptor;

setParentNode

public void setParentNode(XMLNode parentNode)

set the parent node for the current instance.

getParentNode

public XMLNode getParentNode()

Specified by:

getParentNode in interface XMLNode<T>

Returns:

the parent node of the current instance

registerElementHandler

protected void registerElementHandler(XMLElement element,
                                      java.lang.Class handler)

register a new XMLNode handler for a particular XML tag.

Parameters:

element - XMLElement is the XML tag this XMLNode will handle

handler - the class implemenenting the XMLNode interface

registerElementHandler

protected void registerElementHandler(XMLElement element,
                                      java.lang.Class handler,
                                      java.lang.String addMethodName)

register a new XMLNode handler for a particular XML tag.

Parameters:

element - XMLElement is the XML tag this XMLNode will handle

handler - the class implemenenting the XMLNode interface

addMethodName - is the method name for adding the descriptor extracted by the handler node to the current descriptor

getXMLRootTag

protected XMLElement getXMLRootTag()

Returns:

the XML tag associated with this XMLNode

setXMLRootTag

protected void setXMLRootTag(XMLElement element)

sets the XML tag associated with this XMLNode

getHandlerFor

public XMLNode getHandlerFor(XMLElement element)

Description copied from interface: XMLNode

Return the XMLNode implementation respionsible for handling the sub-element of the current node

Specified by:

getHandlerFor in interface XMLNode<T>

Parameters:

element - the XML element type name

Returns:

the handler registered for the subtag element of the curent XMLNode

startElement

public void startElement(XMLElement element,
                         org.xml.sax.Attributes attributes)

SAX Parser API implementation, we don't really care for now.

Specified by:

startElement in interface XMLNode<T>

Parameters:

element - the XML element type name

attributes - the specified or defaultted attritutes

setAttributeValue

protected boolean setAttributeValue(XMLElement elementName,
                                    XMLElement attributeName,
                                    java.lang.String value)

parsed an attribute of an element

Parameters:

elementName - the element name

attributeName - the attribute name

value - the attribute value

Returns:

true if the attribute was processed

endElement

public boolean endElement(XMLElement element)

receives notification of the end of an XML element by the Parser

Specified by:

endElement in interface XMLNode<T>

Parameters:

element - the xml tag identification

Returns:

true if this node is done processing the XML sub tree

postParsing

public void postParsing()

notification of the end of XML parsing for this node

handlesElement

public boolean handlesElement(XMLElement element)

Description copied from interface: XMLNode

Return true if the XMLNode is responisble for handling the XML element

Specified by:

handlesElement in interface XMLNode<T>

Parameters:

element - the XML element type name

Returns:

true if the element tag can be handled by any registered sub nodes of the current XMLNode

setElementValue

public void setElementValue(XMLElement element,
                            java.lang.String value)

receives notification of the value for a particular tag

Specified by:

setElementValue in interface XMLNode<T>

Parameters:

element - the xml element

value - it's associated value

getDispatchTable

protected java.util.Map getDispatchTable()

all sub-implementation of this class can use a dispatch table to map xml element to method name on the descriptor class for setting the element value.

Returns:

the map with the element name as a key, the setter method as a value

setDescriptorInfo

protected void setDescriptorInfo(java.lang.Object target,
                                 java.lang.String methodName,
                                 java.lang.String value)
                          throws java.lang.NoSuchMethodException,
                                 java.lang.IllegalAccessException,
                                 java.lang.reflect.InvocationTargetException

call a setter method on a descriptor with a new value

Parameters:

target - the descriptor to use

methodName - the setter method to invoke

value - the new value for the field in the descriptor

Throws:

java.lang.NoSuchMethodException

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

getXMLPath

public java.lang.String getXMLPath()

Specified by:

getXMLPath in interface XMLNode<T>

Returns:

the XPath this XML Node is handling

writeDescriptor

public org.w3c.dom.Node writeDescriptor(org.w3c.dom.Node parent,
                                        T descriptor)

write the descriptor class to a DOM tree and return it

Specified by:

writeDescriptor in interface XMLNode<T>

Parameters:

parent - node in the DOM tree

descriptor - the descriptor to write

Returns:

the DOM tree top node

writeDescriptor

public org.w3c.dom.Node writeDescriptor(org.w3c.dom.Node parent,
                                        java.lang.String nodeName,
                                        T descriptor)

write the descriptor class to a DOM tree and return it

Parameters:

parent - node in the DOM tree

nodeName - name for the root element for this DOM tree fragment

descriptor - the descriptor to write

Returns:

the DOM tree top node

getOwnerDocument

protected static org.w3c.dom.Document getOwnerDocument(org.w3c.dom.Node node)

Returns:

the Document for the given node

appendChild

public static org.w3c.dom.Element appendChild(org.w3c.dom.Node parent,
                                              java.lang.String elementName)

Append a new element child to the current node

Parameters:

parent - is the parent node for the new child element

elementName - is new element tag name

Returns:

the newly created child node

appendTextChild

public static org.w3c.dom.Node appendTextChild(org.w3c.dom.Node parent,
                                               java.lang.String elementName,
                                               java.lang.String text)

Append a new text child

Parameters:

parent - for the new child element

elementName - is the new element tag name

text - the text for the new element

appendTextChild

public static org.w3c.dom.Node appendTextChild(org.w3c.dom.Node parent,
                                               java.lang.String elementName,
                                               int value)

Append a new text child

Parameters:

parent - for the new child element

elementName - is the new element tag name

value - the int value for the new element

forceAppendTextChild

public static org.w3c.dom.Node forceAppendTextChild(org.w3c.dom.Node parent,
                                                    java.lang.String elementName,
                                                    java.lang.String text)

Append a new text child even if text is empty

Parameters:

parent - for the new child element

elementName - is the new element tag name

text - the text for the new element

setAttribute

public static void setAttribute(org.w3c.dom.Element parent,
                                java.lang.String elementName,
                                java.lang.String text)

Append a new attribute to an element

Parameters:

parent - for the new child element

elementName - is the new element tag name

text - the text for the new element

setAttributeNS

public static void setAttributeNS(org.w3c.dom.Element element,
                                  java.lang.String prefix,
                                  java.lang.String namespaceURI)

Set a namespace attribute on an element.

Parameters:

element - on which to set attribute

prefix - raw prefix (without "xmlns:")

namespaceURI - namespace URI to which prefix is mapped.

writeEnvEntryDescriptors

protected void writeEnvEntryDescriptors(org.w3c.dom.Node parentNode,
                                        java.util.Iterator envEntries)

write a list of env entry descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

envEntries - the iterator over the descriptors to write

writeEjbReferenceDescriptors

protected void writeEjbReferenceDescriptors(org.w3c.dom.Node parentNode,
                                            java.util.Iterator refs)

write the ejb references (local or remote) to the DOM tree

Parameters:

parentNode - parent node for the DOM tree

refs - the set of EjbReferenceDescriptor to write

writeServiceReferenceDescriptors

protected void writeServiceReferenceDescriptors(org.w3c.dom.Node parentNode,
                                                java.util.Iterator refs)

writeResourceRefDescriptors

protected void writeResourceRefDescriptors(org.w3c.dom.Node parentNode,
                                           java.util.Iterator resRefs)

write a list of resource reference descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

resRefs - the iterator over the descriptors to write

writeResourceEnvRefDescriptors

protected void writeResourceEnvRefDescriptors(org.w3c.dom.Node parentNode,
                                              java.util.Iterator resRefs)

write a list of resource env reference descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

resRefs - the iterator over the descriptors to write

writeMessageDestinationRefDescriptors

protected void writeMessageDestinationRefDescriptors(org.w3c.dom.Node parentNode,
                                                     java.util.Iterator msgDestRefs)

write a list of message destination reference descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

msgDestRefs - the iterator over the descriptors to write

writeEntityManagerReferenceDescriptors

protected void writeEntityManagerReferenceDescriptors(org.w3c.dom.Node parentNode,
                                                      java.util.Iterator entityMgrRefs)

write a list of entity manager reference descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

entityMgrRefs - the iterator over the descriptors to write

writeEntityManagerFactoryReferenceDescriptors

protected void writeEntityManagerFactoryReferenceDescriptors(org.w3c.dom.Node parentNode,
                                                             java.util.Iterator entityMgrFactoryRefs)

write a list of entity manager factory reference descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

entityMgrFactoryRefs - the iterator over the descriptors to write

writeAroundInvokeDescriptors

protected void writeAroundInvokeDescriptors(org.w3c.dom.Node parentNode,
                                            java.util.Iterator aroundInvokeDescs)

writeAroundTimeoutDescriptors

protected void writeAroundTimeoutDescriptors(org.w3c.dom.Node parentNode,
                                             java.util.Iterator aroundTimeoutDescs)

writePostActivateDescriptors

protected void writePostActivateDescriptors(org.w3c.dom.Node parentNode,
                                            java.util.Iterator postActivateDescs)

writePrePassivateDescriptors

protected void writePrePassivateDescriptors(org.w3c.dom.Node parentNode,
                                            java.util.Iterator prePassivateDescs)

writePostConstructDescriptors

protected void writePostConstructDescriptors(org.w3c.dom.Node parentNode,
                                             java.util.Iterator<LifecycleCallbackDescriptor> postConstructDescs)

write a list of post-construct descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

postConstructDescs - the iterator over the descriptors to write

writePreDestroyDescriptors

protected void writePreDestroyDescriptors(org.w3c.dom.Node parentNode,
                                          java.util.Iterator<LifecycleCallbackDescriptor> preDestroyDescs)

write a list of pre-destroy descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

preDestroyDescs - the iterator over the descriptors to write

writeDataSourceDefinitionDescriptors

protected void writeDataSourceDefinitionDescriptors(org.w3c.dom.Node parentNode,
                                                    java.util.Iterator<DataSourceDefinitionDescriptor> dsDefinitionDescIterator)

write a list of datasource-definition descriptors to a DOM Tree

Parameters:

parentNode - parent node for the DOM tree

dsDefinitionDescIterator - the iterator over the descriptors to write

writeLocalizedDescriptions

protected void writeLocalizedDescriptions(org.w3c.dom.Node node,
                                          Descriptor desc)

writes iocalized descriptions (if any) to the DOM node

writeJNDIEnvironmentRefs

protected void writeJNDIEnvironmentRefs(org.w3c.dom.Node node,
                                        JndiNameEnvironment descriptor)

writes jndi environment references group nodes

addNamespaceDeclaration

protected void addNamespaceDeclaration(org.w3c.dom.Element node,
                                       Descriptor descriptor)

Any node can now declare its own namespace. this apply to DDs only when dealing with deployment extensions. Write any declared namespace declaration

Parameters:

node - from which this namespace is declared

descriptor - containing the namespace declaration if any

addPrefixMapping

public void addPrefixMapping(java.lang.String prefix,
                             java.lang.String uri)

notify of a new prefix mapping used in this document

Specified by:

addPrefixMapping in interface XMLNode<T>

resolvePrefix

public java.lang.String resolvePrefix(XMLElement element,
                                      java.lang.String prefix)

Resolve a QName prefix to its corresponding Namespace URI by searching up node chain starting with child.

Specified by:

resolvePrefix in interface XMLNode<T>

getPrefixFromQName

public java.lang.String getPrefixFromQName(java.lang.String qname)

Returns:

namespace URI prefix from qname, where qname is an xsd:QName, or the empty string if there is no prefix. QName ::= (Prefix ':')? LocalPart

getLocalPartFromQName

public java.lang.String getLocalPartFromQName(java.lang.String qname)

Return local part from qname, where qname is an xsd:QName. QName ::= (Prefix ':')? LocalPart

composeQNameValue

public java.lang.String composeQNameValue(java.lang.String prefix,
                                          java.lang.String localPart)

appendQNameChild

public void appendQNameChild(java.lang.String elementName,
                             org.w3c.dom.Node parent,
                             java.lang.String namespaceUri,
                             java.lang.String localPart,
                             java.lang.String prefix)