com.helger.xml

Class XMLHelper

java.lang.Object

com.helger.xml.XMLHelper

@Immutable
public final class XMLHelper
extends Object

This class contains multiple XML utility methods.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
static void	append(Node aParentNode, Collection<?> aNodesToAppend)
static Node	append(Node aParentNode, Object aChild)
static com.helger.commons.filter.IFilter<Element>	filterElementWithNamespace()
static com.helger.commons.filter.IFilter<Element>	filterElementWithNamespace(String sNamespaceURI)
static com.helger.commons.filter.IFilter<Element>	filterElementWithNamespaceAndLocalName(String sNamespaceURI, String sLocalName)
static com.helger.commons.filter.IFilter<Element>	filterElementWithoutNamespace()
static com.helger.commons.filter.IFilter<Element>	filterElementWithTagName(String sTagName)
static com.helger.commons.filter.IFilter<Element>	filterElementWithTagNameNoNS(String sTagName)
static com.helger.commons.filter.IFilter<Node>	filterNodeIsElement()
static void	forAllAttributes(Element aSrcNode, BiConsumer<String,String> aConsumer)
static void	forAllAttributes(Element aSrcNode, Consumer<Attr> aConsumer)
static com.helger.commons.collection.ext.ICommonsList<Attr>	getAllAttributesAsList(Element aSrcNode)
static com.helger.commons.collection.ext.ICommonsOrderedMap<String,String>	getAllAttributesAsMap(Element aSrcNode)
static String	getAttributeValue(Element aElement, String sAttrName) The latest version of XercesJ 2.9 returns an empty string for non existing attributes.
static String	getAttributeValue(Element aElement, String sAttrName, String sDefault) The latest version of XercesJ 2.9 returns an empty string for non existing attributes.
static String	getAttributeValueNS(Element aElement, String sNamespaceURI, String sAttrName) The latest version of XercesJ 2.9 returns an empty string for non existing attributes.
static String	getAttributeValueNS(Element aElement, String sNamespaceURI, String sAttrName, String sDefault) The latest version of XercesJ 2.9 returns an empty string for non existing attributes.
static com.helger.commons.collection.iterate.IIterableIterator<Element>	getChildElementIterator(Node aStartNode) Get an iterator over all child elements.
static com.helger.commons.collection.iterate.IIterableIterator<Element>	getChildElementIterator(Node aStartNode, String sTagName) Get an iterator over all child elements that have the desired tag name (but potentially a namespace URI).
static com.helger.commons.collection.iterate.IIterableIterator<Element>	getChildElementIteratorNoNS(Node aStartNode) Get an iterator over all child elements that have no namespace.
static com.helger.commons.collection.iterate.IIterableIterator<Element>	getChildElementIteratorNoNS(Node aStartNode, String sTagName) Get an iterator over all child elements that have no namespace and the desired tag name.
static com.helger.commons.collection.iterate.IIterableIterator<Element>	getChildElementIteratorNS(Node aStartNode, String sNamespaceURI)
static com.helger.commons.collection.iterate.IIterableIterator<Element>	getChildElementIteratorNS(Node aStartNode, String sNamespaceURI, String sLocalName)
static int	getDirectChildElementCount(Element aParent)
static int	getDirectChildElementCount(Element aParent, String sTagName)
static int	getDirectChildElementCountNoNS(Element aParent)
static int	getDirectChildElementCountNoNS(Element aParent, String sTagName)
static int	getDirectChildElementCountNS(Element aParent, String sNamespaceURI)
static int	getDirectChildElementCountNS(Element aParent, String sNamespaceURI, String sLocalName)
static Element	getDocumentElement(Node aNode)
static String	getElementName(Node aNode)
static Element	getFirstChildElement(Node aStartNode) Get the first direct child element of the passed element.
static Element	getFirstChildElementOfName(Node aStartNode, String sTagName) Search all child nodes of the given for the first element that has the specified tag name.
static Element	getFirstChildElementOfName(Node aStartNode, String sNamespaceURI, String sLocalName) Search all child nodes of the given for the first element that has the specified tag name.
static String	getFirstChildText(Node aStartNode) Get the content of the first Text child element of the passed element.
static int	getLength(NodeList aNL)
static String	getNamespaceURI(Node aNode)
static Document	getOwnerDocument(Node aNode) Get the owner document of the passed node.
static String	getPathToNode(Node aNode) Shortcut for getPathToNode(Node, String) using "/" as the separator.
static String	getPathToNode(Node aNode, String sSep) Get the path from root node to the passed node.
static String	getPathToNode2(Node aNode) Shortcut for getPathToNode2(Node,String) using "/" as the separator.
static String	getPathToNode2(Node aNode, String sSep) Get the path from root node to the passed node.
static QName	getXMLNSAttrQName(String sNSPrefix) Get the full qualified attribute name to use for the given namespace prefix.
static boolean	hasChildElementNodes(Node aStartNode) Check if the passed node has at least one direct child element or not.
static boolean	hasNamespaceURI(Node aNode, String sNamespaceURI)
static boolean	hasNoNamespaceURI(Node aNode)
static boolean	isEmpty(NodeList aNL)
static boolean	isInlineNode(Node aNode) Check if the passed node is a text node.
static void	removeAllChildElements(Element aElement) Remove all child nodes of the given node.

