Package net.sf.saxon.tree.linked
Class DocumentImpl
- java.lang.Object
-
- net.sf.saxon.tree.linked.NodeImpl
-
- net.sf.saxon.tree.linked.ParentNodeImpl
-
- net.sf.saxon.tree.linked.DocumentImpl
-
- All Implemented Interfaces:
javax.xml.transform.Source
,javax.xml.transform.SourceLocator
,PullEvent
,DocumentInfo
,FingerprintedNode
,Item<NodeInfo>
,MutableDocumentInfo
,MutableNodeInfo
,NodeInfo
,ValueRepresentation<NodeInfo>
,SiblingCountingNode
public final class DocumentImpl extends ParentNodeImpl implements DocumentInfo, MutableDocumentInfo
A node in the XML parse tree representing the Document itself (or equivalently, the root node of the Document).A DocumentImpl object may either represent a real document node, or it may represent an imaginary container for a parentless element.
- Author:
- Michael H. Kay
-
-
Field Summary
-
Fields inherited from class net.sf.saxon.tree.linked.NodeImpl
NODE_LETTER
-
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
Constructors Constructor Description DocumentImpl()
Create a DocumentImpl
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
copy(Receiver out, int copyOptions, int locationId)
Copy this node to a given outputtervoid
deIndex(NodeImpl node)
Remove a node from any indexes when it is detached from the treeprotected void
deregisterID(java.lang.String id)
Remove the entry for a given ID (when nodes are deleted).void
generateId(FastStringBuffer buffer)
Get a character string that uniquely identifies this node(package private) AxisIterator
getAllElements(int fingerprint)
Get a list of all elements with a given name fingerprintjava.lang.String
getBaseURI()
Get the base URI of this root node.(package private) int
getColumnNumber(int sequence)
Get the column number for an element.Configuration
getConfiguration()
Get the configuration previously set using setConfigurationElementImpl
getDocumentElement()
Get the root (outermost) element.long
getDocumentNumber()
Get the unique document numberDocumentInfo
getDocumentRoot()
Get the root (document) nodeint
getLineNumber()
Get the line number of this root node.(package private) int
getLineNumber(int sequence)
Get the line number for an element.NamePool
getNamePool()
Get the name pool used for the names in this documentNodeInfo
getNextSibling()
Get next sibling - always nullint
getNodeKind()
Return the type of node.DocumentImpl
getPhysicalRoot()
Get the physical root of the tree.NodeInfo
getPreviousSibling()
Get previous sibling - always nullNodeInfo
getRoot()
Get the root nodeSchemaType
getSchemaType()
Get the type annotationjava.lang.String
getSystemId()
Get the system id of this root node(package private) java.lang.String
getSystemId(int seq)
Get the system id of an element in the documentint
getTypeAnnotation()
Get the type annotation of this node, if any.java.lang.String[]
getUnparsedEntity(java.lang.String name)
Get the unparsed entity with a given namejava.util.Iterator<java.lang.String>
getUnparsedEntityNames()
Get the list of unparsed entities defined in this documentjava.lang.Object
getUserData(java.lang.String key)
Get user data held in the document node.void
graftLocationMap(DocumentImpl original)
Copy the system ID and line number map from another document (used when grafting a simplified stylesheet)boolean
isImaginary()
Ask whether this is an imaginary document nodeboolean
isTyped()
Ask whether the document contains any nodes whose type annotation is anything other than UNTYPEDBuilder
newBuilder()
Get a Builder suitable for building nodes that can be attached to this document.protected void
registerID(NodeInfo e, java.lang.String id)
Register a unique element ID.void
replaceStringValue(java.lang.CharSequence stringValue)
Replace the string-value of this nodevoid
resetIndexes()
This method is called before performing a batch of updates; it allows all cached data that might be invalidated by such updates to be clearedNodeInfo
selectID(java.lang.String id, boolean getParent)
Get the element with a given ID.void
setBaseURI(java.lang.String uri)
Set the base URI of this document nodevoid
setConfiguration(Configuration config)
Set the Configuration that contains this document(package private) void
setDocumentElement(ElementImpl e)
Set the top-level element of the document (variously called the root element or the document element).void
setImaginary(boolean imaginary)
Set whether this is an imaginary document node(package private) void
setLineAndColumn(int sequence, int line, int column)
Set the line number for an element.void
setLineNumbering()
Set line numbering on(package private) void
setSystemId(int seq, java.lang.String uri)
Set the system id of an element in the documentvoid
setSystemId(java.lang.String uri)
Set the system id (base URI) of this node(package private) void
setUnparsedEntity(java.lang.String name, java.lang.String uri, java.lang.String publicId)
Set an unparsed entity URI associated with this document.void
setUserData(java.lang.String key, java.lang.Object value)
Set user data on the document node.-
Methods inherited from class net.sf.saxon.tree.linked.ParentNodeImpl
addChild, compact, enumerateChildren, getFirstChild, getLastChild, getNthChild, getNumberOfChildren, getRawSequenceNumber, getSequenceNumber, getStringValue, getStringValueCS, hasChildNodes, insertChildren, insertChildrenAt, removeChild, replaceChildrenAt, setChildren, setRawSequenceNumber
-
Methods inherited from class net.sf.saxon.tree.linked.NodeImpl
addAttribute, addNamespace, atomize, compareOrder, delete, equals, getAttributeValue, getAttributeValue, getColumnNumber, getDeclaredNamespaces, getDisplayName, getFingerprint, getLocalPart, getNameCode, getNextInDocument, getParent, getPrefix, getPreviousInDocument, getPublicId, getRawParent, getSiblingPosition, getTypedValue, getURI, insertSiblings, isDeleted, isId, isIdref, isNilled, isSameNodeInfo, iterateAxis, iterateAxis, removeAttribute, removeTypeAnnotation, rename, replace, setRawParent, setSiblingPosition, setTypeAnnotation
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface net.sf.saxon.om.Item
getStringValueCS, getTypedValue
-
Methods inherited from interface net.sf.saxon.om.NodeInfo
atomize, compareOrder, equals, getAttributeValue, getAttributeValue, getColumnNumber, getDeclaredNamespaces, getDisplayName, getFingerprint, getLocalPart, getNameCode, getParent, getPrefix, getStringValue, getURI, hasChildNodes, hashCode, isId, isIdref, isNilled, isSameNodeInfo, iterateAxis, iterateAxis
-
-
-
-
Method Detail
-
setConfiguration
public void setConfiguration(Configuration config)
Set the Configuration that contains this document- Parameters:
config
- the Saxon configuration
-
getConfiguration
public Configuration getConfiguration()
Get the configuration previously set using setConfiguration- Specified by:
getConfiguration
in interfaceNodeInfo
- Overrides:
getConfiguration
in classNodeImpl
- Returns:
- the Saxon configuration
-
getNamePool
public NamePool getNamePool()
Get the name pool used for the names in this document- Specified by:
getNamePool
in interfaceNodeInfo
- Overrides:
getNamePool
in classNodeImpl
- Returns:
- the namepool
-
newBuilder
public Builder newBuilder()
Get a Builder suitable for building nodes that can be attached to this document.- Specified by:
newBuilder
in interfaceMutableNodeInfo
- Overrides:
newBuilder
in classNodeImpl
- Returns:
- a new TreeBuilder
-
setImaginary
public void setImaginary(boolean imaginary)
Set whether this is an imaginary document node- Parameters:
imaginary
- if true, this is an imaginary node - the tree is really rooted at the topmost element
-
isImaginary
public boolean isImaginary()
Ask whether this is an imaginary document node- Returns:
- true if this is an imaginary node - the tree is really rooted at the topmost element
-
isTyped
public boolean isTyped()
Ask whether the document contains any nodes whose type annotation is anything other than UNTYPED- Specified by:
isTyped
in interfaceDocumentInfo
- Returns:
- true if the document contains elements whose type is other than UNTYPED
-
getDocumentNumber
public long getDocumentNumber()
Get the unique document number- Specified by:
getDocumentNumber
in interfaceNodeInfo
- Overrides:
getDocumentNumber
in classNodeImpl
- Returns:
- the document number of the document containing this node
-
setDocumentElement
void setDocumentElement(ElementImpl e)
Set the top-level element of the document (variously called the root element or the document element). Note that a DocumentImpl may represent the root of a result tree fragment, in which case there is no document element.- Parameters:
e
- the top-level element
-
graftLocationMap
public void graftLocationMap(DocumentImpl original)
Copy the system ID and line number map from another document (used when grafting a simplified stylesheet)- Parameters:
original
- the document whose system ID and line number maps are to be grafted onto this tree
-
setSystemId
public void setSystemId(java.lang.String uri)
Set the system id (base URI) of this node- Specified by:
setSystemId
in interfacejavax.xml.transform.Source
- Overrides:
setSystemId
in classNodeImpl
-
getSystemId
public java.lang.String getSystemId()
Get the system id of this root node- Specified by:
getSystemId
in interfaceNodeInfo
- Specified by:
getSystemId
in interfacejavax.xml.transform.Source
- Specified by:
getSystemId
in interfacejavax.xml.transform.SourceLocator
- Overrides:
getSystemId
in classNodeImpl
- Returns:
- the System Identifier of the entity in the source document containing the node, or null if not known or not applicable.
-
setBaseURI
public void setBaseURI(java.lang.String uri)
Set the base URI of this document node- Parameters:
uri
- the new base URI
-
getBaseURI
public java.lang.String getBaseURI()
Get the base URI of this root node.- Specified by:
getBaseURI
in interfaceNodeInfo
- Overrides:
getBaseURI
in classNodeImpl
- Returns:
- the base URI
-
setSystemId
void setSystemId(int seq, java.lang.String uri)
Set the system id of an element in the document- Parameters:
seq
- the sequence number of the elementuri
- the system identifier (base URI) of the element
-
getSystemId
java.lang.String getSystemId(int seq)
Get the system id of an element in the document- Parameters:
seq
- the sequence number of the element- Returns:
- the systemId (base URI) of the element
-
setLineNumbering
public void setLineNumbering()
Set line numbering on
-
setLineAndColumn
void setLineAndColumn(int sequence, int line, int column)
Set the line number for an element. Ignored if line numbering is off.- Parameters:
sequence
- the sequence number of the elementline
- the line number of the elementcolumn
- the column number of the element
-
getLineNumber
int getLineNumber(int sequence)
Get the line number for an element.- Parameters:
sequence
- the sequence number of the element- Returns:
- the line number for an element. Return -1 if line numbering is off, or if the element was added subsequent to document creation by use of XQuery update
-
getColumnNumber
int getColumnNumber(int sequence)
Get the column number for an element.- Parameters:
sequence
- the sequence number of the element- Returns:
- the column number for an element. Return -1 if line numbering is off, or if the element was added subsequent to document creation by use of XQuery update
-
getLineNumber
public int getLineNumber()
Get the line number of this root node.- Specified by:
getLineNumber
in interfaceNodeInfo
- Specified by:
getLineNumber
in interfacejavax.xml.transform.SourceLocator
- Overrides:
getLineNumber
in classNodeImpl
- Returns:
- 0 always
-
getNodeKind
public final int getNodeKind()
Return the type of node.- Specified by:
getNodeKind
in interfaceNodeInfo
- Returns:
- Type.DOCUMENT (always)
- See Also:
Type
-
getNextSibling
public final NodeInfo getNextSibling()
Get next sibling - always null- Overrides:
getNextSibling
in classNodeImpl
- Returns:
- null
-
getPreviousSibling
public final NodeInfo getPreviousSibling()
Get previous sibling - always null- Overrides:
getPreviousSibling
in classNodeImpl
- Returns:
- null
-
getDocumentElement
public ElementImpl getDocumentElement()
Get the root (outermost) element.- Returns:
- the Element node for the outermost element of the document.
-
getRoot
public NodeInfo getRoot()
Get the root node
-
getDocumentRoot
public DocumentInfo getDocumentRoot()
Get the root (document) node- Specified by:
getDocumentRoot
in interfaceNodeInfo
- Overrides:
getDocumentRoot
in classNodeImpl
- Returns:
- the DocumentInfo representing this document
-
getPhysicalRoot
public DocumentImpl getPhysicalRoot()
Get the physical root of the tree. This may be an imaginary document node: this method should be used only when control information held at the physical root is required- Overrides:
getPhysicalRoot
in classNodeImpl
- Returns:
- the document node, which may be imaginary
-
generateId
public void generateId(FastStringBuffer buffer)
Get a character string that uniquely identifies this node- Specified by:
generateId
in interfaceNodeInfo
- Overrides:
generateId
in classNodeImpl
- Parameters:
buffer
- a buffer into which will be placed a string based on the document number
-
getAllElements
AxisIterator getAllElements(int fingerprint)
Get a list of all elements with a given name fingerprint- Parameters:
fingerprint
- the fingerprint of the required element name- Returns:
- an iterator over all the elements with this name
-
deIndex
public void deIndex(NodeImpl node)
Remove a node from any indexes when it is detached from the tree- Parameters:
node
- the node to be removed from all indexes
-
registerID
protected void registerID(NodeInfo e, java.lang.String id)
Register a unique element ID. Does nothing if there is already an element with that ID.- Parameters:
e
- The Element having a particular unique ID valueid
- The unique ID value
-
selectID
public NodeInfo selectID(java.lang.String id, boolean getParent)
Get the element with a given ID.- Specified by:
selectID
in interfaceDocumentInfo
- Parameters:
id
- The unique ID of the required element, previously registered using registerID()getParent
- true if the requirement is for the parent of the node with the given ID, not the node itself.- Returns:
- The NodeInfo for the given ID if one has been registered, otherwise null.
-
deregisterID
protected void deregisterID(java.lang.String id)
Remove the entry for a given ID (when nodes are deleted). Does nothing if the id value is not present in the index.- Parameters:
id
- The id value
-
setUnparsedEntity
void setUnparsedEntity(java.lang.String name, java.lang.String uri, java.lang.String publicId)
Set an unparsed entity URI associated with this document. For system use only, while building the document.- Parameters:
name
- the entity nameuri
- the system identifier of the unparsed entitypublicId
- the public identifier of the unparsed entity
-
getUnparsedEntityNames
public java.util.Iterator<java.lang.String> getUnparsedEntityNames()
Get the list of unparsed entities defined in this document- Specified by:
getUnparsedEntityNames
in interfaceDocumentInfo
- Returns:
- an Iterator, whose items are of type String, containing the names of all unparsed entities defined in this document. If there are no unparsed entities or if the information is not available then an empty iterator is returned
-
getUnparsedEntity
public java.lang.String[] getUnparsedEntity(java.lang.String name)
Get the unparsed entity with a given name- Specified by:
getUnparsedEntity
in interfaceDocumentInfo
- Parameters:
name
- the name of the entity- Returns:
- if the entity exists, return an array of two Strings, the first holding the system ID of the entity, the second holding the public ID if there is one, or null if not. If the entity does not exist, return null.
-
getTypeAnnotation
public int getTypeAnnotation()
Get the type annotation of this node, if any. By convention for a document node this is XS_ANY_TYPE if the document is validated, or XS_UNTYPED otherwise- Specified by:
getTypeAnnotation
in interfaceNodeInfo
- Overrides:
getTypeAnnotation
in classNodeImpl
- Returns:
- the type annotation, as the integer name code of the type name
-
getSchemaType
public SchemaType getSchemaType()
Get the type annotation- Specified by:
getSchemaType
in interfaceNodeInfo
- Overrides:
getSchemaType
in classNodeImpl
- Returns:
- the type annotation of the base node
-
copy
public void copy(Receiver out, int copyOptions, int locationId) throws XPathException
Copy this node to a given outputter- Specified by:
copy
in interfaceNodeInfo
- Parameters:
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 inCopyOptions
locationId
- If non-zero, identifies the location of the instruction that requested this copy. If zero, indicates that the location information- Throws:
XPathException
- if any downstream error occurs
-
replaceStringValue
public void replaceStringValue(java.lang.CharSequence stringValue)
Replace the string-value of this node- Specified by:
replaceStringValue
in interfaceMutableNodeInfo
- Parameters:
stringValue
- the new string value
-
resetIndexes
public void resetIndexes()
This method is called before performing a batch of updates; it allows all cached data that might be invalidated by such updates to be cleared- Specified by:
resetIndexes
in interfaceMutableDocumentInfo
-
setUserData
public void setUserData(java.lang.String key, java.lang.Object value)
Set user data on the document node. The user data can be retrieved subsequently usinggetUserData(java.lang.String)
- Specified by:
setUserData
in interfaceDocumentInfo
- Parameters:
key
- A string giving the name of the property to be set. Clients are responsible for choosing a key that is likely to be unique. Must not be null. Keys used internally by Saxon are prefixed "saxon:".value
- The value to be set for the property. May be null, which effectively removes the existing value for the property.
-
getUserData
public java.lang.Object getUserData(java.lang.String key)
Get user data held in the document node. This retrieves properties previously set usingsetUserData(java.lang.String, java.lang.Object)
- Specified by:
getUserData
in interfaceDocumentInfo
- Parameters:
key
- A string giving the name of the property to be retrieved.- Returns:
- the value of the property, or null if the property has not been defined.
-
-