|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectnet.sf.saxon.tree.wrapper.VirtualCopy
public class VirtualCopy
This class represents a node that is a virtual copy of another node: that is, it behaves as a node that's the same as another node, but has different identity. Moreover, this class can create a virtual copy of a subtree, so that the parent of the virtual copy is null rather than being a virtual copy of the parent of the original. This means that none of the axes when applied to the virtual copy is allowed to stray outside the subtree. The virtual copy is implemented by means of a reference to the node of which it is a copy, but methods that are sensitive to node identity return a different result.
| Nested Class Summary | |
|---|---|
protected class |
VirtualCopy.VirtualCopier
VirtualCopier implements the XPath axes as applied to a VirtualCopy node. |
| Field Summary | |
|---|---|
protected long |
documentNumber
|
protected NodeInfo |
original
|
protected VirtualCopy |
parent
|
protected NodeInfo |
root
|
protected String |
systemId
|
| Fields inherited from interface net.sf.saxon.om.NodeInfo |
|---|
ALL_NAMESPACES, IS_DTD_TYPE, IS_NILLED, LOCAL_NAMESPACES, NO_NAMESPACES |
| Fields inherited from interface net.sf.saxon.om.ValueRepresentation |
|---|
EMPTY_VALUE_ARRAY |
| Constructor Summary | |
|---|---|
protected |
VirtualCopy(NodeInfo base)
Protected constructor: create a virtual copy of a node |
| Method Summary | |
|---|---|
Value |
atomize()
Get the typed value. |
int |
compareOrder(NodeInfo other)
Determine the relative position of this node and another node, in document order. |
void |
copy(Receiver out,
int copyOptions,
int locationId)
Copy this node to a given outputter |
boolean |
equals(Object other)
The equals() method compares nodes for identity. |
void |
generateId(FastStringBuffer buffer)
Get a character string that uniquely identifies this node. |
String |
getAttributeValue(int fingerprint)
Get the value of a given attribute of this node |
String |
getAttributeValue(String uri,
String local)
Get the string value of a given attribute of this node |
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 undeclarations and undeclarations defined on this element. |
String |
getDisplayName()
Get the display name of this node. |
long |
getDocumentNumber()
Get the document number of the document containing this node. |
DocumentInfo |
getDocumentRoot()
Get the root node, if it is a document node. |
int |
getFingerprint()
Get fingerprint. |
int |
getLineNumber()
Get line number |
String |
getLocalPart()
Get the local part of the name of this node. |
int |
getNameCode()
Get name code. |
NamePool |
getNamePool()
Get the NamePool that holds the namecode for this node |
int |
getNodeKind()
Get the kind of node. |
NodeInfo |
getParent()
Get the NodeInfo object representing the parent of this node |
String |
getPrefix()
Get the prefix of the name of the node. |
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. |
String |
getStringValue()
Return the string value of the node. |
CharSequence |
getStringValueCS()
Get the value of the item as a CharSequence. |
String |
getSystemId()
Get the System ID for the node. |
int |
getTypeAnnotation()
Get the type annotation of this node, if any. |
SequenceIterator |
getTypedValue()
Get the typed value of the item |
String |
getURI()
Get the URI part of the name of this node. |
boolean |
hasChildNodes()
Determine whether the node has any children. |
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() |
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. |
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,
NodeInfo root)
Create an iterator that makes and returns virtual copies of nodes on the original tree |
static VirtualCopy |
makeVirtualCopy(NodeInfo original,
NodeInfo root)
Public factory method: create a virtual copy of a node |
void |
setDocumentNumber(long documentNumber)
Set the unique document number of the virtual document. |
void |
setSystemId(String systemId)
Set the system identifier for this Source. |
protected VirtualCopy |
wrap(NodeInfo node)
Wrap a node in a VirtualCopy. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
protected String systemId
protected long documentNumber
protected NodeInfo original
protected VirtualCopy parent
protected NodeInfo root
| Constructor Detail |
|---|
protected VirtualCopy(NodeInfo base)
base - the node to be copied| Method Detail |
|---|
public static VirtualCopy makeVirtualCopy(NodeInfo original,
NodeInfo root)
original - the node to be copiedroot - the root of the tree containing the node to be copied
protected VirtualCopy wrap(NodeInfo node)
node - the node to be wrappedpublic void setDocumentNumber(long documentNumber)
documentNumber - the document number to be allocated. This can be obtained from the
DocumentNumberAllocator which is accessible from the Configuration using
Configuration.getDocumentNumberAllocator()public int getNodeKind()
getNodeKind in interface NodeInfoTypepublic boolean isSameNodeInfo(NodeInfo other)
isSameNodeInfo in interface NodeInfoother - the node to be compared with this node
public boolean equals(Object other)
equals in interface NodeInfoequals in class Objectother - the node to be compared with this node
public int hashCode()
hashCode in interface NodeInfohashCode in class Objectpublic String getSystemId()
getSystemId in interface SourcegetSystemId in interface SourceLocatorgetSystemId in interface NodeInfopublic String getBaseURI()
getBaseURI in interface NodeInfopublic int getLineNumber()
getLineNumber in interface SourceLocatorgetLineNumber in interface NodeInfopublic int getColumnNumber()
getColumnNumber in interface SourceLocatorgetColumnNumber in interface NodeInfopublic int compareOrder(NodeInfo other)
compareOrder in interface NodeInfoother - The other node, whose position is to be compared with this
node
public String getStringValue()
getStringValue in interface Item<NodeInfo>getStringValue in interface NodeInfogetStringValue in interface ValueRepresentation<NodeInfo>Item.getStringValueCS()public CharSequence getStringValueCS()
getStringValueCS in interface Item<NodeInfo>getStringValueCS in interface ValueRepresentation<NodeInfo>Item.getStringValue()public int getNameCode()
getNameCode in interface NodeInfoallocate,
getFingerprintpublic int getFingerprint()
getFingerprint in interface NodeInfopublic String getLocalPart()
getLocalPart in interface NodeInfopublic String getURI()
getURI in interface NodeInfopublic String getPrefix()
getPrefix in interface NodeInfopublic String getDisplayName()
getDisplayName in interface NodeInfopublic Configuration getConfiguration()
getConfiguration in interface NodeInfopublic NamePool getNamePool()
getNamePool in interface NodeInfopublic int getTypeAnnotation()
getTypeAnnotation in interface NodeInfoTypepublic SchemaType getSchemaType()
Types derived from a DTD are not reflected in the result of this method.
getSchemaType in interface NodeInfopublic NodeInfo getParent()
getParent in interface NodeInfopublic AxisIterator iterateAxis(byte axisNumber)
iterateAxis in interface NodeInfoaxisNumber - an integer identifying the axis; one of the constants
defined in class net.sf.saxon.om.Axis
UnsupportedOperationException - if the namespace axis is
requested and this axis is not supported for this implementation.Axis
public AxisIterator iterateAxis(byte axisNumber,
NodeTest nodeTest)
iterateAxis in interface NodeInfoaxisNumber - 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 result
UnsupportedOperationException - if the namespace axis is
requested and this axis is not supported for this implementation.Axispublic String getAttributeValue(int fingerprint)
getAttributeValue in interface NodeInfofingerprint - The fingerprint of the attribute name
public String getAttributeValue(String uri,
String local)
getAttributeValue in interface NodeInfouri - 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()
getRoot in interface NodeInfopublic DocumentInfo getDocumentRoot()
getDocumentRoot in interface NodeInfopublic boolean hasChildNodes()
hasChildNodes in interface NodeInfopublic void generateId(FastStringBuffer buffer)
generateId in interface NodeInfobuffer - a buffer, to which will be appended
a string that uniquely identifies this node, across all
documents.public long getDocumentNumber()
getDocumentNumber in interface NodeInfo
public void copy(Receiver out,
int copyOptions,
int locationId)
throws XPathException
copy in interface NodeInfoout - the Receiver to which the node should be copiedcopyOptions - a selection of the options defined in CopyOptionslocationId - Identifies the location of the instruction
XPathException - if any downstream error occurspublic NamespaceBinding[] getDeclaredNamespaces(NamespaceBinding[] buffer)
getDeclaredNamespaces in interface NodeInfobuffer - 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 void setSystemId(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 SourcesystemId - The system identifier as a URL string.
public SequenceIterator getTypedValue()
throws XPathException
getTypedValue in interface Item<NodeInfo>XPathException - where no typed value is available, e.g. for
an element with complex content
public Value atomize()
throws XPathException
Item.getTypedValue(). However, this method is often more convenient and may be
more efficient, especially in the common case where the value is expected to be a singleton.
atomize in interface NodeInfoXPathException - if the node has no typed value, for example if
it is an element node with element-only contentpublic boolean isId()
isId in interface NodeInfopublic boolean isIdref()
isIdref in interface NodeInfopublic boolean isNilled()
isNilled in interface NodeInfopublic 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 SourceLocatorgetSystemId()
protected VirtualCopy.VirtualCopier makeCopier(AxisIterator axis,
VirtualCopy newParent,
NodeInfo root)
axis - the axis to be navigatednewParent - the parent of the nodes in the new virtual tree (may be null)root - the root of the virtual tree
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||