com.novell.nds.dirxml.util

Class DxDOMUtil

java.lang.Object

com.novell.nds.dirxml.util.DxDOMUtil

public abstract class DxDOMUtil
extends java.lang.Object

A utility class for performing various common and useful DOM operations that are not part of the DOM specification.

Field Summary

Fields

Modifier and Type	Field and Description
protected static com.novell.xml.util.ExpandedQName	SEARCH_NULL_ANY Wildcard search name that will match the null namespace URI and any local part.
static java.lang.String	TAG_WILDCARD Wildcard value that can be used for both the namespaceURI and localPart parameters to the various "ByTagName" functions

Constructor Summary

Constructors

Constructor and Description
DxDOMUtil()

Method Summary

Modifier and Type	Method and Description
static org.w3c.dom.Document	cloneDocument(org.w3c.dom.Document doc) Creates clone of a document.
static org.w3c.dom.Node	cloneSubtree(org.w3c.dom.Document targetDoc, org.w3c.dom.Node sourceRoot) Clone a subtree, possibly into another document
static boolean	copyAttributeEx(com.novell.xml.dom.ElementImpl src, com.novell.xml.util.ExpandedQName attrName, com.novell.xml.dom.ElementImpl dest) Copy an attribute from one element to another, but only if the attribute has a non-empty value.
static boolean	copyAttributeEx(com.novell.xml.dom.ElementImpl src, com.novell.xml.util.ExpandedQName srcAttrName, com.novell.xml.dom.ElementImpl dest, com.novell.xml.util.ExpandedQName destAttrName) Copy an attribute from one element to another, but only if the attribute has a non-empty value.
static boolean	copyAttributeNS(org.w3c.dom.Element src, java.lang.String attrNamespaceURI, java.lang.String attrLocalName, org.w3c.dom.Element dest) Copy an attribute from one element to another, but only if the attribute has a non-empty value
static boolean	copyAttributeNS(org.w3c.dom.Element src, java.lang.String srcAttrNamespaceURI, java.lang.String srcAttrLocalPart, org.w3c.dom.Element dest, java.lang.String destAttrNamespaceURI, java.lang.String destAttrQName) Copy an attribute from one element to another, with an new attribute name, but only if the attribute has a non-empty value.
static org.w3c.dom.Element[]	elementArrayListToElementArray(java.util.ArrayList arrayList) Create an array of Elements from an ArrayList containing only Elements.
static com.novell.xml.dom.ElementImpl[]	elementImplArrayListToElementImplArray(java.util.ArrayList arrayList) creates an array of ElementImpls from an ArrayList containing only ElementImpls.
static void	ensureDOMImpl(XmlDocument src) Conditionally convert the passed document to the DirXML DOM implementation.
static java.lang.String	getAssociationState(org.w3c.dom.Element element) Get the value of the "state" attribute of the first <association> element found under the passed element.
static java.lang.String	getAssociationStateEx(com.novell.xml.dom.ElementImpl element) Get the value of the "state" attribute of the first <association> element found under the passed element.
static java.lang.String	getAssociationValue(org.w3c.dom.Element element) Get the value of the first <association> element found under the passed element.
static java.lang.String	getAssociationValueEx(com.novell.xml.dom.ElementImpl element) Get the value of the first <association> element found under the passed element.
static org.w3c.dom.Element[]	getChildElements(org.w3c.dom.Node node) Get all child elements of a node.
static com.novell.xml.dom.ElementImpl[]	getChildElementsByTagNameEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName qName) Get the all child elements of a node with a particular qualified tag name.
static org.w3c.dom.Element[]	getChildElementsByTagNameNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart) Get the all child elements of a node with a particular qualified tag name.
static com.novell.xml.dom.ElementImpl[]	getChildElementsByTagNameWithAttrEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName) Get all child elements of a node with a particular QName and a particular non-empty attribute.
static org.w3c.dom.Element[]	getChildElementsByTagNameWithAttrNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart) Get all child elements of a node with a particular qualified tag name and a particular non-empty attribute.
static com.novell.xml.dom.ElementImpl[]	getChildElementsByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName, java.lang.String attrValue) Get all child elements of a node with a particular QName and a particular attribute/value pair (value is case sensitive)
static com.novell.xml.dom.ElementImpl[]	getChildElementsByTagNameWithAttrValueIgnoreCaseEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName, java.lang.String attrValue) Get all child elements of a node with a particular QName and a particular attribute/value pair (value is not case sensitive)
static org.w3c.dom.Element[]	getChildElementsByTagNameWithAttrValueIgnoreCaseNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart, java.lang.String attrValue) Get all child elements of a node with a particular tag name and a particular attribute/value pair (value is not case sensitive)
static org.w3c.dom.Element[]	getChildElementsByTagNameWithAttrValueNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart, java.lang.String attrValue) Get all child elements of a node with a particular tag name and a particular attribute/value pair (value is case sensitive)
static com.novell.xml.dom.ElementImpl[]	getChildElementsEx(com.novell.xml.dom.NodeImpl node) Get all child elements of a node.
static java.lang.String	getChildText(org.w3c.dom.Node node) Get the concatenation of all the child text nodes of the passed node.
static org.w3c.dom.NodeList	getElementsByTagNameEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName qName) Get all descendant Elements of a node with a particular tag name.
static org.w3c.dom.NodeList	getElementsByTagNameNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart) Get all descendant elements of a node with a particular qualified tag name.
static com.novell.xml.dom.ElementImpl[]	getElementsByTagNameWithAttrEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName) Get all descendant elements of an node with a particular QName and a particular non-empty attribute.
static org.w3c.dom.Element[]	getElementsByTagNameWithAttrNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart) Get all descendant elements of an node with a particular tag name and a particular non-empty attribute.
static com.novell.xml.dom.ElementImpl[]	getElementsByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName, java.lang.String attrValue) Get all descendant elements of an node with a QName and a particular attribute/value pair (value is case sensitive)
static org.w3c.dom.Element[]	getElementsByTagNameWithAttrValueNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart, java.lang.String attrValue) Get all descendant elements of an node with a particular tag name and a particular attribute/value pair (value is case sensitive)
static com.novell.xml.dom.ElementImpl	getFirstAncestorElementByTagNameEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName) Get the nearest ancestor element of an node with a particular QName
static org.w3c.dom.Element	getFirstAncestorElementByTagNameNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart) Get the nearest ancestor element of an node with a particular tag name
static com.novell.xml.dom.ElementImpl	getFirstAncestorElementByTagNameWithAttrEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName) Get the nearest ancestor element of an node with a particular QName and a particular non-empty attribute.
static org.w3c.dom.Element	getFirstAncestorElementByTagNameWithAttrNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart) Get the nearest ancestor element of an node with a particular tag name and a particular non-empty attribute.
static org.w3c.dom.Element	getFirstChildElement(org.w3c.dom.Node node) Get the first child element of a node
static com.novell.xml.dom.ElementImpl	getFirstChildElementByTagNameEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName qName) Get the first child element of a node with a particular tag name.
static org.w3c.dom.Element	getFirstChildElementByTagNameNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart) Get a node's first child element with a particular qualified tag name.
static com.novell.xml.dom.ElementImpl	getFirstChildElementByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName, java.lang.String attrValue) Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is case sensitive)
static com.novell.xml.dom.ElementImpl	getFirstChildElementByTagNameWithAttrValueIgnoreCaseEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName, java.lang.String attrValue) Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is not case sensitive)
static org.w3c.dom.Element	getFirstChildElementByTagNameWithAttrValueIgnoreCaseNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart, java.lang.String attrValue) Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is not case sensitive)
static org.w3c.dom.Element	getFirstChildElementByTagNameWithAttrValueNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart, java.lang.String attrValue) Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is case sensitive)
static com.novell.xml.dom.ElementImpl	getFirstChildElementEx(com.novell.xml.dom.NodeImpl node) Get the first child element of a node
static com.novell.xml.dom.ElementImpl	getFirstElementByTagNameEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName qName) Get first descendant element of an node with a particular tag name.
static org.w3c.dom.Element	getFirstElementByTagNameNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart) Get first descendant element of an node with a particular tag name.
static com.novell.xml.dom.ElementImpl	getFirstElementByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName, com.novell.xml.util.ExpandedQName attrName, java.lang.String attrValue) Get the first descendant element of an node with a particular QName and a particular attribute/value pair (value is case sensitive)
static org.w3c.dom.Element	getFirstElementByTagNameWithAttrValueNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart, java.lang.String attrNamespaceURI, java.lang.String attrLocalPart, java.lang.String attrValue) Get the first descendant elements of an node with a particular tag name and a particular attribute/value pair (value is case sensitive)
static org.w3c.dom.Element	getFirstValue(org.w3c.dom.Node node, java.lang.String attrName) Get the first <value> element for the passed directory attribute.
static com.novell.xml.dom.ElementImpl	getFirstValueEx(com.novell.xml.dom.NodeImpl node, java.lang.String attrName) Get the first <value> element for the passed directory attribute.
static java.lang.String	getNodeText(org.w3c.dom.Node node) Get the string value for a node (as defined by XPath).
static java.util.Date	getTimestamp(org.w3c.dom.Element element) Get a Date instance from the timestamp attribute for an element
static int	getTimestampEventCount(org.w3c.dom.Element element) Get the timestamp event count from the timestamp attribute for an element
static int	getTimestampEventCountEx(com.novell.xml.dom.ElementImpl element) Get the timestamp event count from the timestamp attribute for an element
static java.util.Date	getTimestampEx(com.novell.xml.dom.ElementImpl element) Get a Date instance from the timestamp attribute for an element
static void	graftSubtree(org.w3c.dom.Node parent, org.w3c.dom.Node sourceRoot) Graft a cloned subtree, possibly into another document
static org.w3c.dom.Node[]	nodeListToNodeArray(org.w3c.dom.NodeList list) Create an array of nodes from a NodeList.
static void	removeAllChildren(org.w3c.dom.Node node) Remove all the children of a node.
static void	removeChildElementsByTagNameEx(com.novell.xml.dom.NodeImpl node, com.novell.xml.util.ExpandedQName elementName) Remove all child elements of a node with a particular QName.
static void	removeChildElementsByTagNameNS(org.w3c.dom.Node node, java.lang.String namespaceURI, java.lang.String localPart) Remove all child elements of a node with a particular tag name.
static com.novell.xml.dom.ElementImpl	renameElementEx(com.novell.xml.dom.ElementImpl element, com.novell.xml.util.ExpandedQName newName) Rename an element.
static org.w3c.dom.Element	renameElementNS(org.w3c.dom.Element element, java.lang.String namespaceURI, java.lang.String qName) Rename an element.
static void	setNodeText(org.w3c.dom.Node node, java.lang.String text) Set the string value for a node.

