org.jboss.ws.api.util

Class DOMUtils

java.lang.Object

org.jboss.ws.api.util.DOMUtils

public abstract class DOMUtils
extends Object

Basic DOM2 utilities

Author:

Alessio Soldano, Thomas Diesler

Constructor Summary

Constructors

Constructor and Description
DOMUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static void	copyAttributes(Element destElement, Element srcElement) Copy attributes between elements
static Element	createElement(String localPart, String prefix, String uri, Document doc) Create an Element for a given name, prefix and uri
static Map<QName,String>	getAttributes(Element el) Get the attributes as Map
static String	getAttributeValue(Element el, QName attrName) Get the value from the given attribute
static String	getAttributeValue(Element el, String attrName) Get the value from the given attribute
static boolean	getAttributeValueAsBoolean(Element el, QName attrName) Get the boolean value from the given attribute
static boolean	getAttributeValueAsBoolean(Element el, String attrName) Get the boolean value from the given attribute
static Integer	getAttributeValueAsInteger(Element el, QName attrName) Get the integer value from the given attribute
static Integer	getAttributeValueAsInteger(Element el, String attrName) Get the integer value from the given attribute
static QName	getAttributeValueAsQName(Element el, QName attrName) Get the qname value from the given attribute
static QName	getAttributeValueAsQName(Element el, String attrName) Get the qname value from the given attribute
static Iterator<Element>	getChildElements(Node node) Gets child elements
static Iterator<Element>	getChildElements(Node node, QName nodeName) Gets the child element for a given qname
static Iterator<Element>	getChildElements(Node node, QName nodeName, boolean recursive) Gets the child element for a given qname
static Iterator<Element>	getChildElements(Node node, String nodeName) Gets the child elements for a given local name without namespace
static Iterator<Element>	getChildElements(Node node, String nodeName, boolean recursive) Gets the child elements for a given local name without namespace
static List<Element>	getChildElementsAsList(Node node, QName nodeName)
static List<Element>	getChildElementsAsList(Node node, QName nodeName, boolean recursive)
static List<Element>	getChildElementsAsList(Node node, String nodeName)
static List<Element>	getChildElementsAsList(Node node, String nodeName, boolean recursive)
static QName	getElementQName(Element el) Get the qname of the given node.
static Element	getFirstChildElement(Node node) Gets the first child element
static Element	getFirstChildElement(Node node, boolean recursive) Gets the first child element
static Element	getFirstChildElement(Node node, QName nodeName) Gets the first child element for a given qname
static Element	getFirstChildElement(Node node, QName nodeName, boolean recursive) Gets the first child element for a given qname
static Element	getFirstChildElement(Node node, String nodeName) Gets the first child element for a given local name without namespace
static Element	getFirstChildElement(Node node, String nodeName, boolean recursive) Gets the first child element for a given local name without namespace
static Element	getParentElement(Node node) Gets parent element or null if there is none
static String	getTextContent(Node node) Get the concatenated text content, or null.
static boolean	hasChildElements(Node node) True if the node has child elements
static boolean	hasTextChildNodesOnly(Node node) True if the node has text child elements only
static Element	parse(InputSource source, DocumentBuilder builder) Parse the given input source and return the root Element
static Element	parse(InputStream xmlStream, DocumentBuilder builder) Parse the given XML stream and return the root Element
static Element	parse(String xmlString, DocumentBuilder builder) Parse the given XML string and return the root Element
static QName	resolveQName(Element el, String qualifiedName) Transform the given qualified name into a QName
static Element	sourceToElement(Source source, DocumentBuilder builder)

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

getElementQName

public static QName getElementQName(Element el)

Get the qname of the given node.

resolveQName

public static QName resolveQName(Element el,
                 String qualifiedName)

Transform the given qualified name into a QName

getAttributeValue

public static String getAttributeValue(Element el,
                       String attrName)

Get the value from the given attribute

Returns:

null if the attribute value is empty or the attribute is not present

getAttributeValue

public static String getAttributeValue(Element el,
                       QName attrName)

Get the value from the given attribute

Returns:

null if the attribute value is empty or the attribute is not present

