org.jboss.ws.api.util

Class DOMUtils

java.lang.Object

org.jboss.ws.api.util.DOMUtils

public abstract class DOMUtils
extends java.lang.Object

Basic DOM2 utilities

Constructor Summary

Constructors

Constructor and Description
DOMUtils()

Method Summary

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

Get the qname of the given node.

Parameters:

el - node

Returns:

Qname

resolveQName

public static javax.xml.namespace.QName resolveQName(org.w3c.dom.Element el,
                                                     java.lang.String qualifiedName)

Transform the given qualified name into a QName

Parameters:

el - node

qualifiedName - qualified name

Returns:

QName

getAttributeValue

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

Get the value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

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

getAttributeValue

public static java.lang.String getAttributeValue(org.w3c.dom.Element el,
                                                 javax.xml.namespace.QName attrName)

Get the value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

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

getAttributeValueAsQName

public static javax.xml.namespace.QName getAttributeValueAsQName(org.w3c.dom.Element el,
                                                                 java.lang.String attrName)

Get the qname value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

QName

getAttributeValueAsQName

public static javax.xml.namespace.QName getAttributeValueAsQName(org.w3c.dom.Element el,
                                                                 javax.xml.namespace.QName attrName)

Get the qname value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

QName

getAttributeValueAsBoolean

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

Get the boolean value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

boolean

getAttributeValueAsBoolean

public static boolean getAttributeValueAsBoolean(org.w3c.dom.Element el,
                                                 javax.xml.namespace.QName attrName)

Get the boolean value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

boolean

getAttributeValueAsInteger

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

Get the integer value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

Integer

getAttributeValueAsInteger

public static java.lang.Integer getAttributeValueAsInteger(org.w3c.dom.Element el,
                                                           javax.xml.namespace.QName attrName)

Get the integer value from the given attribute

Parameters:

el - element

attrName - attribute name

Returns:

Integer

getAttributes

public static java.util.Map<javax.xml.namespace.QName,java.lang.String> getAttributes(org.w3c.dom.Element el)

Get the attributes as Map<QName, String>

Parameters:

el - element

Returns:

Map

copyAttributes

public static void copyAttributes(org.w3c.dom.Element destElement,
                                  org.w3c.dom.Element srcElement)

Copy attributes between elements

Parameters:

destElement - element

srcElement - element

hasTextChildNodesOnly

public static boolean hasTextChildNodesOnly(org.w3c.dom.Node node)

True if the node has text child elements only

Parameters:

node - start node

Returns:

True if the node has text child

hasChildElements

public static boolean hasChildElements(org.w3c.dom.Node node)

True if the node has child elements

Parameters:

node - start node

Returns:

true when child has elements

getChildElements

public static java.util.Iterator<org.w3c.dom.Element> getChildElements(org.w3c.dom.Node node)

Gets child elements

Parameters:

node - start node

Returns:

Iterator

getTextContent

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

Get the concatenated text content, or null.

Parameters:

node - node

Returns:

string

getFirstChildElement

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

Gets the first child element

Parameters:

node - start node

Returns:

element

getFirstChildElement

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

Gets the first child element

Parameters:

node - child

recursive - recurse flag

Returns:

element

getFirstChildElement

public static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Node node,
                                                       java.lang.String nodeName)

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

Parameters:

node - child

nodeName - name

Returns:

element

getFirstChildElement

public static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Node node,
                                                       java.lang.String nodeName,
                                                       boolean recursive)

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

Parameters:

node - child

nodeName - name

recursive - recurse flag

Returns:

element

getFirstChildElement

public static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Node node,
                                                       javax.xml.namespace.QName nodeName)

Gets the first child element for a given qname

Parameters:

node - child

nodeName - name

Returns:

element

getFirstChildElement

public static org.w3c.dom.Element getFirstChildElement(org.w3c.dom.Node node,
                                                       javax.xml.namespace.QName nodeName,
                                                       boolean recursive)

Gets the first child element for a given qname

Parameters:

node - child

nodeName - name

recursive - recurse flag

Returns:

element

getFirstChildElementIntern

private static org.w3c.dom.Element getFirstChildElementIntern(org.w3c.dom.Node node,
                                                              javax.xml.namespace.QName nodeName,
                                                              boolean recursive)

getChildElements