Methods inherited from class java.lang.Object

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

Field Detail

TAG_WILDCARD

public static final java.lang.String TAG_WILDCARD

Wildcard value that can be used for both the namespaceURI and localPart parameters to the various "ByTagName" functions

See Also:

Constant Field Values

SEARCH_NULL_ANY

protected static final com.novell.xml.util.ExpandedQName SEARCH_NULL_ANY

Wildcard search name that will match the null namespace URI and any local part.

Constructor Detail

DxDOMUtil

public DxDOMUtil()

Method Detail

getNodeText

public static java.lang.String getNodeText(org.w3c.dom.Node node)

Get the string value for a node (as defined by XPath).

Parameters:

node - the node

Returns:

the string value of the node

getChildText

public static java.lang.String getChildText(org.w3c.dom.Node node)

Get the concatenation of all the child text nodes of the passed node.

Parameters:

node - the parent node

Returns:

the concatentation of all child text node values

setNodeText

public static void setNodeText(org.w3c.dom.Node node,
                               java.lang.String text)

Set the string value for a node. This removes all current children and adds a single, new text node child. If the passed text is null or empty no child is added.

Parameters:

node - the parent node

text - the desired text value of the node

getFirstChildElement

public static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Node node)

Get the first child element of a node

Parameters:

node - the parent node

