edu.emory.bmi.aiw.i2b2export.xml

Class XmlUtil

java.lang.Object

edu.emory.bmi.aiw.i2b2export.xml.XmlUtil

public final class XmlUtil
extends Object

Utility methods for handling XPaths and converting between XML document objects and strings.

Since:

1.0

Author:

Michel Mansour

Method Summary

Modifier and Type	Method and Description
static Object	evalXPath(Node d, String expr, QName returnType) Gets the object at the given XPath in the given XML node.
static Object	evalXPath(String xml, String expr, QName returnType) Gets the object at the given XPath in the given XML string.
static String	xmlDocumentToString(Node d) Converts an XML document or node to an equivalent string.
static Document	xmlStringToDocument(String xml) Converts an XML string into an equivalent XML document.

Methods inherited from class java.lang.Object

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

Method Detail

evalXPath

public static Object evalXPath(Node d,
                               String expr,
                               QName returnType)
                        throws XPathExpressionException

Gets the object at the given XPath in the given XML node. See also: evalXPath(String, String, javax.xml.namespace.QName).

Parameters:

d - the node to look in

expr - the XPath expression to evaluate

returnType - the expected return type of the object

Returns:

the object at the specified XPath in the node

Throws:

XPathExpressionException - if an error occurs processing the XPath expression

evalXPath

public static Object evalXPath(String xml,
                               String expr,
                               QName returnType)
                        throws XPathExpressionException,
                               SAXException,
                               IOException,
                               ParserConfigurationException

Gets the object at the given XPath in the given XML string. See also: evalXPath(org.w3c.dom.Node, String, javax.xml.namespace.QName).

Parameters:

xml - the XML string to look in

expr - the XPath expression to evaluate

returnType - expected return type of the object

Returns:

the object at the specified XPath in the XML string

Throws:

XPathExpressionException - if an error occurs while processing the XPath expression

SAXException - if an error occurs converting the XML string to an XML node

IOException - if a general IO error occurs

ParserConfigurationException - if an error occurs configuring the parser

xmlDocumentToString

public static String xmlDocumentToString(Node d)
                                  throws TransformerFactoryConfigurationError,
                                         TransformerException

Converts an XML document or node to an equivalent string. Applies the reverse operation of xmlStringToDocument(String).

Parameters:

d - the node to convert

Returns:

a String representation of the XML node

Throws:

TransformerFactoryConfigurationError - if an error occurs configuring the transformer factory

TransformerException - if an error occurs during the transformation

xmlStringToDocument

public static Document xmlStringToDocument(String xml)
                                    throws SAXException,
                                           IOException,
                                           ParserConfigurationException

Converts an XML string into an equivalent XML document. Applies the reverse operation of xmlDocumentToString(org.w3c.dom.Node).

Parameters:

xml - the XML string to convert

Returns:

a Document equivalent to the specified XML string

Throws:

SAXException - if an error occurs building the XML document

IOException - if a general IO error occurs

ParserConfigurationException - if an error occurs configuring the XML parser