Package net.sf.saxon.option.xom
Class XOMDocumentWrapper
java.lang.Object
net.sf.saxon.tree.wrapper.AbstractNodeWrapper
net.sf.saxon.option.xom.XOMNodeWrapper
net.sf.saxon.option.xom.XOMDocumentWrapper
- All Implemented Interfaces:
Source
,SourceLocator
,ActiveSource
,GroundedValue
,Item
,NodeInfo
,Sequence
,TreeInfo
,Location
,SteppingNode
,SiblingCountingNode
,VirtualNode
,Locator
The root node of an XPath tree. (Or equivalently, the tree itself).
This class is used not only for a document, but also for the root of a document-less tree fragment.
-
Field Summary
FieldsFields inherited from class net.sf.saxon.option.xom.XOMNodeWrapper
docWrapper, index, node, nodeKind
Fields inherited from class net.sf.saxon.tree.wrapper.AbstractNodeWrapper
treeInfo
-
Constructor Summary
ConstructorsConstructorDescriptionXOMDocumentWrapper
(nu.xom.Node root, Configuration config) Create a Saxon wrapper for a XOM root node -
Method Summary
Modifier and TypeMethodDescriptionGet the configuration previously set using setConfigurationlong
Get the unique document number for this document (the number is unique for all documents within a NamePool)Get the durability of nodes in the tree.Get the name pool used for the names in this documentGet the NodeInfo object representing the document node at the root of the treeGet details of space stripping action that was applied to this document during construction.String[]
getUnparsedEntity
(String name) Get the unparsed entity with a given nameGet the list of unparsed entities defined in this documentgetUserData
(String key) Get user data held in the document node.Get the element with a given ID, if anyvoid
setConfiguration
(Configuration config) Set the configuration, which defines the name pool used for all names in this document.void
Set details of space stripping action that was applied to this document during construction.void
setSystemId
(String uri) Set the system ID.void
setUserData
(String key, Object value) Set user data on the document node.wrap
(nu.xom.Node node) Wrap a node in the XOM document.Methods inherited from class net.sf.saxon.option.xom.XOMNodeWrapper
atomize, compareOrder, equals, generateId, getAllNamespaces, getAttributeValue, getBaseURI, getDeclaredNamespaces, getDisplayName, getFirstChild, getLocalPart, getNamespaceUri, getNextSibling, getNodeKind, getParent, getPrefix, getPreviousSibling, getRoot, getSiblingPosition, getSuccessorElement, getSystemId, getUnderlyingNode, getUnicodeStringValue, hasChildNodes, hashCode, isId, isIdref, iterateAttributes, iterateChildren, iterateDescendants, iterateSiblings, makeWrapper, makeWrapper
Methods inherited from class net.sf.saxon.tree.wrapper.AbstractNodeWrapper
getColumnNumber, getFingerprint, getLineNumber, getRealNode, getTreeInfo, hasFingerprint, iterateAxis, iterateAxis, saveLocation
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface net.sf.saxon.om.GroundedValue
asIterable, concatenate, containsNode, effectiveBooleanValue, materialize
Methods inherited from interface net.sf.saxon.om.Item
getLength, getStringValue, head, itemAt, iterate, reduce, subsequence
Methods inherited from interface net.sf.saxon.s9api.Location
saveLocation
Methods inherited from interface net.sf.saxon.om.NodeInfo
asActiveSource, attributes, children, children, copy, deliver, getAttributeValue, getColumnNumber, getFingerprint, getGenre, getLineNumber, getPublicId, getSchemaType, getTreeInfo, getURI, hasFingerprint, isNilled, isSameNodeInfo, isStreamed, iterateAxis, iterateAxis, toShortString
Methods inherited from interface net.sf.saxon.om.Sequence
makeRepeatable
-
Field Details
-
config
-
documentNumber
protected long documentNumber
-
-
Constructor Details
-
XOMDocumentWrapper
Create a Saxon wrapper for a XOM root node- Parameters:
root
- The XOM root nodeconfig
- The configuration which defines the name pool used for all names in this tree
-
-
Method Details
-
getRootNode
Get the NodeInfo object representing the document node at the root of the tree- Specified by:
getRootNode
in interfaceTreeInfo
- Returns:
- the document node
-
wrap
Wrap a node in the XOM document.- Parameters:
node
- The node to be wrapped. This must be a node in the same document (the system does not check for this).- Returns:
- the wrapping NodeInfo object
-
setConfiguration
Set the configuration, which defines the name pool used for all names in this document. This is always called after a new document has been created. The implementation must register the name pool with the document, so that it can be retrieved using getNamePool(). It must also call NamePool.allocateDocumentNumber(), and return the relevant document number when getDocumentNumber() is subsequently called.- Parameters:
config
- The configuration to be used
-
getConfiguration
Get the configuration previously set using setConfiguration- Specified by:
getConfiguration
in interfaceNodeInfo
- Specified by:
getConfiguration
in interfaceTreeInfo
- Overrides:
getConfiguration
in classXOMNodeWrapper
- Returns:
- the Configuration to which the tree belongs. The default implementation invokes
getTreeInfo().getConfiguration()
.
-
getNamePool
Get the name pool used for the names in this document- Overrides:
getNamePool
in classXOMNodeWrapper
- Returns:
- the name pool in which all the names used in this document are registered
-
setSystemId
Description copied from class:AbstractNodeWrapper
Set the system ID. Required because NodeInfo implements the JAXP Source interface- Specified by:
setSystemId
in interfaceNodeInfo
- Specified by:
setSystemId
in interfaceSource
- Overrides:
setSystemId
in classAbstractNodeWrapper
- Parameters:
uri
- the system ID.
-
getDocumentNumber
public long getDocumentNumber()Get the unique document number for this document (the number is unique for all documents within a NamePool)- Specified by:
getDocumentNumber
in interfaceTreeInfo
- Returns:
- the unique number identifying this document within the name pool
-
getDurability
Description copied from interface:TreeInfo
Get the durability of nodes in the tree. This affects how they are handled in a memo function cache, to optimize memory and garbage collection. By default, all nodes are considered durable unless otherwise specified- Specified by:
getDurability
in interfaceTreeInfo
- Returns:
- the durability property of this node tree
-
selectID
Get the element with a given ID, if any -
getUnparsedEntityNames
Get the list of unparsed entities defined in this document- Specified by:
getUnparsedEntityNames
in interfaceTreeInfo
- 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
Get the unparsed entity with a given name- Specified by:
getUnparsedEntity
in interfaceTreeInfo
- Parameters:
name
- the name of the entity- Returns:
- null: XOM does not provide access to unparsed entities
-
setSpaceStrippingRule
Set details of space stripping action that was applied to this document during construction. This ensures that space stripping is not applied twice to the same document.- Specified by:
setSpaceStrippingRule
in interfaceTreeInfo
- Parameters:
rule
- details of the space stripping rules that have been applied to this document during its construction.- Since:
- 9.9
-
getSpaceStrippingRule
Get details of space stripping action that was applied to this document during construction. This ensures that space stripping is not applied twice to the same document.- Specified by:
getSpaceStrippingRule
in interfaceTreeInfo
- Returns:
- details of the space stripping rules that have been applied to this
document during its construction. By default, returns
NoElementsSpaceStrippingRule
, indicating that no space stripping has been applied - Since:
- 9.9
-
setUserData
Set user data on the document node. The user data can be retrieved subsequently usinggetUserData(java.lang.String)
- Specified by:
setUserData
in interfaceTreeInfo
- 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
Get user data held in the document node. This retrieves properties previously set usingsetUserData(java.lang.String, java.lang.Object)
- Specified by:
getUserData
in interfaceTreeInfo
- 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.
-