Returns:

the first child element, or null if no such element exists

getFirstChildElementEx

public static com.novell.xml.dom.ElementImpl getFirstChildElementEx(com.novell.xml.dom.NodeImpl node)

Get the first child element of a node

Parameters:

node - the parent node

Returns:

the first child element, or null if no such element exists

getFirstChildElementByTagNameNS

public static org.w3c.dom.Element getFirstChildElementByTagNameNS(org.w3c.dom.Node node,
                                                                  java.lang.String namespaceURI,
                                                                  java.lang.String localPart)

Get a node's first child element with a particular qualified tag name.

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

Returns:

the first matching element or null if no such element exists

getFirstChildElementByTagNameEx

public static com.novell.xml.dom.ElementImpl getFirstChildElementByTagNameEx(com.novell.xml.dom.NodeImpl node,
                                                                             com.novell.xml.util.ExpandedQName qName)

Get the first child element of a node with a particular tag name.

Parameters:

node - the node

qName - the expanded QName of the element to find

Returns:

the first matching element or null if no such element exists

getFirstChildElementByTagNameWithAttrValueNS

public static org.w3c.dom.Element getFirstChildElementByTagNameWithAttrValueNS(org.w3c.dom.Node node,
                                                                               java.lang.String namespaceURI,
                                                                               java.lang.String localPart,
                                                                               java.lang.String attrNamespaceURI,
                                                                               java.lang.String attrLocalPart,
                                                                               java.lang.String attrValue)

Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

