com.saxonica.pull

Class UnconstructedDocument

java.lang.Object

com.saxonica.pull.UnconstructedParent

com.saxonica.pull.UnconstructedDocument

All Implemented Interfaces:

Source, SourceLocator, PullEvent, ContextOriginator, Location, Item, NodeInfo, Sequence, Locator

public class UnconstructedDocument
extends UnconstructedParent

A document node whose construction is deferred.

(TODO) NOTE: this class is an exception to the general rule that for document nodes, node identity implies object identity

Field Summary

Fields inherited from class com.saxonica.pull.UnconstructedParent

instruction, node, savedXPathContext

Fields inherited from interface net.sf.saxon.om.NodeInfo

ALL_NAMESPACES, IS_DTD_TYPE, IS_NILLED, LOCAL_NAMESPACES, NO_NAMESPACES

Constructor Summary

Constructors

Constructor and Description
UnconstructedDocument(DocumentInstr instruction, XPathContext context) Create an unconstructed (pending) document node

Method Summary

Methods

Modifier and Type	Method and Description
String	getDisplayName() Get the display name of this node.
int	getFingerprint() Get fingerprint.
String	getLocalPart() Get the local part of the name of this node.
int	getNodeKind() Get the kind of node.
String	getPrefix() Get the prefix of the name of the node.
NodeInfo	getRootNode() Get the NodeInfo object representing the document node at the root of the tree
String[]	getUnparsedEntity(String name) Get the unparsed entity with a given name
Iterator<String>	getUnparsedEntityNames() Get the list of unparsed entities defined in this document
String	getURI() Get the URI part of the name of this node.
Object	getUserData(String key) Get user data held in the document node.
boolean	isTyped() Ask whether the document contains any nodes whose type annotation is anything other than UNTYPED
NodeInfo	selectID(String id, boolean getParent) Get the element with a given ID, if any
void	setUserData(String key, Object value) Set user data on the document node.

Methods inherited from class com.saxonica.pull.UnconstructedParent

atomize, compareOrder, comparePosition, copy, equals, generateId, getAttributeValue, getBaseURI, getColumnNumber, getConfiguration, getDeclaredNamespaces, getInstruction, getLineNumber, getNamePool, getParent, getPublicId, getPuller, getRoot, getSchemaType, getStringValue, getStringValueCS, getSystemId, getTreeInfo, getXPathContext, hasChildNodes, hashCode, head, isId, isIdref, isNilled, isSameNodeInfo, iterate, iterateAxis, iterateAxis, saveLocation, setSystemId

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UnconstructedDocument

public UnconstructedDocument(DocumentInstr instruction,
                     XPathContext context)

Create an unconstructed (pending) document node

Parameters:

instruction - the instruction responsible for creating the node

context - the XPath dynamic context

Method Detail

getRootNode

public NodeInfo getRootNode()

Get the NodeInfo object representing the document node at the root of the tree

Returns:

the document node

getNodeKind

public int getNodeKind()

Description copied from interface: NodeInfo

Get the kind of node. This will be a value such as Type.ELEMENT or Type.ATTRIBUTE. There are seven kinds of node: documents, elements, attributes, text, comments, processing-instructions, and namespaces.

Returns:

an integer identifying the kind of node. These integer values are the same as those used in the DOM

See Also:

Type

isTyped

public boolean isTyped()

Ask whether the document contains any nodes whose type annotation is anything other than UNTYPED

Returns:

true if the document contains elements whose type is other than UNTYPED

getFingerprint

public int getFingerprint()

Get fingerprint. The fingerprint is a coded form of the expanded name of the node: two nodes with the same name code have the same namespace URI and the same local name. A fingerprint of -1 should be returned for a node with no name.

Returns:

an integer fingerprint; two nodes with the same fingerprint have the same expanded QName

getLocalPart

public String getLocalPart()

Get the local part of the name of this node. This is the name after the ":" if any.

Returns:

the local part of the name. For an unnamed node, returns "". Unlike the DOM interface, this returns the full name in the case of a non-namespaced name.

getURI

public String getURI()

Get the URI part of the name of this node. This is the URI corresponding to the prefix, or the URI of the default namespace if appropriate.

Returns:

The URI of the namespace of this node. For an unnamed node, or for a node with an empty prefix, return an empty string.

getDisplayName

public String getDisplayName()

Get the display name of this node. For elements and attributes this is [prefix:]localname. For unnamed nodes, it is an empty string.

Returns:

The display name of this node. For a node with no name, return an empty string.

getPrefix

public String getPrefix()

Get the prefix of the name of the node. This is defined only for elements and attributes. If the node has no prefix, or for other kinds of node, return a zero-length string.

Returns:

The prefix of the name of the node.

selectID

public NodeInfo selectID(String id,
                boolean getParent)

Get the element with a given ID, if any

Parameters:

id - the required ID value

getParent -

Returns:

the element with the given ID, or null if there is no such ID present (or if the parser has not notified attributes as being of type ID)

Since:

8.4

getUnparsedEntityNames

public Iterator<String> getUnparsedEntityNames()

Get the list of unparsed entities defined in this document

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 String[] getUnparsedEntity(String name)

Get the unparsed entity with a given name

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, the method returns null. Applications should be written on the assumption that this array may be extended in the future to provide additional information.

Since:

8.4

setUserData

public void setUserData(String key,
               Object value)

Set user data on the document node. The user data can be retrieved subsequently using getUserData(java.lang.String)

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 Object getUserData(String key)

Get user data held in the document node. This retrieves properties previously set using setUserData(java.lang.String, java.lang.Object)

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.