Apache SOAP API Reference

org.apache.soap.util.xml
Class DOMUtils

java.lang.Object
  |
  +--org.apache.soap.util.xml.DOMUtils

public class DOMUtils
extends java.lang.Object
Author:
Matthew J. Duftler, Sanjiva Weerawarana

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 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.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 getElementByID(org.w3c.dom.Element el, java.lang.String id)
           
static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Element elem)
          Return the first child element of the given element.
static java.lang.String getNamespaceURIFromPrefix(org.w3c.dom.Node context, java.lang.String prefix)
          Given a prefix and a node, return the namespace URI that the prefix has been associated with.
static org.w3c.dom.Element getNextSiblingElement(org.w3c.dom.Element elem)
          Return the next sibling element of the given element.
static QName getQualifiedAttributeValue(org.w3c.dom.Element el, java.lang.String attrName)
           

 

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

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).
Parameters:
el - Element whose attrib is looked for
attrName - name of attribute to look for
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.

getNamespaceURIFromPrefix

public static java.lang.String getNamespaceURIFromPrefix(org.w3c.dom.Node context,
                                                         java.lang.String prefix)
Given a prefix and a node, return the namespace URI that the prefix has been associated with. This method is useful in resolving the namespace URI of attribute values which are being interpreted as QNames. If prefix is null, this method will return the default namespace.
Parameters:
context - the starting node (looks up recursively from here)
prefix - the prefix to find an xmlns:prefix=uri for
Returns:
the namespace URI or null if not found

getElementByID

public static org.w3c.dom.Element getElementByID(org.w3c.dom.Element el,
                                                 java.lang.String id)

getQualifiedAttributeValue

public static QName getQualifiedAttributeValue(org.w3c.dom.Element el,
                                               java.lang.String attrName)
                                        throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException

Apache SOAP API Reference

Copyright © 2001 Apache XML Project. All Rights Reserved.