public abstract class AbstractNodeWrapper extends java.lang.Object implements NodeInfo, VirtualNode
This implementation of the NodeInfo interface contains common code used by many "wrapper" implementations for external data models.
Modifier and Type | Field and Description |
---|---|
protected TreeInfo |
treeInfo |
ALL_NAMESPACES, IS_DTD_TYPE, IS_NILLED, LOCAL_NAMESPACES, NO_NAMESPACES
Constructor and Description |
---|
AbstractNodeWrapper() |
Modifier and Type | Method and Description |
---|---|
AtomicSequence |
atomize()
Get the typed value.
|
int |
comparePosition(NodeInfo other)
Determine the relative position of this node and another node, in document order,
distinguishing whether the first node is a preceding, following, descendant, ancestor,
or the same node as the second.
|
void |
copy(Receiver out,
int copyOptions,
Location locationId)
Copy this node to a given outputter (deep copy)
|
boolean |
equals(java.lang.Object other)
The equals() method compares nodes for identity.
|
java.lang.String |
getAttributeValue(java.lang.String uri,
java.lang.String local)
Get the string value of a given attribute of this node.
|
java.lang.String |
getBaseURI()
Get the Base URI for the node, that is, the URI used for resolving a relative URI contained
in the node.
|
int |
getColumnNumber()
Get column number
|
Configuration |
getConfiguration()
Get the configuration.
|
NamespaceBinding[] |
getDeclaredNamespaces(NamespaceBinding[] buffer)
Get all namespace declarations and undeclarations defined on this element.
|
java.lang.String |
getDisplayName()
Get the display name of this node.
|
int |
getFingerprint()
Get the fingerprint of the node
|
int |
getLineNumber()
Get line number
|
NamePool |
getNamePool()
Get the name pool for this node
|
java.lang.String |
getPublicId()
Get the Public ID of the entity containing the node.
|
java.lang.Object |
getRealNode()
Get the node underlying this virtual node.
|
NodeInfo |
getRoot()
Get the root node - always a document node with this tree implementation
|
SchemaType |
getSchemaType()
Get the type annotation of this node, if any.
|
java.lang.String |
getStringValue()
Return the string value of the node.
|
java.lang.String |
getSystemId()
Get the System ID for the node.
|
TreeInfo |
getTreeInfo()
Get information about the tree to which this NodeInfo belongs
|
boolean |
hasChildNodes()
Determine whether the node has any children.
|
boolean |
hasFingerprint()
Test whether a fingerprint is available for the node name
|
int |
hashCode()
The hashCode() method obeys the contract for hashCode(): that is, if two objects are equal
(represent the same node) then they must have the same hashCode()
|
NodeInfo |
head()
To implement
Sequence , this method returns the item itself |
boolean |
isId()
Determine whether this node has the is-id property
|
boolean |
isIdref()
Determine whether this node has the is-idref property
|
boolean |
isNilled()
Determine whether the node has the is-nilled property
|
boolean |
isSameNodeInfo(NodeInfo other)
Determine whether this is the same node as another node.
|
boolean |
isStreamed()
Ask whether this is a node in a streamed document
|
SequenceIterator |
iterate()
To implement
Sequence , this method returns a singleton iterator
that delivers this item in the form of a sequence |
protected abstract AxisIterator |
iterateAttributes(NodeTest nodeTest)
Return an iterator over the attributes of this element node.
|
AxisIterator |
iterateAxis(byte axisNumber)
Return an iteration over the nodes reached by the given axis from this node
|
AxisIterator |
iterateAxis(byte axisNumber,
NodeTest nodeTest)
Return an iteration over the nodes reached by the given axis from this node.
|
protected abstract AxisIterator |
iterateChildren(NodeTest nodeTest)
Return an iterator over the children of this node.
|
protected abstract AxisIterator |
iterateDescendants(NodeTest nodeTest,
boolean includeSelf)
Return an iterator over the descendants of this node.
|
protected abstract AxisIterator |
iterateSiblings(NodeTest nodeTest,
boolean forwards)
Return an iterator over the siblings of this node.
|
Location |
saveLocation()
Get an immutable copy of this Location object.
|
void |
setSystemId(java.lang.String uri)
Set the system ID.
|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
getUnderlyingNode
compareOrder, generateId, getLocalPart, getNodeKind, getParent, getPrefix, getURI
getStringValueCS
protected TreeInfo treeInfo
public TreeInfo getTreeInfo()
NodeInfo
getTreeInfo
in interface NodeInfo
public SequenceIterator iterate()
Sequence
, this method returns a singleton iterator
that delivers this item in the form of a sequencepublic final java.lang.Object getRealNode()
getRealNode
in interface VirtualNode
public Configuration getConfiguration()
getConfiguration
in interface NodeInfo
public NamePool getNamePool()
public AtomicSequence atomize()
public SchemaType getSchemaType()
Types derived from a DTD are not reflected in the result of this method.
getSchemaType
in interface NodeInfo
public boolean isSameNodeInfo(NodeInfo other)
isSameNodeInfo
in interface NodeInfo
other
- the node to be compared with this nodepublic boolean equals(java.lang.Object other)
equals
in interface NodeInfo
equals
in class java.lang.Object
other
- the node to be compared with this nodepublic int hashCode()
hashCode
in interface NodeInfo
hashCode
in class java.lang.Object
public java.lang.String getSystemId()
getSystemId
in interface javax.xml.transform.Source
getSystemId
in interface javax.xml.transform.SourceLocator
getSystemId
in interface Location
getSystemId
in interface NodeInfo
getSystemId
in interface org.xml.sax.Locator
public void setSystemId(java.lang.String uri)
setSystemId
in interface javax.xml.transform.Source
uri
- the system ID.public java.lang.String getPublicId()
getPublicId
in interface javax.xml.transform.SourceLocator
getPublicId
in interface Location
getPublicId
in interface NodeInfo
getPublicId
in interface org.xml.sax.Locator
public java.lang.String getBaseURI()
getBaseURI
in interface NodeInfo
public int getLineNumber()
getLineNumber
in interface javax.xml.transform.SourceLocator
getLineNumber
in interface Location
getLineNumber
in interface NodeInfo
getLineNumber
in interface org.xml.sax.Locator
public int getColumnNumber()
getColumnNumber
in interface javax.xml.transform.SourceLocator
getColumnNumber
in interface Location
getColumnNumber
in interface NodeInfo
getColumnNumber
in interface org.xml.sax.Locator
public Location saveLocation()
saveLocation
in interface Location
public int comparePosition(NodeInfo other)
comparePosition
in interface NodeInfo
other
- The other node, whose position is to be compared with this
nodeAxisInfo.PRECEDING
if this node is on the preceding axis of the other node;
AxisInfo.FOLLOWING
if it is on the following axis; AxisInfo.ANCESTOR
if the first node is an
ancestor of the second; AxisInfo.DESCENDANT
if the first is a descendant of the second;
AxisInfo.SELF
if they are the same node.java.lang.UnsupportedOperationException
- if either node is an attribute or namespacepublic java.lang.String getStringValue()
getStringValue
in interface Item
getStringValue
in interface NodeInfo
Item.getStringValueCS()
public java.lang.String getDisplayName()
getDisplayName
in interface NodeInfo
public java.lang.String getAttributeValue(java.lang.String uri, java.lang.String local)
The default implementation is suitable for nodes other than elements.
getAttributeValue
in interface NodeInfo
uri
- the namespace URI of the attribute name. Supply the empty string for an attribute
that is in no namespacelocal
- the local part of the attribute name.public AxisIterator iterateAxis(byte axisNumber)
iterateAxis
in interface NodeInfo
axisNumber
- the axis to be usedAxisInfo
public AxisIterator iterateAxis(byte axisNumber, NodeTest nodeTest)
This superclass provides implementations of the ancestor, ancestor-or-self, following, namespace, parent, preceding, self, and preceding-or-ancestor axes. The other axes are implemented by calling methods iterateAttributes(), iterateChildren(), iterateDescendants(), and iterateSiblings(), which must be provided in a subclass.
iterateAxis
in interface NodeInfo
axisNumber
- the axis to be usednodeTest
- A pattern to be matched by the returned nodesAxisInfo
protected abstract AxisIterator iterateAttributes(NodeTest nodeTest)
nodeTest
- a test that the returned attributes must satisfyprotected abstract AxisIterator iterateChildren(NodeTest nodeTest)
nodeTest
- a test that the returned attributes must satisfyprotected abstract AxisIterator iterateSiblings(NodeTest nodeTest, boolean forwards)
nodeTest
- a test that the returned siblings must satisfyforwards
- true for following siblings, false for preceding siblingsprotected abstract AxisIterator iterateDescendants(NodeTest nodeTest, boolean includeSelf)
nodeTest
- a test that the returned descendants must satisfyincludeSelf
- true if this node is to be included in the resultpublic NamespaceBinding[] getDeclaredNamespaces(NamespaceBinding[] buffer)
This method is intended primarily for internal use. User applications needing
information about the namespace context of a node should use iterateAxis(Axis.NAMESPACE)
.
(However, not all implementations support the namespace axis, whereas all implementations are
required to support this method.)
This implementation of the method is suitable for all nodes other than elements; it returns an empty array.
getDeclaredNamespaces
in interface NodeInfo
buffer
- If this is non-null, and the result array fits in this buffer, then the result
may overwrite the contents of this array, to avoid the cost of allocating a new array on the heap.For a node other than an element, the method returns null.
public NodeInfo getRoot()
public boolean hasChildNodes()
hasChildNodes
in interface NodeInfo
public void copy(Receiver out, int copyOptions, Location locationId) throws XPathException
copy
in interface NodeInfo
out
- the Receiver to which the node should be copied. It is the caller's
responsibility to ensure that this Receiver is open before the method is called
(or that it is self-opening), and that it is closed after use.copyOptions
- a selection of the options defined in CopyOptions
locationId
- If non-null, identifies the location of the instruction
that requested this copy. If zero, indicates that the location information
is not availableXPathException
- if any downstream error occurspublic boolean isId()
public boolean isIdref()
public boolean isNilled()
public boolean isStreamed()
isStreamed
in interface NodeInfo
public int getFingerprint()
getFingerprint
in interface NodeInfo
java.lang.UnsupportedOperationException
- if this method is called for a node where
hasFingerprint() returns false;public boolean hasFingerprint()
hasFingerprint
in interface NodeInfo
Copyright (c) 2004-2018 Saxonica Limited. All rights reserved.