Methods inherited from class java.lang.Object

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

Method Detail

getOwnerDocument

@Nullable
public static Document getOwnerDocument(@Nullable
                                                   Node aNode)

Get the owner document of the passed node. If the node itself is a document, only a cast is performed.

Parameters:

aNode - The node to get the document from. May be null.

Returns:

null if the passed node was null.

getDocumentElement

@Nullable
public static Element getDocumentElement(@Nullable
                                                    Node aNode)

getNamespaceURI

@Nullable
public static String getNamespaceURI(@Nullable
                                                Node aNode)

getElementName

@Nullable
public static String getElementName(@Nullable
                                               Node aNode)

hasNoNamespaceURI

public static boolean hasNoNamespaceURI(@Nonnull
                                        Node aNode)

hasNamespaceURI

public static boolean hasNamespaceURI(@Nullable
                                      Node aNode,
                                      @Nullable
                                      String sNamespaceURI)

isInlineNode

public static boolean isInlineNode(@Nullable
                                   Node aNode)

Check if the passed node is a text node. This includes all nodes derived from Text (Text and CData) or EntityReference nodes.

Parameters:

aNode - The node to be checked.

Returns:

true if the passed node is a text node, false otherwise.

getLength

@Nonnegative
public static int getLength(@Nullable
                                          NodeList aNL)

isEmpty

public static boolean isEmpty(@Nullable
                              NodeList aNL)

filterNodeIsElement

@Nonnull
public static com.helger.commons.filter.IFilter<Node> filterNodeIsElement()

filterElementWithNamespace

@Nonnull
public static com.helger.commons.filter.IFilter<Element> filterElementWithNamespace()

filterElementWithoutNamespace

@Nonnull
public static com.helger.commons.filter.IFilter<Element> filterElementWithoutNamespace()

filterElementWithNamespace

@Nonnull
public static com.helger.commons.filter.IFilter<Element> filterElementWithNamespace(@Nullable
                                                                                              String sNamespaceURI)

filterElementWithNamespaceAndLocalName

@Nonnull
public static com.helger.commons.filter.IFilter<Element> filterElementWithNamespaceAndLocalName(@Nullable
                                                                                                          String sNamespaceURI,
                                                                                                          @Nonnull @Nonempty
                                                                                                          String sLocalName)

filterElementWithTagName

@Nonnull
public static com.helger.commons.filter.IFilter<Element> filterElementWithTagName(@Nonnull @Nonempty
                                                                                            String sTagName)

filterElementWithTagNameNoNS

@Nonnull
public static com.helger.commons.filter.IFilter<Element> filterElementWithTagNameNoNS(@Nonnull @Nonempty
                                                                                                String sTagName)

getFirstChildElement

@Nullable
public static Element getFirstChildElement(@Nonnull
                                                      Node aStartNode)

Get the first direct child element of the passed element.

Parameters:

aStartNode - The element to start searching.

Returns:

null if the passed element does not have any direct child element.

hasChildElementNodes

public static boolean hasChildElementNodes(@Nonnull
                                           Node aStartNode)

Check if the passed node has at least one direct child element or not.

Parameters:

aStartNode - The parent element to be searched. May not be null.

Returns:

true if the passed node has at least one child element, false otherwise.

getFirstChildElementOfName

@Nullable
public static Element getFirstChildElementOfName(@Nonnull
                                                            Node aStartNode,
                                                            @Nullable
                                                            String sTagName)

Search all child nodes of the given for the first element that has the specified tag name.

Parameters:

aStartNode - The parent element to be searched. May not be null.

sTagName - The tag name to search.

Returns:

null if the parent element has no such child element.

getFirstChildElementOfName

@Nullable
public static Element getFirstChildElementOfName(@Nonnull
                                                            Node aStartNode,
                                                            @Nullable
                                                            String sNamespaceURI,
                                                            @Nullable
                                                            String sLocalName)

Search all child nodes of the given for the first element that has the specified tag name.

Parameters:

aStartNode - The parent element to be searched. May not be null.

sNamespaceURI - Namespace URI to search. May be null.

sLocalName - The tag name to search.

Returns:

