Package org.freedesktop.dbus.utils

Class XmlUtil

java.lang.Object

org.freedesktop.dbus.utils.XmlUtil

public final class XmlUtil
extends java.lang.Object

Assorted static XML utility methods.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	XmlUtil()

Method Summary

Modifier and Type	Method	Description
static org.w3c.dom.NodeList	applyXpathExpressionToDocument(java.lang.String _xpathExpression, org.w3c.dom.Node _xmlDocumentOrNode)	Applys a xpathExpression to a xml-Document and return a NodeList with the results.
static java.util.Map<java.lang.String,java.lang.String>	convertToAttributeMap(org.w3c.dom.NamedNodeMap _nodeMap)	Converts NamedNodeMap to a LinkedHashMap<String,String>.
static java.util.List<org.w3c.dom.Element>	convertToElementList(org.w3c.dom.NodeList _nodeList)	Convert a NodeList to a Java List of Elements.
static boolean	isElementType(org.w3c.dom.Node _node)	Shortcut for checking if given node is of type Element.
static org.w3c.dom.Document	parseXmlString(java.lang.String _xmlStr, boolean _validating, boolean _namespaceAware)	Read the given string as XML document.
static org.w3c.dom.Document	parseXmlStringWithXsdValidation(java.lang.String _xmlStr, boolean _namespaceAware)	Loads XML from string and uses referenced XSD to validate the content.
static org.w3c.dom.Document	parseXmlStringWithXsdValidation(java.lang.String _xmlStr, boolean _namespaceAware, org.xml.sax.ErrorHandler _errorHandler)	Loads XML from string and uses referenced XSD to validate the content.
static void	printDocument(org.w3c.dom.Node _docOrNode, java.io.OutputStream _outStream)	Dump a Document or Node-compatible object to the given OutputStream (e.g.
static org.w3c.dom.Element	toElement(org.w3c.dom.Node _node)	Checks and converts given Node to Element if possible.

Methods inherited from class java.lang.Object

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

Constructor Detail

XmlUtil

private XmlUtil()

Method Detail

isElementType

public static boolean isElementType(org.w3c.dom.Node _node)

Shortcut for checking if given node is of type Element.

Parameters:

_node - node

Returns:

true if Element, false otherwise

toElement

public static org.w3c.dom.Element toElement(org.w3c.dom.Node _node)

Checks and converts given Node to Element if possible.

Parameters:

_node - node

Returns:

Element or null if given Node is not Element subtype

applyXpathExpressionToDocument

public static org.w3c.dom.NodeList applyXpathExpressionToDocument(java.lang.String _xpathExpression,
                                                                  org.w3c.dom.Node _xmlDocumentOrNode)
                                                           throws java.io.IOException

Applys a xpathExpression to a xml-Document and return a NodeList with the results.

Parameters:

_xpathExpression - xpath expression

_xmlDocumentOrNode - document or node

Returns:

NodeList

Throws:

java.io.IOException - on error

parseXmlString

public static org.w3c.dom.Document parseXmlString(java.lang.String _xmlStr,
                                                  boolean _validating,
                                                  boolean _namespaceAware)
                                           throws java.io.IOException

Read the given string as XML document.

Parameters:

_xmlStr - xml string

_validating - boolean

_namespaceAware - boolean

Returns:

Document

Throws:

java.io.IOException - on error

convertToElementList

public static java.util.List<org.w3c.dom.Element> convertToElementList(org.w3c.dom.NodeList _nodeList)

Convert a NodeList to a Java List of Elements.

Parameters:

_nodeList - collection of nodes

Returns:

list of elements

convertToAttributeMap

public static java.util.Map<java.lang.String,java.lang.String> convertToAttributeMap(org.w3c.dom.NamedNodeMap _nodeMap)

Converts NamedNodeMap to a LinkedHashMap<String,String>.

Parameters:

_nodeMap - node map

Returns:

LinkedHashMap, maybe empty but never null

parseXmlStringWithXsdValidation

public static org.w3c.dom.Document parseXmlStringWithXsdValidation(java.lang.String _xmlStr,
                                                                   boolean _namespaceAware,
                                                                   org.xml.sax.ErrorHandler _errorHandler)
                                                            throws java.io.IOException

Loads XML from string and uses referenced XSD to validate the content.

Parameters:

_xmlStr - string to validate

_namespaceAware - take care of namespace

_errorHandler - e.g. XmlErrorHandlers.XmlErrorHandlerQuiet or XmlErrorHandlers.XmlErrorHandlerRuntimeException

Returns:

Document

Throws:

java.io.IOException - on error

parseXmlStringWithXsdValidation

public static org.w3c.dom.Document parseXmlStringWithXsdValidation(java.lang.String _xmlStr,
                                                                   boolean _namespaceAware)
                                                            throws java.io.IOException

Loads XML from string and uses referenced XSD to validate the content. This method will use XmlErrorHandlers.XmlErrorHandlerQuiet to suppress all errors/warnings when validating.

Parameters:

_xmlStr - string to validate

_namespaceAware - take care of namespace

Returns:

Document

Throws:

java.io.IOException - on error

printDocument

public static void printDocument(org.w3c.dom.Node _docOrNode,
                                 java.io.OutputStream _outStream)
                          throws java.io.IOException

Dump a Document or Node-compatible object to the given OutputStream (e.g. System.out).

Parameters:

_docOrNode - Document or Node object

_outStream - OutputStream to print on

Throws:

java.io.IOException - on error