attrValue - the attribute value

Returns:

the first matching element or null if no such element exists

getFirstChildElementByTagNameWithAttrValueEx

public static com.novell.xml.dom.ElementImpl getFirstChildElementByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node,
                                                                                          com.novell.xml.util.ExpandedQName elementName,
                                                                                          com.novell.xml.util.ExpandedQName attrName,
                                                                                          java.lang.String attrValue)

Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

elementName - the qualified element name

attrName - the qualifed attribute name

attrValue - the attribute value

Returns:

the first matching element or null if no such element exists

getFirstChildElementByTagNameWithAttrValueIgnoreCaseNS

public static org.w3c.dom.Element getFirstChildElementByTagNameWithAttrValueIgnoreCaseNS(org.w3c.dom.Node node,
                                                                                         java.lang.String namespaceURI,
                                                                                         java.lang.String localPart,
                                                                                         java.lang.String attrNamespaceURI,
                                                                                         java.lang.String attrLocalPart,
                                                                                         java.lang.String attrValue)

Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is not case sensitive)

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

attrValue - the attribute value

Returns:

the first matching element or null if no such element exists

getFirstChildElementByTagNameWithAttrValueIgnoreCaseEx

public static com.novell.xml.dom.ElementImpl getFirstChildElementByTagNameWithAttrValueIgnoreCaseEx(com.novell.xml.dom.NodeImpl node,
                                                                                                    com.novell.xml.util.ExpandedQName elementName,
                                                                                                    com.novell.xml.util.ExpandedQName attrName,
                                                                                                    java.lang.String attrValue)

Get the first child element of a node with a particular tag name and a particular attribute/value pair (value is not case sensitive)

Parameters:

node - the node

elementName - the qualified element name

attrName - the qualifed attribute name

attrValue - the attribute value

Returns:

the first matching element or null if no such element exists

getChildElements

public static org.w3c.dom.Element[] getChildElements(org.w3c.dom.Node node)

Get all child elements of a node.

Parameters:

node - the parent node

Returns:

array containing the all the child elements of the element, possibly 0 length, but never null

getChildElementsEx

public static com.novell.xml.dom.ElementImpl[] getChildElementsEx(com.novell.xml.dom.NodeImpl node)

Get all child elements of a node.

Parameters:

node - the parent node

Returns:

array containing the all the child elements of the element, possibly 0 length, but never null

getChildElementsByTagNameNS

public static org.w3c.dom.Element[] getChildElementsByTagNameNS(org.w3c.dom.Node node,
                                                                java.lang.String namespaceURI,
                                                                java.lang.String localPart)

Get the all child elements of a node with a particular qualified tag name.

Parameters:

node - the parent node

namespaceURI - element name's namespace URI

localPart - the element name's local part

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameEx

public static com.novell.xml.dom.ElementImpl[] getChildElementsByTagNameEx(com.novell.xml.dom.NodeImpl node,
                                                                           com.novell.xml.util.ExpandedQName qName)

Get the all child elements of a node with a particular qualified tag name.

Parameters:

node - the parent node

qName - the element name

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameWithAttrNS

public static org.w3c.dom.Element[] getChildElementsByTagNameWithAttrNS(org.w3c.dom.Node node,
                                                                        java.lang.String namespaceURI,
                                                                        java.lang.String localPart,
                                                                        java.lang.String attrNamespaceURI,
                                                                        java.lang.String attrLocalPart)

Get all child elements of a node with a particular qualified tag name and a particular non-empty attribute.

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameWithAttrEx

public static com.novell.xml.dom.ElementImpl[] getChildElementsByTagNameWithAttrEx(com.novell.xml.dom.NodeImpl node,
                                                                                   com.novell.xml.util.ExpandedQName elementName,
                                                                                   com.novell.xml.util.ExpandedQName attrName)