null if the parent element has no such child element.

append

@Nonnull
public static Node append(@Nonnull
                                    Node aParentNode,
                                    @Nullable
                                    Object aChild)

append

public static void append(@Nonnull
                          Node aParentNode,
                          @Nonnull
                          Collection<?> aNodesToAppend)

getDirectChildElementCount

@Nonnegative
public static int getDirectChildElementCount(@Nullable
                                                           Element aParent)

getDirectChildElementCountNoNS

@Nonnegative
public static int getDirectChildElementCountNoNS(@Nullable
                                                               Element aParent)

getDirectChildElementCount

@Nonnegative
public static int getDirectChildElementCount(@Nullable
                                                           Element aParent,
                                                           @Nonnull @Nonempty
                                                           String sTagName)

getDirectChildElementCountNoNS

@Nonnegative
public static int getDirectChildElementCountNoNS(@Nullable
                                                               Element aParent,
                                                               @Nonnull @Nonempty
                                                               String sTagName)

getDirectChildElementCountNS

@Nonnegative
public static int getDirectChildElementCountNS(@Nullable
                                                             Element aParent,
                                                             @Nullable
                                                             String sNamespaceURI)

getDirectChildElementCountNS

@Nonnegative
public static int getDirectChildElementCountNS(@Nullable
                                                             Element aParent,
                                                             @Nullable
                                                             String sNamespaceURI,
                                                             @Nonnull @Nonempty
                                                             String sLocalName)

getChildElementIterator

@Nonnull
public static com.helger.commons.collection.iterate.IIterableIterator<Element> getChildElementIterator(@Nullable
                                                                                                                 Node aStartNode)

Get an iterator over all child elements.

Parameters:

aStartNode - the parent element

Returns:

a non-null Iterator

getChildElementIteratorNoNS

@Nonnull
public static com.helger.commons.collection.iterate.IIterableIterator<Element> getChildElementIteratorNoNS(@Nullable
                                                                                                                     Node aStartNode)

Get an iterator over all child elements that have no namespace.

Parameters:

aStartNode - the parent element

Returns:

a non-null Iterator

getChildElementIteratorNoNS

@Nonnull
public static com.helger.commons.collection.iterate.IIterableIterator<Element> getChildElementIteratorNoNS(@Nullable
                                                                                                                     Node aStartNode,
                                                                                                                     @Nonnull @Nonempty
                                                                                                                     String sTagName)

Get an iterator over all child elements that have no namespace and the desired tag name.

Parameters:

aStartNode - the parent element

sTagName - the name of the tag that is desired

Returns:

a non-null Iterator

Throws:

IllegalArgumentException - if the passed tag name is null or empty

getChildElementIterator

@Nonnull
public static com.helger.commons.collection.iterate.IIterableIterator<Element> getChildElementIterator(@Nullable
                                                                                                                 Node aStartNode,
                                                                                                                 @Nonnull @Nonempty
                                                                                                                 String sTagName)

Get an iterator over all child elements that have the desired tag name (but potentially a namespace URI).

Parameters:

aStartNode - the parent element

sTagName - the name of the tag that is desired

Returns:

a non-null Iterator

Throws:

IllegalArgumentException - if the passed tag name is null or empty

getChildElementIteratorNS

@Nonnull
public static com.helger.commons.collection.iterate.IIterableIterator<Element> getChildElementIteratorNS(@Nullable
                                                                                                                   Node aStartNode,
                                                                                                                   @Nullable
                                                                                                                   String sNamespaceURI)

getChildElementIteratorNS

@Nonnull
public static com.helger.commons.collection.iterate.IIterableIterator<Element> getChildElementIteratorNS(@Nullable
                                                                                                                   Node aStartNode,
                                                                                                                   @Nullable
                                                                                                                   String sNamespaceURI,
                                                                                                                   @Nonnull @Nonempty
                                                                                                                   String sLocalName)

getPathToNode

@Nonnull
public static String getPathToNode(@Nonnull
                                             Node aNode)

Shortcut for getPathToNode(Node, String) using "/" as the separator.

Parameters:

aNode - The node to check.

Returns:

A non-null path.

getPathToNode

@Nonnull
public static String getPathToNode(@Nonnull
                                             Node aNode,
                                             @Nonnull
                                             String sSep)

Get the path from root node to the passed node. This includes all nodes up to the document node!

Parameters:

aNode - The node to start. May not be null.

sSep - The separator string to use. May not be null.

Returns:

The path to the node.

getPathToNode2

@Nonnull
public static String getPathToNode2(@Nonnull
                                              Node aNode)

Shortcut for getPathToNode2(Node,String) using "/" as the separator.

Parameters:

aNode - The node to check.

Returns:

A non-null path.