public static java.util.Iterator<org.w3c.dom.Element> getChildElements(org.w3c.dom.Node node,
                                                                       java.lang.String nodeName)

Gets the child elements for a given local name without namespace

Parameters:

node - child

nodeName - name

Returns:

Iterator

getChildElements

public static java.util.Iterator<org.w3c.dom.Element> getChildElements(org.w3c.dom.Node node,
                                                                       java.lang.String nodeName,
                                                                       boolean recursive)

Gets the child elements for a given local name without namespace

Parameters:

node - child

nodeName - name

recursive - recurse flag

Returns:

Iterator

getChildElements

public static java.util.Iterator<org.w3c.dom.Element> getChildElements(org.w3c.dom.Node node,
                                                                       javax.xml.namespace.QName nodeName)

Gets the child element for a given qname

Parameters:

node - child

nodeName - name

Returns:

Iterator

getChildElements

public static java.util.Iterator<org.w3c.dom.Element> getChildElements(org.w3c.dom.Node node,
                                                                       javax.xml.namespace.QName nodeName,
                                                                       boolean recursive)

Gets the child element for a given qname

Parameters:

node - child

nodeName - name

recursive - recurse flag

Returns:

Iterator

getChildElementsAsList

public static java.util.List<org.w3c.dom.Element> getChildElementsAsList(org.w3c.dom.Node node,
                                                                         java.lang.String nodeName)

getChildElementsAsList

public static java.util.List<org.w3c.dom.Element> getChildElementsAsList(org.w3c.dom.Node node,
                                                                         java.lang.String nodeName,
                                                                         boolean recursive)

getChildElementsAsList

public static java.util.List<org.w3c.dom.Element> getChildElementsAsList(org.w3c.dom.Node node,
                                                                         javax.xml.namespace.QName nodeName)

getChildElementsAsList

public static java.util.List<org.w3c.dom.Element> getChildElementsAsList(org.w3c.dom.Node node,
                                                                         javax.xml.namespace.QName nodeName,
                                                                         boolean recursive)

getChildElementsAsListIntern

private static java.util.List<org.w3c.dom.Element> getChildElementsAsListIntern(org.w3c.dom.Node node,
                                                                                javax.xml.namespace.QName nodeName,
                                                                                boolean recursive)

search

private static void search(java.util.List<org.w3c.dom.Element> list,
                           org.w3c.dom.Element baseElement,
                           javax.xml.namespace.QName nodeName,
                           boolean recursive)

getChildElementsIntern

private static java.util.Iterator<org.w3c.dom.Element> getChildElementsIntern(org.w3c.dom.Node node,
                                                                              javax.xml.namespace.QName nodeName,
                                                                              boolean recursive)

getParentElement

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

Gets parent element or null if there is none

Parameters:

node - child

Returns:

element

sourceToElement

public static org.w3c.dom.Element sourceToElement(javax.xml.transform.Source source,
                                                  javax.xml.parsers.DocumentBuilder builder)
                                           throws java.io.IOException

Throws:

java.io.IOException

parse

public static org.w3c.dom.Element parse(java.lang.String xmlString,
                                        javax.xml.parsers.DocumentBuilder builder)
                                 throws java.io.IOException

Parse the given XML string and return the root Element

Parameters:

xmlString - string to be parsed

builder - document builder

Returns:

element

Throws:

java.io.IOException - exception

parse

public static org.w3c.dom.Element parse(java.io.InputStream xmlStream,
                                        javax.xml.parsers.DocumentBuilder builder)
                                 throws java.io.IOException

Parse the given XML stream and return the root Element

Parameters:

xmlStream - input stream

builder - document builder

Returns:

element

Throws:

java.io.IOException - exception

parse

public static org.w3c.dom.Element parse(org.xml.sax.InputSource source,
                                        javax.xml.parsers.DocumentBuilder builder)
                                 throws java.io.IOException

Parse the given input source and return the root Element

Parameters:

source - input source

builder - document builder

Returns:

element

Throws:

java.io.IOException - exception

createElement

public static org.w3c.dom.Element createElement(java.lang.String localPart,
                                                java.lang.String prefix,
                                                java.lang.String uri,
                                                org.w3c.dom.Document doc)

Create an Element for a given name, prefix and uri

Parameters:

localPart - xml local part

prefix - xml prefix

uri - uri

doc - document

Returns:

element