Get all child elements of a node with a particular QName and a particular non-empty attribute.

Parameters:

node - the parent node

elementName - the QName of the elements to find

attrName - the QName of the non-empty attribute

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameWithAttrValueNS

public static org.w3c.dom.Element[] getChildElementsByTagNameWithAttrValueNS(org.w3c.dom.Node node,
                                                                             java.lang.String namespaceURI,
                                                                             java.lang.String localPart,
                                                                             java.lang.String attrNamespaceURI,
                                                                             java.lang.String attrLocalPart,
                                                                             java.lang.String attrValue)

Get all child elements of a node with a particular tag name and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameWithAttrValueEx

public static com.novell.xml.dom.ElementImpl[] getChildElementsByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node,
                                                                                        com.novell.xml.util.ExpandedQName elementName,
                                                                                        com.novell.xml.util.ExpandedQName attrName,
                                                                                        java.lang.String attrValue)

Get all child elements of a node with a particular QName and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

elementName - the child elements' QName

attrName - the attributes' QName

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameWithAttrValueIgnoreCaseNS

public static org.w3c.dom.Element[] getChildElementsByTagNameWithAttrValueIgnoreCaseNS(org.w3c.dom.Node node,
                                                                                       java.lang.String namespaceURI,
                                                                                       java.lang.String localPart,
                                                                                       java.lang.String attrNamespaceURI,
                                                                                       java.lang.String attrLocalPart,
                                                                                       java.lang.String attrValue)

Get all child elements of a node with a particular tag name and a particular attribute/value pair (value is not case sensitive)

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

getChildElementsByTagNameWithAttrValueIgnoreCaseEx

public static com.novell.xml.dom.ElementImpl[] getChildElementsByTagNameWithAttrValueIgnoreCaseEx(com.novell.xml.dom.NodeImpl node,
                                                                                                  com.novell.xml.util.ExpandedQName elementName,
                                                                                                  com.novell.xml.util.ExpandedQName attrName,
                                                                                                  java.lang.String attrValue)

Get all child elements of a node with a particular QName and a particular attribute/value pair (value is not case sensitive)

Parameters:

node - the parent node

elementName - the child elements' QName

attrName - the attributes' QName

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

getElementsByTagNameNS

public static org.w3c.dom.NodeList getElementsByTagNameNS(org.w3c.dom.Node node,
                                                          java.lang.String namespaceURI,
                                                          java.lang.String localPart)

Get all descendant elements of a node with a particular qualified tag name.

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

Returns:

NodeList containing any matching elements

getElementsByTagNameEx

public static org.w3c.dom.NodeList getElementsByTagNameEx(com.novell.xml.dom.NodeImpl node,
                                                          com.novell.xml.util.ExpandedQName qName)

Get all descendant Elements of a node with a particular tag name.

Wildcards may be used, either by passing ExpandedQName.WILDCARD_QNAME, or by constructing an ExpandedQName instance using some combination of NamespaceName.WILDCARD_NAMESPACE and ExpandedQName.WILDCARD_LOCALPART.

Parameters:

node - the node whose descendants are to be found

qName - the QName of the descendant Elements to find

Returns:

list containing the matching Elements

getElementsByTagNameWithAttrNS

public static org.w3c.dom.Element[] getElementsByTagNameWithAttrNS(org.w3c.dom.Node node,
                                                                   java.lang.String namespaceURI,
                                                                   java.lang.String localPart,
                                                                   java.lang.String attrNamespaceURI,
                                                                   java.lang.String attrLocalPart)

Get all descendant elements of an node with a particular tag name and a particular non-empty attribute.

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

Returns:

array containing the matching elements, possibly 0 length, but never null

getElementsByTagNameWithAttrEx

public static com.novell.xml.dom.ElementImpl[] getElementsByTagNameWithAttrEx(com.novell.xml.dom.NodeImpl node,
                                                                              com.novell.xml.util.ExpandedQName elementName,
                                                                              com.novell.xml.util.ExpandedQName attrName)

Get all descendant elements of an node with a particular QName and a particular non-empty attribute.

Parameters:

node - the parent node

elementName - the QName of the desired elements

attrName - the QName of the attribute

Returns:

array containing the matching elements, possibly 0 length, but never null

getElementsByTagNameWithAttrValueNS