getPathToNode2

@Nonnull
public static String getPathToNode2(@Nonnull
                                              Node aNode,
                                              @Nonnull
                                              String sSep)

Get the path from root node to the passed node. This includes all nodes but excluding the document node!

Parameters:

aNode - The node to start. May not be null.

sSep - The separator string to use. May not be null.

Returns:

The path to the node.

removeAllChildElements

public static void removeAllChildElements(@Nonnull
                                          Element aElement)

Remove all child nodes of the given node.

Parameters:

aElement - The element whose children are to be removed.

getFirstChildText

@Nullable
public static String getFirstChildText(@Nullable
                                                  Node aStartNode)

Get the content of the first Text child element of the passed element.

Parameters:

aStartNode - the element to scan for a TextNode child

Returns:

null if the element contains no text node as child

getAttributeValue

@Nullable
public static String getAttributeValue(@Nonnull
                                                  Element aElement,
                                                  @Nonnull
                                                  String sAttrName)

The latest version of XercesJ 2.9 returns an empty string for non existing attributes. To differentiate between empty attributes and non-existing attributes, this method returns null for non existing attributes.

Parameters:

aElement - the source element to get the attribute from

sAttrName - the name of the attribute to query

Returns:

null if the attribute does not exists, the string value otherwise

getAttributeValue

@Nullable
public static String getAttributeValue(@Nonnull
                                                  Element aElement,
                                                  @Nonnull
                                                  String sAttrName,
                                                  @Nullable
                                                  String sDefault)

The latest version of XercesJ 2.9 returns an empty string for non existing attributes. To differentiate between empty attributes and non-existing attributes, this method returns a default value for non existing attributes.

Parameters:

aElement - the source element to get the attribute from. May not be null.

sAttrName - the name of the attribute to query. May not be null.

sDefault - the value to be returned if the attribute is not present.

Returns:

the default value if the attribute does not exists, the string value otherwise

getAttributeValueNS

@Nullable
public static String getAttributeValueNS(@Nonnull
                                                    Element aElement,
                                                    @Nullable
                                                    String sNamespaceURI,
                                                    @Nonnull
                                                    String sAttrName)

The latest version of XercesJ 2.9 returns an empty string for non existing attributes. To differentiate between empty attributes and non-existing attributes, this method returns null for non existing attributes.

Parameters:

aElement - the source element to get the attribute from

sNamespaceURI - The namespace URI of the attribute to retrieve. May be null.

sAttrName - the name of the attribute to query

Returns:

null if the attribute does not exists, the string value otherwise

getAttributeValueNS

@Nullable
public static String getAttributeValueNS(@Nonnull
                                                    Element aElement,
                                                    @Nullable
                                                    String sNamespaceURI,
                                                    @Nonnull
                                                    String sAttrName,
                                                    @Nullable
                                                    String sDefault)

The latest version of XercesJ 2.9 returns an empty string for non existing attributes. To differentiate between empty attributes and non-existing attributes, this method returns a default value for non existing attributes.

Parameters:

aElement - the source element to get the attribute from. May not be null.

sNamespaceURI - The namespace URI of the attribute to retrieve. May be null.

sAttrName - the name of the attribute to query. May not be null.

sDefault - the value to be returned if the attribute is not present.

Returns:

the default value if the attribute does not exists, the string value otherwise

getAllAttributesAsList

@Nonnull
 @ReturnsMutableCopy
public static com.helger.commons.collection.ext.ICommonsList<Attr> getAllAttributesAsList(@Nullable
                                                                                                                          Element aSrcNode)

getAllAttributesAsMap

@Nonnull
 @ReturnsMutableCopy
public static com.helger.commons.collection.ext.ICommonsOrderedMap<String,String> getAllAttributesAsMap(@Nullable
                                                                                                                                        Element aSrcNode)

forAllAttributes

public static void forAllAttributes(@Nullable
                                    Element aSrcNode,
                                    @Nonnull
                                    Consumer<Attr> aConsumer)

forAllAttributes

public static void forAllAttributes(@Nullable
                                    Element aSrcNode,
                                    @Nonnull
                                    BiConsumer<String,String> aConsumer)

getXMLNSAttrQName

@Nonnull
public static QName getXMLNSAttrQName(@Nullable
                                                String sNSPrefix)

Get the full qualified attribute name to use for the given namespace prefix. The result will e.g. be xmlns or {http://www.w3.org/2000/xmlns/}xmlns:foo.

Parameters:

sNSPrefix - The namespace prefix to build the attribute name from. May be null or empty.

Returns:

If the namespace prefix is empty (if it equals XMLConstants.DEFAULT_NS_PREFIX or null) than "xmlns" is returned, else "xmlns:prefix" is returned.