getAttributeValueAsQName

public static QName getAttributeValueAsQName(Element el,
                             String attrName)

Get the qname value from the given attribute

getAttributeValueAsQName

public static QName getAttributeValueAsQName(Element el,
                             QName attrName)

Get the qname value from the given attribute

getAttributeValueAsBoolean

public static boolean getAttributeValueAsBoolean(Element el,
                                 String attrName)

Get the boolean value from the given attribute

getAttributeValueAsBoolean

public static boolean getAttributeValueAsBoolean(Element el,
                                 QName attrName)

Get the boolean value from the given attribute

getAttributeValueAsInteger

public static Integer getAttributeValueAsInteger(Element el,
                                 String attrName)

Get the integer value from the given attribute

getAttributeValueAsInteger

public static Integer getAttributeValueAsInteger(Element el,
                                 QName attrName)

Get the integer value from the given attribute

getAttributes

public static Map<QName,String> getAttributes(Element el)

Get the attributes as Map

copyAttributes

public static void copyAttributes(Element destElement,
                  Element srcElement)

Copy attributes between elements

hasTextChildNodesOnly

public static boolean hasTextChildNodesOnly(Node node)

True if the node has text child elements only

hasChildElements

public static boolean hasChildElements(Node node)

True if the node has child elements

getChildElements

public static Iterator<Element> getChildElements(Node node)

Gets child elements

getTextContent

public static String getTextContent(Node node)

Get the concatenated text content, or null.

getFirstChildElement

public static Element getFirstChildElement(Node node)

Gets the first child element

getFirstChildElement

public static Element getFirstChildElement(Node node,
                           boolean recursive)

Gets the first child element

getFirstChildElement

public static Element getFirstChildElement(Node node,
                           String nodeName)

Gets the first child element for a given local name without namespace

getFirstChildElement

public static Element getFirstChildElement(Node node,
                           String nodeName,
                           boolean recursive)

Gets the first child element for a given local name without namespace

getFirstChildElement

public static Element getFirstChildElement(Node node,
                           QName nodeName)

Gets the first child element for a given qname

getFirstChildElement

public static Element getFirstChildElement(Node node,
                           QName nodeName,
                           boolean recursive)

Gets the first child element for a given qname

getChildElements

public static Iterator<Element> getChildElements(Node node,
                                 String nodeName)

Gets the child elements for a given local name without namespace

getChildElements

public static Iterator<Element> getChildElements(Node node,
                                 String nodeName,
                                 boolean recursive)

Gets the child elements for a given local name without namespace

getChildElements

public static Iterator<Element> getChildElements(Node node,
                                 QName nodeName)

Gets the child element for a given qname

getChildElements

public static Iterator<Element> getChildElements(Node node,
                                 QName nodeName,
                                 boolean recursive)

Gets the child element for a given qname

getChildElementsAsList

public static List<Element> getChildElementsAsList(Node node,
                                   String nodeName)

getChildElementsAsList

public static List<Element> getChildElementsAsList(Node node,
                                   String nodeName,
                                   boolean recursive)

getChildElementsAsList

public static List<Element> getChildElementsAsList(Node node,
                                   QName nodeName)

getChildElementsAsList

public static List<Element> getChildElementsAsList(Node node,
                                   QName nodeName,
                                   boolean recursive)

getParentElement

public static Element getParentElement(Node node)

Gets parent element or null if there is none

sourceToElement

public static Element sourceToElement(Source source,
                      DocumentBuilder builder)
                               throws IOException

Throws:

IOException

parse

public static Element parse(String xmlString,
            DocumentBuilder builder)
                     throws IOException

Parse the given XML string and return the root Element

Throws:

IOException

parse

public static Element parse(InputStream xmlStream,
            DocumentBuilder builder)
                     throws IOException

Parse the given XML stream and return the root Element

Throws:

IOException

parse

public static Element parse(InputSource source,
            DocumentBuilder builder)
                     throws IOException

Parse the given input source and return the root Element

Throws:

IOException

createElement

public static Element createElement(String localPart,
                    String prefix,
                    String uri,
                    Document doc)

Create an Element for a given name, prefix and uri