public static org.w3c.dom.Element[] getElementsByTagNameWithAttrValueNS(org.w3c.dom.Node node,
                                                                        java.lang.String namespaceURI,
                                                                        java.lang.String localPart,
                                                                        java.lang.String attrNamespaceURI,
                                                                        java.lang.String attrLocalPart,
                                                                        java.lang.String attrValue)

Get all descendant elements of an node with a particular tag name and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

getElementsByTagNameWithAttrValueEx

public static com.novell.xml.dom.ElementImpl[] getElementsByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node,
                                                                                   com.novell.xml.util.ExpandedQName elementName,
                                                                                   com.novell.xml.util.ExpandedQName attrName,
                                                                                   java.lang.String attrValue)

Get all descendant elements of an node with a QName and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

elementName - the QName of the desired elements

attrName - the QName of the attribute

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

removeChildElementsByTagNameNS

public static void removeChildElementsByTagNameNS(org.w3c.dom.Node node,
                                                  java.lang.String namespaceURI,
                                                  java.lang.String localPart)

Remove all child elements of a node with a particular tag name.

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

removeChildElementsByTagNameEx

public static void removeChildElementsByTagNameEx(com.novell.xml.dom.NodeImpl node,
                                                  com.novell.xml.util.ExpandedQName elementName)

Remove all child elements of a node with a particular QName.

Parameters:

node - the parent node

elementName - the elements' QName

getFirstElementByTagNameNS

public static org.w3c.dom.Element getFirstElementByTagNameNS(org.w3c.dom.Node node,
                                                             java.lang.String namespaceURI,
                                                             java.lang.String localPart)

Get first descendant element of an node with a particular tag name.

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

Returns:

the first matching element or null if no such element exists

getFirstElementByTagNameEx

public static com.novell.xml.dom.ElementImpl getFirstElementByTagNameEx(com.novell.xml.dom.NodeImpl node,
                                                                        com.novell.xml.util.ExpandedQName qName)

Get first descendant element of an node with a particular tag name.

Parameters:

node - the node

qName - the tag name to find

Returns:

the first matching element or null if no such element exists

getFirstElementByTagNameWithAttrValueNS

public static org.w3c.dom.Element getFirstElementByTagNameWithAttrValueNS(org.w3c.dom.Node node,
                                                                          java.lang.String namespaceURI,
                                                                          java.lang.String localPart,
                                                                          java.lang.String attrNamespaceURI,
                                                                          java.lang.String attrLocalPart,
                                                                          java.lang.String attrValue)

Get the first descendant elements of an node with a particular tag name and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

namespaceURI - the namespace URI of the qualified tag name

localPart - the local part of the qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

getFirstElementByTagNameWithAttrValueEx

public static com.novell.xml.dom.ElementImpl getFirstElementByTagNameWithAttrValueEx(com.novell.xml.dom.NodeImpl node,
                                                                                     com.novell.xml.util.ExpandedQName elementName,
                                                                                     com.novell.xml.util.ExpandedQName attrName,
                                                                                     java.lang.String attrValue)

Get the first descendant element of an node with a particular QName and a particular attribute/value pair (value is case sensitive)

Parameters:

node - the parent node

elementName - the child elements' QName

attrName - the attributes' QName

attrValue - the attribute value

Returns:

array containing the matching elements, possibly 0 length, but never null

cloneSubtree

public static org.w3c.dom.Node cloneSubtree(org.w3c.dom.Document targetDoc,
                                            org.w3c.dom.Node sourceRoot)

Clone a subtree, possibly into another document

Parameters:

targetDoc - target document for the cloned document

sourceRoot - root of subtree to clone

Returns:

root of the cloned subtree, or null if not cloneable

graftSubtree

public static void graftSubtree(org.w3c.dom.Node parent,
                                org.w3c.dom.Node sourceRoot)

Graft a cloned subtree, possibly into another document

Parameters:

parent - target parent

sourceRoot - root of subtree to clone

cloneDocument

public static org.w3c.dom.Document cloneDocument(org.w3c.dom.Document doc)

Creates clone of a document. NOTE: only clones the tree structure, ie. ignores any document attributes

Parameters:

doc - document to clone

Returns:

cloned document

renameElementNS

public static org.w3c.dom.Element renameElementNS(org.w3c.dom.Element element,
                                                  java.lang.String namespaceURI,
                                                  java.lang.String qName)

Rename an element. May replace the element with a new one that has the same attributes and children.

Parameters:

element - element to be renamed

namespaceURI - the namespace URI of the new qualified tag name

