org.apache.woden.internal.util.dom
Class DOMUtils

java.lang.Object
  org.apache.woden.internal.util.dom.DOMUtils

public class DOMUtils
extends java.lang.Object

This class originated from WSDL4J.

Author:

jkaputin@apache.org (Woden changes)

Constructor Summary

DOMUtils()

Method Summary

static int	countKids(org.w3c.dom.Element elem, short nodeType) Count number of children of a certain type of the given element.
static org.w3c.dom.Element	findChildElementWithAttribute(org.w3c.dom.Element elem, java.lang.String attrName, java.lang.String attrValue) Return the first child element of the given element which has the given attribute with the given value.
static java.lang.String	getAttribute(org.w3c.dom.Element el, java.lang.String attrName) Returns the value of an attribute of an element.
static java.lang.String	getAttribute(org.w3c.dom.Element el, java.lang.String attrName, java.util.List remainingAttrs) Returns the value of an attribute of an element.
static java.lang.String	getAttributeNS(org.w3c.dom.Element el, java.lang.String namespaceURI, java.lang.String localPart) Returns the value of an attribute of an element.
static java.util.List	getAttributes(org.w3c.dom.Element el) Returns a list of attributes of an element.
static java.lang.String	getChildCharacterData(org.w3c.dom.Element parentEl) Concat all the text and cdata node children of this elem and return the resulting text.
static org.w3c.dom.Element	getFirstChildElement(org.w3c.dom.Element elem) Return the first child element of the given element.
static org.w3c.dom.Element	getNextSiblingElement(org.w3c.dom.Element elem) Return the next sibling element of the given element.
static void	throwWSDLException(org.w3c.dom.Element location)
static void	throwWSDLException(org.w3c.dom.Element location, java.util.List remainingAttrs)

Methods inherited from class java.lang.Object

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

Constructor Detail

DOMUtils

public DOMUtils()

Method Detail

getAttributes

public static java.util.List getAttributes(org.w3c.dom.Element el)

Returns a list of attributes of an element. Returns an empty list if the element has no attributes. Does not include namespace declarations.

Parameters:

el - Element whose attributes are returned

Returns:

the List of Attr

getAttribute

public static java.lang.String getAttribute(org.w3c.dom.Element el,
                                            java.lang.String attrName)

Returns the value of an attribute of an element. Returns null if the attribute is not found (whereas Element.getAttribute returns "" if an attrib is not found). This method should be used for elements that support extension attributes because it does not track unexpected attributes.

Parameters:

el - Element whose attrib is looked for

attrName - name of attribute to look for

Returns:

the attribute value including prefix if present

getAttribute

public static java.lang.String getAttribute(org.w3c.dom.Element el,
                                            java.lang.String attrName,
                                            java.util.List remainingAttrs)

Returns the value of an attribute of an element. Returns null if the attribute is not found (whereas Element.getAttribute returns "" if an attrib is not found). This method should be used for elements that do not support extension attributes because it tracks the element's remaining attributes so that eventually any unexpected attributes can be identified.

Parameters:

el - Element whose attrib is looked for

attrName - name of attribute to look for

remainingAttrs - List of remaining attributes

Returns:

the attribute value

getAttributeNS

public static java.lang.String getAttributeNS(org.w3c.dom.Element el,
                                              java.lang.String namespaceURI,
                                              java.lang.String localPart)

Returns the value of an attribute of an element. Returns null if the attribute is not found (whereas Element.getAttributeNS returns "" if an attrib is not found).

Parameters:

el - Element whose attrib is looked for

namespaceURI - namespace URI of attribute to look for

localPart - local part of attribute to look for

Returns:

the attribute value

getChildCharacterData

public static java.lang.String getChildCharacterData(org.w3c.dom.Element parentEl)

Concat all the text and cdata node children of this elem and return the resulting text.

Parameters:

parentEl - the element whose cdata/text node values are to be combined.

Returns:

the concatanated string.

getFirstChildElement

public static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Element elem)

Return the first child element of the given element. Null if no children are found.

Parameters:

elem - Element whose child is to be returned

Returns:

the first child element.

getNextSiblingElement

public static org.w3c.dom.Element getNextSiblingElement(org.w3c.dom.Element elem)

Return the next sibling element of the given element. Null if no more sibling elements are found.

Parameters:

elem - Element whose sibling element is to be returned

Returns:

the next sibling element.

findChildElementWithAttribute

public static org.w3c.dom.Element findChildElementWithAttribute(org.w3c.dom.Element elem,
                                                                java.lang.String attrName,
                                                                java.lang.String attrValue)

Return the first child element of the given element which has the given attribute with the given value.

Parameters:

elem - the element whose children are to be searched

attrName - the attrib that must be present

attrValue - the desired value of the attribute

Returns:

the first matching child element.

countKids

public static int countKids(org.w3c.dom.Element elem,
                            short nodeType)

Count number of children of a certain type of the given element.

Parameters:

elem - the element whose kids are to be counted

Returns:

the number of matching kids.

throwWSDLException

public static void throwWSDLException(org.w3c.dom.Element location)
                               throws WSDLException

Throws:

WSDLException

throwWSDLException

public static void throwWSDLException(org.w3c.dom.Element location,
                                      java.util.List remainingAttrs)
                               throws WSDLException

Throws:

WSDLException