public class VirtualCopy extends java.lang.Object implements NodeInfo
Modifier and Type | Class and Description |
---|---|
protected class |
VirtualCopy.VirtualCopier
VirtualCopier implements the XPath axes as applied to a VirtualCopy node.
|
Modifier and Type | Field and Description |
---|---|
protected NodeInfo |
original |
protected VirtualCopy |
parent |
protected NodeInfo |
root |
protected java.lang.String |
systemId |
protected VirtualTreeInfo |
tree |
ALL_NAMESPACES, IS_DTD_TYPE, IS_NILLED, LOCAL_NAMESPACES, NO_NAMESPACES
Modifier | Constructor and Description |
---|---|
protected |
VirtualCopy(NodeInfo base,
NodeInfo root)
Protected constructor: create a virtual copy of a node
|
Modifier and Type | Method and Description |
---|---|
AtomicSequence |
atomize()
Get the typed value.
|
int |
compareOrder(NodeInfo other)
Determine the relative position of this node and another node, in document order.
|
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
|
boolean |
equals(java.lang.Object other)
The equals() method compares nodes for identity.
|
void |
generateId(FastStringBuffer buffer)
Get a character string that uniquely identifies this node.
|
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 fingerprint.
|
int |
getLineNumber()
Get line number
|
java.lang.String |
getLocalPart()
Get the local part of the name of this node.
|
int |
getNodeKind()
Get the kind of node.
|
NodeInfo |
getOriginalNode()
Get the original (wrapped) node
|
NodeInfo |
getParent()
Get the NodeInfo object representing the parent of this node
|
java.lang.String |
getPrefix()
Get the prefix of the name of the node.
|
java.lang.String |
getPublicId()
Return the public identifier for the current document event.
|
NodeInfo |
getRoot()
Get the root node of the tree containing this node
|
SchemaType |
getSchemaType()
Get the type annotation of this node, if any.
|
java.lang.String |
getStringValue()
Return the string value of the node.
|
java.lang.CharSequence |
getStringValueCS()
Get the value of the item as a CharSequence.
|
java.lang.String |
getSystemId()
Get the System ID for the node.
|
VirtualTreeInfo |
getTreeInfo()
Get information about the tree to which this NodeInfo belongs
|
java.lang.String |
getURI()
Get the URI part of the name of this node.
|
boolean |
hasChildNodes()
Determine whether the node has any children.
|
boolean |
hasFingerprint()
Ask whether this NodeInfo implementation holds a fingerprint identifying the name of the
node in the NamePool.
|
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
|
protected boolean |
isIncludedInCopy(NodeInfo sourceNode)
Ask whether a node in the source tree is within the scope of this virtual copy
|
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 |
AxisIterator |
iterateAxis(byte axisNumber)
Return an iteration over all the nodes reached by the given axis from this node
|
AxisIterator |
iterateAxis(byte axisNumber,
NodeTest nodeTest)
Return an iteration over all the nodes reached by the given axis from this node
that match a given NodeTest
|
protected VirtualCopy.VirtualCopier |
makeCopier(AxisIterator axis,
VirtualCopy newParent,
boolean testInclusion)
Create an iterator that makes and returns virtual copies of nodes on the original tree
|
static VirtualCopy |
makeVirtualCopy(NodeInfo original)
Public factory method: create a virtual tree as a copy of an existing node
|
Location |
saveLocation()
Get an immutable copy of this Location object.
|
void |
setDropNamespaces(boolean drop)
Say that namespaces in the virtual tree should not be copied from the underlying
tree.
|
void |
setSystemId(java.lang.String systemId)
Set the system identifier for this Source.
|
protected VirtualCopy |
wrap(NodeInfo node)
Wrap a node within an existing VirtualCopy.
|
protected java.lang.String systemId
protected NodeInfo original
protected VirtualCopy parent
protected NodeInfo root
protected VirtualTreeInfo tree
public static VirtualCopy makeVirtualCopy(NodeInfo original)
original
- the node to be copiedprotected VirtualCopy wrap(NodeInfo node)
node
- the node to be wrappedpublic NodeInfo getOriginalNode()
public VirtualTreeInfo getTreeInfo()
getTreeInfo
in interface NodeInfo
public void setDropNamespaces(boolean drop)
drop
- true if namespaces are to be droppedpublic int getFingerprint()
getFingerprint
in interface NodeInfo
java.lang.UnsupportedOperationException
- if this kind of node does not hold
namepool fingerprints (specifically, if hasFingerprint()
returns false).public boolean hasFingerprint()
getFingerprint()
method must
return the fingerprint of the node. If the answer is false, then the getFingerprint()
method should throw an UnsupportedOperationException
. In the case of unnamed nodes
such as text nodes, the result can be either true (in which case getFingerprint() should
return -1) or false (in which case getFingerprint may throw an exception).hasFingerprint
in interface NodeInfo
FingerprintedNode
as a marker interface.public SequenceIterator iterate()
Sequence
, this method returns a singleton iterator
that delivers this item in the form of a sequencepublic int getNodeKind()
getNodeKind
in interface NodeInfo
Type
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 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 compareOrder(NodeInfo other)
compareOrder
in interface NodeInfo
other
- The other node, whose position is to be compared with this
nodepublic 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.CharSequence getStringValueCS()
getStringValueCS
in interface Item
Item.getStringValue()
public java.lang.String getLocalPart()
getLocalPart
in interface NodeInfo
public java.lang.String getURI()
public java.lang.String getPrefix()
public java.lang.String getDisplayName()
getDisplayName
in interface NodeInfo
public Configuration getConfiguration()
getConfiguration
in interface NodeInfo
public SchemaType getSchemaType()
Types derived from a DTD are not reflected in the result of this method.
getSchemaType
in interface NodeInfo
public NodeInfo getParent()
public AxisIterator iterateAxis(byte axisNumber)
iterateAxis
in interface NodeInfo
axisNumber
- an integer identifying the axis; one of the constants
defined in class net.sf.saxon.om.Axisjava.lang.UnsupportedOperationException
- if the namespace axis is
requested and this axis is not supported for this implementation.AxisInfo
public AxisIterator iterateAxis(byte axisNumber, NodeTest nodeTest)
iterateAxis
in interface NodeInfo
axisNumber
- an integer identifying the axis; one of the constants
defined in class net.sf.saxon.om.AxisnodeTest
- A pattern to be matched by the returned nodes; nodes
that do not match this pattern are not included in the resultjava.lang.UnsupportedOperationException
- if the namespace axis is
requested and this axis is not supported for this implementation.AxisInfo
public java.lang.String getAttributeValue(java.lang.String uri, java.lang.String local)
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 NodeInfo getRoot()
public boolean hasChildNodes()
hasChildNodes
in interface NodeInfo
public void generateId(FastStringBuffer buffer)
generateId
in interface NodeInfo
buffer
- a buffer, to which will be appended
a string that uniquely identifies this node, across all
documents.public void copy(Receiver out, int copyOptions, Location locationId) throws XPathException
copy
in interface NodeInfo
out
- the Receiver to which the node should be copiedcopyOptions
- a selection of the options defined in CopyOptions
locationId
- Identifies the location of the instructionXPathException
- if any downstream error occurspublic NamespaceBinding[] getDeclaredNamespaces(NamespaceBinding[] buffer)
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 VirtualCopy, the method needs to return all namespaces that are in scope for this element, because the virtual copy is assumed to contain copies of all the in-scope namespaces of the original.
public void setSystemId(java.lang.String systemId)
The system identifier is optional if the source does not get its data from a URL, but it may still be useful to provide one. The application can use a system identifier, for example, to resolve relative URIs and to include in error messages and warnings.
setSystemId
in interface javax.xml.transform.Source
systemId
- The system identifier as a URL string.public AtomicSequence atomize() throws XPathException
atomize
in interface Item
atomize
in interface NodeInfo
XPathException
- if the node has no typed value, for example if
it is an element node with element-only contentpublic boolean isId()
public boolean isIdref()
public boolean isNilled()
public boolean isStreamed()
isStreamed
in interface NodeInfo
public java.lang.String getPublicId()
The return value is the public identifier of the document entity or of the external parsed entity in which the markup that triggered the event appears.
getPublicId
in interface javax.xml.transform.SourceLocator
getPublicId
in interface Location
getPublicId
in interface NodeInfo
getPublicId
in interface org.xml.sax.Locator
getSystemId()
protected boolean isIncludedInCopy(NodeInfo sourceNode)
sourceNode
- the node being testedprotected VirtualCopy.VirtualCopier makeCopier(AxisIterator axis, VirtualCopy newParent, boolean testInclusion)
axis
- the axis to be navigatednewParent
- the parent of the nodes in the new virtual tree (may be null)testInclusion
- if true, it is necessary to test whether nodes found in the source tree are
included in the copy. If false, this test is unnecessary.Copyright (c) 2004-2018 Saxonica Limited. All rights reserved.