qName - "[prefix:]local part" of the new qualified tag name

Returns:

the renamed element

renameElementEx

public static com.novell.xml.dom.ElementImpl renameElementEx(com.novell.xml.dom.ElementImpl element,
                                                             com.novell.xml.util.ExpandedQName newName)

Rename an element.

Parameters:

element - element to be renamed

newName - the new QName for the element

Returns:

the renamed element

removeAllChildren

public static void removeAllChildren(org.w3c.dom.Node node)

Remove all the children of a node.

Parameters:

node - the parent node

getFirstAncestorElementByTagNameNS

public static org.w3c.dom.Element getFirstAncestorElementByTagNameNS(org.w3c.dom.Node node,
                                                                     java.lang.String namespaceURI,
                                                                     java.lang.String localPart)

Get the nearest ancestor element of an node with a particular tag name

Parameters:

node - the starting node

namespaceURI - the namespace URI of the ancestor's qualified tag name

localPart - the local part of the ancestor's qualified tag name

Returns:

the first matching element, or null if no such element exists

getFirstAncestorElementByTagNameEx

public static com.novell.xml.dom.ElementImpl getFirstAncestorElementByTagNameEx(com.novell.xml.dom.NodeImpl node,
                                                                                com.novell.xml.util.ExpandedQName elementName)

Get the nearest ancestor element of an node with a particular QName

Parameters:

node - the node from which to start

elementName - the ancestor element's QName

Returns:

the first matching element or null if no such element exists

getFirstAncestorElementByTagNameWithAttrNS

public static org.w3c.dom.Element getFirstAncestorElementByTagNameWithAttrNS(org.w3c.dom.Node node,
                                                                             java.lang.String namespaceURI,
                                                                             java.lang.String localPart,
                                                                             java.lang.String attrNamespaceURI,
                                                                             java.lang.String attrLocalPart)

Get the nearest ancestor element of an node with a particular tag name and a particular non-empty attribute.

Parameters:

node - the starting node

namespaceURI - the namespace URI of the ancestor's qualified tag name

localPart - the local part of the ancestor's qualified tag name

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

Returns:

the first matching element or null if no such element exists

getFirstAncestorElementByTagNameWithAttrEx

public static com.novell.xml.dom.ElementImpl getFirstAncestorElementByTagNameWithAttrEx(com.novell.xml.dom.NodeImpl node,
                                                                                        com.novell.xml.util.ExpandedQName elementName,
                                                                                        com.novell.xml.util.ExpandedQName attrName)

Get the nearest ancestor element of an node with a particular QName and a particular non-empty attribute.

Parameters:

node - the node from which to start

elementName - the ancestor element's QName

attrName - the attribute name

Returns:

the first matching element or null if no such element exists

nodeListToNodeArray

public static org.w3c.dom.Node[] nodeListToNodeArray(org.w3c.dom.NodeList list)

Create an array of nodes from a NodeList.

Parameters:

list - the NodeList

Returns:

array of nodes containing the same members as list

elementArrayListToElementArray

public static org.w3c.dom.Element[] elementArrayListToElementArray(java.util.ArrayList arrayList)

Create an array of Elements from an ArrayList containing only Elements.

Parameters:

arrayList - the list

Returns:

array containing the same members as the arrayList

elementImplArrayListToElementImplArray

public static com.novell.xml.dom.ElementImpl[] elementImplArrayListToElementImplArray(java.util.ArrayList arrayList)

creates an array of ElementImpls from an ArrayList containing only ElementImpls.

Parameters:

arrayList - the list

Returns:

array of ElementImpls containing the same members as the parameter

getAssociationValue

public static java.lang.String getAssociationValue(org.w3c.dom.Element element)

Get the value of the first <association> element found under the passed element.

Parameters:

element - the element

Returns:

association value (possibly empty, but never null)

getAssociationValueEx

public static java.lang.String getAssociationValueEx(com.novell.xml.dom.ElementImpl element)

Get the value of the first <association> element found under the passed element.

Parameters:

element - the element

Returns:

association value (possibly empty, but never null)

getAssociationState

public static java.lang.String getAssociationState(org.w3c.dom.Element element)

Get the value of the "state" attribute of the first <association> element found under the passed element.

Parameters:

element - the element

Returns:

association state (possibly empty, but never null)

getAssociationStateEx

public static java.lang.String getAssociationStateEx(com.novell.xml.dom.ElementImpl element)

