XMLUtils (GeoPose 1.0 Conformance Test Suite 1.0 API)

java.lang.Object
- org.opengis.cite.geopose10.util.XMLUtils

```
public class XMLUtils
extends Object
```
Provides various utility methods for accessing or manipulating XML representations.

Constructor Summary

Constructors
Constructor and Description

XMLUtils()

Constructors
Constructor and Description
`XMLUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static List<Node>`	`asList(NodeList nodeList)` Returns a List view of the nodes in the given NodeList collection.
`static Element`	`createElement(QName qName)` Creates a new Element having the specified qualified name.
`static NodeList`	`evaluateXPath(Node context, String expr, Map<String,String> namespaceBindings)` Evaluates an XPath 1.0 expression using the given context and returns the result as a node set.
`static Object`	`evaluateXPath(Node context, String expr, Map<String,String> namespaceBindings, QName returnType)` Evaluates an XPath expression using the given context and returns the result as the specified type.
`static net.sf.saxon.s9api.XdmValue`	`evaluateXPath2(Source xmlSource, String expr, Map<String,String> nsBindings)` Evaluates an XPath 2.0 expression using the Saxon s9api interfaces.
`static net.sf.saxon.s9api.XdmValue`	`evaluateXQuery(Source source, String query, Map<String,String> nsBindings)` Evaluates an XQuery 1.0 expression using the Saxon s9api interfaces.
`static String`	`expandReferencesInText(String value)` Expands character entity (&name;) and numeric references ( &#xhhhh; or &dddd;) that occur within a given string value.
`static List<Element>`	`getElementsByNamespaceURI(Node node, String namespaceURI)` Returns a List of all descendant Element nodes having the specified [namespace name] property.
`static Document`	`importElement(Element elem)` Creates a DOM Document with the given Element as the document element.
`static Document`	`transform(Source xslt, Node source)` Transforms the content of a DOM Node using a specified XSLT stylesheet.
`static void`	`writeNode(Node node, OutputStream outputStream)` Writes the content of a DOM Node to a byte stream.
`static String`	`writeNodeToString(Node node)` Writes the content of a DOM Node to a string.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - XMLUtils
```
public XMLUtils()
```
- Method Detail
  - writeNodeToString
```
public static String writeNodeToString(Node node)
```
    Writes the content of a DOM Node to a string. The XML declaration is omitted and the character encoding is set to "US-ASCII" (any character outside of this set is serialized as a numeric character reference).
    
    Parameters:
    
    node - The DOM Node to be serialized.
    
    Returns:
    
    A String representing the content of the given node.
  - writeNode
```
public static void writeNode(Node node,
                             OutputStream outputStream)
```
    Writes the content of a DOM Node to a byte stream. An XML declaration is always omitted.
    
    Parameters:
    
    node - The DOM Node to be serialized.
    
    outputStream - The destination OutputStream reference.
  - evaluateXPath
```
public static NodeList evaluateXPath(Node context,
                                     String expr,
                                     Map<String,String> namespaceBindings)
                              throws XPathExpressionException
```
    Evaluates an XPath 1.0 expression using the given context and returns the result as a node set.
    
    Parameters:
    
    context - The context node.
    
    expr - An XPath expression.
    
    namespaceBindings - A collection of namespace bindings for the XPath expression, where each entry maps a namespace URI (key) to a prefix (value). Standard bindings do not need to be declared (see NamespaceBindings.withStandardBindings().
    
    Returns:
    
    A NodeList containing nodes that satisfy the expression (it may be empty).
    
    Throws:
    
    XPathExpressionException - If the expression cannot be evaluated for any reason.
  - evaluateXPath
```
public static Object evaluateXPath(Node context,
                                   String expr,
                                   Map<String,String> namespaceBindings,
                                   QName returnType)
                            throws XPathExpressionException
```
    Evaluates an XPath expression using the given context and returns the result as the specified type.
    Note: The Saxon implementation supports XPath 2.0 expressions when using the JAXP XPath APIs (the default implementation will throw an exception).
    
    Parameters:
    
    context - The context node.
    
    expr - An XPath expression.
    
    namespaceBindings - A collection of namespace bindings for the XPath expression, where each entry maps a namespace URI (key) to a prefix (value). Standard bindings do not need to be declared (see NamespaceBindings.withStandardBindings().
    
    returnType - The desired return type (as declared in XPathConstants ).
    
    Returns:
    
    The result converted to the desired returnType.
    
    Throws:
    
    XPathExpressionException - If the expression cannot be evaluated for any reason.
  - evaluateXPath2
```
public static net.sf.saxon.s9api.XdmValue evaluateXPath2(Source xmlSource,
                                                         String expr,
                                                         Map<String,String> nsBindings)
                                                  throws net.sf.saxon.s9api.SaxonApiException
```
    Evaluates an XPath 2.0 expression using the Saxon s9api interfaces.
    
    Parameters:
    
    xmlSource - The XML Source.
    
    expr - The XPath expression to be evaluated.
    
    nsBindings - A collection of namespace bindings required to evaluate the XPath expression, where each entry maps a namespace URI (key) to a prefix (value); this may be null if not needed.
    
    Returns:
    
    An XdmValue object representing a value in the XDM data model; this is a sequence of zero or more items, where each item is either an atomic value or a node.
    
    Throws:
    
    net.sf.saxon.s9api.SaxonApiException - If an error occurs while evaluating the expression; this always wraps some other underlying exception.
  - evaluateXQuery
```
public static net.sf.saxon.s9api.XdmValue evaluateXQuery(Source source,
                                                         String query,
                                                         Map<String,String> nsBindings)
                                                  throws net.sf.saxon.s9api.SaxonApiException
```
    Evaluates an XQuery 1.0 expression using the Saxon s9api interfaces.
    
    Parameters:
    
    source - The XML Source.
    
    query - The query expression.
    
    nsBindings - A collection of namespace bindings required to evaluate the query, where each entry maps a namespace URI (key) to a prefix (value).
    
    Returns:
    
    An XdmValue object representing a value in the XDM data model.
    
    Throws:
    
    net.sf.saxon.s9api.SaxonApiException - If an error occurs while evaluating the query (this always wraps some other underlying exception).
  - createElement
```
public static Element createElement(QName qName)
```
    Creates a new Element having the specified qualified name. The element must be adopted when inserted into another Document.
    
    Parameters:
    
    qName - A QName object.
    
    Returns:
    
    An Element node (with a Document owner but no parent).
  - getElementsByNamespaceURI
```
public static List<Element> getElementsByNamespaceURI(Node node,
                                                      String namespaceURI)
```
    Returns a List of all descendant Element nodes having the specified [namespace name] property. The elements are listed in document order.
    
    Parameters:
    
    node - The node to search from.
    
    namespaceURI - An absolute URI denoting a namespace name.
    
    Returns:
    
    A List containing elements in the specified namespace; the list is empty if there are no elements in the namespace.
  - transform
```
public static Document transform(Source xslt,
                                 Node source)
```
    Transforms the content of a DOM Node using a specified XSLT stylesheet.
    
    Parameters:
    
    xslt - A Source object representing a stylesheet (XSLT 1.0 or 2.0).
    
    source - A Node representing the XML source. If it is an Element node it will be imported into a new DOM Document.
    
    Returns:
    
    A DOM Document containing the result of the transformation.
  - expandReferencesInText
```
public static String expandReferencesInText(String value)
```
    Expands character entity (&name;) and numeric references ( &#xhhhh; or &dddd;) that occur within a given string value. It may be necessary to do this before processing an XPath expression.
    
    Parameters:
    
    value - A string representing text content.
    
    Returns:
    
    A string with all included references expanded.
  - importElement
```
public static Document importElement(Element elem)
```
    Creates a DOM Document with the given Element as the document element. A deep copy of the element is imported; the source element is not altered.
    
    Parameters:
    
    elem - An Element node.
    
    Returns:
    
    A Document node.
  - asList
```
public static List<Node> asList(NodeList nodeList)
```
    Returns a List view of the nodes in the given NodeList collection.
    
    Parameters:
    
    nodeList - An ordered collection of DOM nodes.
    
    Returns:
    
    A List containing the original sequence of Node objects.

Class XMLUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

XMLUtils

Method Detail

writeNodeToString

writeNode

evaluateXPath

evaluateXPath

evaluateXPath2

evaluateXQuery

createElement

getElementsByNamespaceURI

transform

expandReferencesInText

importElement

asList