Saxon.Api

 

Saxon.Api
Class XdmNode

---

public class XdmNode

extends XdmItem

The class XdmNode represents a Node in the XDM Data Model. A Node is an XdmItem, and is therefore an XdmValue in its own right, and may also participate as one item within a sequence value.

An XdmNode is implemented as a wrapper around an object of type net.sf.saxon.NodeInfo. Because this is a key interface within Saxon, it is exposed via this API, even though it is a Java interface that is not part of the API proper.

The XdmNode interface exposes basic properties of the node, such as its name, its string value, and its typed value. Navigation to other nodes is supported through a single method, EnumerateAxis, which allows other nodes to be retrieved by following any of the XPath axes.

---

Property Summary
QName	NodeName The name of the node, as a QName. Returns null in the case of unnamed nodes.
XmlNodeType	NodeKind The kind of node, as an instance of System.Xml.XmlNodeType.
int	LineNumber Get the line number of the node in a source document. For a document constructed using the document builder, this is available only if the line numbering option was set wehn the document was built (and then only for element nodes). If the line number is not available, the value -1 is returned. Line numbers will typically be as reported by a SAX parser; this means that the line number for an element node is the line number containing the closing ">" of the start tag.
int	ColumnNumber Get the column number of the node in a source document. For a document constructed using the document builder, this is available only if the line numbering option was set wehn the document was built (and then only for element nodes). If the column number is not available, the value -1 is returned. Line numbers will typically be as reported by a SAX parser; this means that the column number for an element node is the column number containing the closing ">" of the start tag.
XdmValue	TypedValue The typed value of the node, as an instance of XdmValue.
String	StringValue The string value of the node.
XdmNode	Parent Get the parent of this node.
XdmNode	Root Get the root of the tree containing this node.
Uri	BaseUri The Base URI of the node.
Uri	DocumentUri The Document URI of the node.
String	OuterXml Return a serialization of this node as lexical XML
net.sf.saxon.om.NodeInfo	Implementation Escape hatch to the underlying class in the Java implementation

 

Method Summary
bool	IsAtomic() Determine whether the item is an atomic value
XmlNode	getUnderlyingXmlNode() Unwraps the underlying XmlNode object from the XdmValue. If the method does not wrap a XmlNode then a null is returned
String	GetAttributeValue(QName name) Get a the string value of a named attribute of this element.
IEnumerator	EnumerateAxis(XdmAxis axis) Get an enumerator that supplies all the nodes on one of the XPath axes, starting with this node.
IEnumerator	EnumerateAxis(XdmAxis axis, QName nodeName) Get an enumerator that selects all the nodes on one of the XPath axes, provided they have a given name. The nodes selected are those of the principal node kind (elements for most axes, attributes for the attribute axis, namespace nodes for the namespace axis) whose name matches the name given in the second argument.
void	WriteTo(System.Xml.XmlWriter writer) Send the node (that is, the subtree rooted at this node) to an XmlWriter
bool	Equals(object obj) Two instances of XdmNode are equal if they represent the same node. That is, the Equals() method returns the same result as the XPath "is" operator.
int	GetHashCode() The hashCode of a node reflects the equality relationship: if two XdmNode instances represent the same node, then they have the same hashCode
String	ToString() Return a string representation of the node.

 

Property Detail

NodeName

public QName NodeName {get; }

The name of the node, as a QName. Returns null in the case of unnamed nodes.

---

NodeKind

public XmlNodeType NodeKind {get; }

The kind of node, as an instance of System.Xml.XmlNodeType.

For a namespace node in the XDM model, the value XmlNodeType.None is returned.

---

LineNumber

public int LineNumber {get; }

Get the line number of the node in a source document. For a document constructed using the document builder, this is available only if the line numbering option was set wehn the document was built (and then only for element nodes). If the line number is not available, the value -1 is returned. Line numbers will typically be as reported by a SAX parser; this means that the line number for an element node is the line number containing the closing ">" of the start tag.

---

ColumnNumber

public int ColumnNumber {get; }

Get the column number of the node in a source document. For a document constructed using the document builder, this is available only if the line numbering option was set wehn the document was built (and then only for element nodes). If the column number is not available, the value -1 is returned. Line numbers will typically be as reported by a SAX parser; this means that the column number for an element node is the column number containing the closing ">" of the start tag.

---

TypedValue

public XdmValue TypedValue {get; }

The typed value of the node, as an instance of XdmValue.

Throws:

- A DynamicError is thrown if the node has no typed value, as will be the case for an element with element-only content.

---

StringValue

public String StringValue {get; }

The string value of the node.

---

Parent

public XdmNode Parent {get; }

Get the parent of this node.

Returns either a document node, and element node, or null in the case where this node has no parent.

---

Root

public XdmNode Root {get; }

Get the root of the tree containing this node.

Returns the root of the tree containing this node (which might be this node itself).

---

BaseUri

public Uri BaseUri {get; }

The Base URI of the node.

---

DocumentUri

public Uri DocumentUri {get; }

The Document URI of the node.

---

OuterXml

public String OuterXml {get; }

Return a serialization of this node as lexical XML

In the case of an element node, the result will be a well-formed XML document serialized as defined in the W3C XSLT/XQuery serialization specification, using options method="xml", indent="yes", omit-xml-declaration="yes".

In the case of a document node, the result will be a well-formed XML document provided that the document node contains exactly one element child, and no text node children. In other cases it will be a well-formed external general parsed entity.

In the case of an attribute node, the output is a string in the form name="value". The name will use the original namespace prefix.

Other nodes, such as text nodes, comments, and processing instructions, are represented as they would appear in lexical XML.

---

Implementation

public net.sf.saxon.om.NodeInfo Implementation {get; }

Escape hatch to the underlying class in the Java implementation

---

Method Detail

IsAtomic

---

getUnderlyingXmlNode

---

GetAttributeValue

---

EnumerateAxis

---

EnumerateAxis

---

WriteTo

---

Equals

---

GetHashCode

---

ToString

---