Get the value of the "state" attribute of the first <association> element found under the passed element.

Parameters:

element - the element

Returns:

association state (possibly empty, but never null)

getFirstValue

public static org.w3c.dom.Element getFirstValue(org.w3c.dom.Node node,
                                                java.lang.String attrName)

Get the first <value> element for the passed directory attribute.

Parameters:

node - the node at which to start

attrName - the directory attribute name

Returns:

the first matching <value> element or null if no such element exists

getFirstValueEx

public static com.novell.xml.dom.ElementImpl getFirstValueEx(com.novell.xml.dom.NodeImpl node,
                                                             java.lang.String attrName)

Get the first <value> element for the passed directory attribute.

Parameters:

node - the node at which to start

attrName - the directory attribute name

Returns:

the first matching <value> element or null if no such element exists

copyAttributeNS

public static boolean copyAttributeNS(org.w3c.dom.Element src,
                                      java.lang.String attrNamespaceURI,
                                      java.lang.String attrLocalName,
                                      org.w3c.dom.Element dest)

Copy an attribute from one element to another, but only if the attribute has a non-empty value

Parameters:

src - source element

attrNamespaceURI - the namespace URI of the attribute's qualified name

attrLocalPart - the local part of the attribute's qualified name

dest - destination element

Returns:

true if an attribute was copied

copyAttributeEx

public static boolean copyAttributeEx(com.novell.xml.dom.ElementImpl src,
                                      com.novell.xml.util.ExpandedQName attrName,
                                      com.novell.xml.dom.ElementImpl dest)

Copy an attribute from one element to another, but only if the attribute has a non-empty value.

Parameters:

src - source element containing the attribute to copy

attrName - QName of the attribute

dest - destination element for the attribute

Returns:

true if an attribute was copied

copyAttributeNS

public static boolean copyAttributeNS(org.w3c.dom.Element src,
                                      java.lang.String srcAttrNamespaceURI,
                                      java.lang.String srcAttrLocalPart,
                                      org.w3c.dom.Element dest,
                                      java.lang.String destAttrNamespaceURI,
                                      java.lang.String destAttrQName)

Copy an attribute from one element to another, with an new attribute name, but only if the attribute has a non-empty value.

Parameters:

src - source element

srcAttrNamespaceURI - the namespace URI of the source attribute's qualified name

srcAttrLocalPart - the local part of the source attribute's qualified name

dest - destination element

destAttrNamespaceURI - the namespace URI of the destination attribute's qualified name

destAttrQName - "[prefix:]local part" of the destination attribute's qualified name

Returns:

true if an attribute was copied

copyAttributeEx

public static boolean copyAttributeEx(com.novell.xml.dom.ElementImpl src,
                                      com.novell.xml.util.ExpandedQName srcAttrName,
                                      com.novell.xml.dom.ElementImpl dest,
                                      com.novell.xml.util.ExpandedQName destAttrName)

Copy an attribute from one element to another, but only if the attribute has a non-empty value.

Parameters:

src - source element containing the attribute to copy

srcAttrName - QName of the source attribute

dest - destination element for the attribute

destAttrName - QName of the destination attribute

Returns:

true if there was an attribute to copy

ensureDOMImpl

public static void ensureDOMImpl(XmlDocument src)

Conditionally convert the passed document to the DirXML DOM implementation.

Parameters:

src - document

getTimestamp

public static java.util.Date getTimestamp(org.w3c.dom.Element element)

Get a Date instance from the timestamp attribute for an element

Parameters:

element - the element containing the "timestamp" attribute

Returns:

timestamp if available, null otherwise

getTimestampEx

public static java.util.Date getTimestampEx(com.novell.xml.dom.ElementImpl element)

Get a Date instance from the timestamp attribute for an element

Parameters:

element - the element containing the "timestamp" attribute

Returns:

timestamp if available, null otherwise

getTimestampEventCount

public static int getTimestampEventCount(org.w3c.dom.Element element)

Get the timestamp event count from the timestamp attribute for an element

Parameters:

element - an element containing the "timestamp" attribute

Returns:

timestamp event count if available, 0 otherwise

getTimestampEventCountEx

public static int getTimestampEventCountEx(com.novell.xml.dom.ElementImpl element)

Get the timestamp event count from the timestamp attribute for an element

Parameters:

element - an element containing the "timestamp" attribute

Returns:

timestamp event count if available, 0 otherwise