Package com.icl.saxon.tinytree
Class TinyDocumentImpl
- java.lang.Object
-
- com.icl.saxon.om.AbstractNode
-
- com.icl.saxon.tinytree.TinyNodeImpl
-
- com.icl.saxon.tinytree.TinyParentNodeImpl
-
- com.icl.saxon.tinytree.TinyDocumentImpl
-
- All Implemented Interfaces:
DocumentInfo
,NodeInfo
,javax.xml.transform.dom.DOMLocator
,javax.xml.transform.Source
,javax.xml.transform.SourceLocator
,org.w3c.dom.Document
,org.w3c.dom.Node
public final class TinyDocumentImpl extends TinyParentNodeImpl implements DocumentInfo, org.w3c.dom.Document
A node in the XML parse tree representing the Document itself (or equivalently, the root node of the Document).- Version:
- 26 April 1999
- Author:
- Michael H. Kay
-
-
Field Summary
Fields Modifier and Type Field Description protected int[]
attCode
protected int[]
attParent
protected java.lang.String[]
attValue
protected char[]
charBuffer
protected int
charBufferLength
protected java.lang.StringBuffer
commentBuffer
protected short[]
depth
protected int
lastLevelOneNode
protected int[]
length
protected int[]
nameCode
protected int[]
namespaceCode
protected int[]
namespaceParent
protected int[]
next
protected byte[]
nodeType
protected int
numberOfAttributes
protected int
numberOfNamespaces
protected int
numberOfNodes
protected int[]
offset
protected int[]
prior
-
Fields inherited from class com.icl.saxon.tinytree.TinyNodeImpl
document, nodeNr, parent
-
Fields inherited from class com.icl.saxon.om.AbstractNode
NODE_LETTER
-
Fields inherited from interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
-
-
Constructor Summary
Constructors Constructor Description TinyDocumentImpl()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
addAttribute(int parent0, int code0, java.lang.String type0, java.lang.String value0)
protected void
addNamespace(int parent0, int nscode0)
protected void
addNode(short type0, int depth0, int offset0, int length0, int nameCode0)
org.w3c.dom.Node
adoptNode(org.w3c.dom.Node source)
Attempts to adopt a node from another document to this document.protected void
appendChars(char[] chars, int start, int length)
void
copy(Outputter out)
Copy this node to a given outputtervoid
diagnosticDump()
Produce diagnostic print of main tree arraysprotected void
ensureAttributeCapacity()
protected void
ensureNamespaceCapacity()
protected void
ensureNodeCapacity()
protected void
ensurePriorIndex()
On demand, make an index for quick access to preceding-sibling nodesjava.lang.String
generateId()
Get a character string that uniquely identifies this node within the documentprotected AxisEnumeration
getAllElements(int fingerprint)
Get a list of all elements with a given name.protected TinyAttributeImpl
getAttributeNode(int nr)
Make a (transient) attribute node from the array of attributesjava.lang.String
getBaseURI()
Get the base URI of this root node.DocumentInfo
getDocumentRoot()
Get the root (document) nodejava.lang.String
getDocumentURI()
The location of the document ornull
if undefined or if theDocument
was created usingDOMImplementation.createDocument
.org.w3c.dom.DOMConfiguration
getDomConfig()
The configuration used whenDocument.normalizeDocument()
is invoked.java.lang.String
getInputEncoding()
An attribute specifying the encoding used for this document at the time of the parsing.java.util.Hashtable
getKeyIndex(KeyManager keymanager, int fingerprint)
Get the index for a given keyint
getLineNumber()
Get the line number of this root node.protected int
getLineNumber(int sequence)
Get the line number for an element.NamePool
getNamePool()
Get the name pool used for the names in this documentprotected TinyNamespaceImpl
getNamespaceNode(int nr)
Make a (transient) namespace node from the array of namespace declarationsTinyNodeImpl
getNode(int nr)
short
getNodeType()
Return the type of node.NodeInfo
getParent()
Find the parent node of this node.long
getSequenceNumber()
Get the node sequence number (in document order).boolean
getStrictErrorChecking()
An attribute specifying whether error checking is enforced or not.java.lang.String
getSystemId()
Get the system id of this root nodeprotected java.lang.String
getSystemId(int seq)
Get the system id of an element in the documentjava.lang.String
getUnparsedEntity(java.lang.String name)
Get the unparsed entity with a given namejava.lang.String
getXmlEncoding()
An attribute specifying, as part of the XML declaration, the encoding of this document.boolean
getXmlStandalone()
An attribute specifying, as part of the XML declaration, whether this document is standalone.java.lang.String
getXmlVersion()
An attribute specifying, as part of the XML declaration, the version number of this document.protected boolean
isUsingNamespaces()
determine whether this document uses namespacesvoid
normalizeDocument()
This method acts as if the document was going through a save and load cycle, putting the document in a "normal" form.org.w3c.dom.Node
renameNode(org.w3c.dom.Node n, java.lang.String namespaceURI, java.lang.String qualifiedName)
Rename an existing node of typeELEMENT_NODE
orATTRIBUTE_NODE
.NodeInfo
selectID(java.lang.String id)
Get the element with a given ID.void
setDocumentURI(java.lang.String documentURI)
The location of the document ornull
if undefined or if theDocument
was created usingDOMImplementation.createDocument
.void
setKeyIndex(KeyManager keymanager, int fingerprint, java.util.Hashtable keyindex)
Set the index for a given key.protected void
setLineNumber(int sequence, int line)
Set the line number for an element.void
setLineNumbering()
Set line numbering onvoid
setNamePool(NamePool pool)
Set the name pool used for all names in this documentvoid
setStrictErrorChecking(boolean strictErrorChecking)
An attribute specifying whether error checking is enforced or not.protected 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 of this nodeprotected void
setUnparsedEntity(java.lang.String name, java.lang.String uri)
Set an unparsed entity URI associated with this document.void
setXmlStandalone(boolean xmlStandalone)
An attribute specifying, as part of the XML declaration, whether this document is standalone.void
setXmlVersion(java.lang.String xmlVersion)
An attribute specifying, as part of the XML declaration, the version number of this document.protected void
truncate(int nodes)
Truncate the tree: used in preview mode to delete an element after it has been processed-
Methods inherited from class com.icl.saxon.tinytree.TinyParentNodeImpl
copyStringValue, getStringValue, hasChildNodes
-
Methods inherited from class com.icl.saxon.tinytree.TinyNodeImpl
compareOrder, getAttributeValue, getAttributeValue, getDisplayName, getEnumeration, getFingerprint, getLocalName, getNameCode, getOriginatingNode, getPrefix, getURI, hasAttributes, isSameNodeInfo, outputNamespaceNodes, setLineNumber, setParentNode
-
Methods inherited from class com.icl.saxon.om.AbstractNode
appendChild, appendData, cloneNode, compareDocumentPosition, createAttribute, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createElement, createElementNS, createEntityReference, createProcessingInstruction, createTextNode, deleteData, disallowUpdate, getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getChildNodes, getColumnNumber, getData, getDoctype, getDocumentElement, getElementById, getElementsByTagName, getElementsByTagNameNS, getFeature, getFirstChild, getImplementation, getLastChild, getLength, getName, getNamespaceURI, getNextSibling, getNodeName, getNodeValue, getOwnerDocument, getOwnerElement, getParentNode, getPreviousSibling, getPublicId, getSchemaTypeInfo, getSpecified, getTagName, getTextContent, getUserData, getValue, getWholeText, hasAttribute, hasAttributeNS, importNode, insertBefore, insertData, isDefaultNamespace, isElementContentWhitespace, isEqualNode, isId, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeAttribute, removeAttributeNode, removeAttributeNS, removeChild, replaceChild, replaceData, replaceWholeText, setAttributeNode, setAttributeNodeNS, setAttributeNS, setData, setIdAttribute, setIdAttributeNode, setIdAttributeNS, setNodeValue, setPrefix, setTextContent, setUserData, setValue, splitText, substringData, supports
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.w3c.dom.Document
createAttribute, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createElement, createElementNS, createEntityReference, createProcessingInstruction, createTextNode, getDoctype, getDocumentElement, getElementById, getElementsByTagName, getElementsByTagNameNS, getImplementation, importNode
-
Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
-
Methods inherited from interface com.icl.saxon.om.NodeInfo
compareOrder, copyStringValue, getAttributeValue, getAttributeValue, getDisplayName, getEnumeration, getFingerprint, getLocalName, getNameCode, getPrefix, getStringValue, getURI, hasChildNodes, isSameNodeInfo, outputNamespaceNodes
-
-
-
-
Field Detail
-
charBuffer
protected char[] charBuffer
-
charBufferLength
protected int charBufferLength
-
commentBuffer
protected java.lang.StringBuffer commentBuffer
-
numberOfNodes
protected int numberOfNodes
-
lastLevelOneNode
protected int lastLevelOneNode
-
nodeType
protected byte[] nodeType
-
depth
protected short[] depth
-
next
protected int[] next
-
offset
protected int[] offset
-
length
protected int[] length
-
nameCode
protected int[] nameCode
-
prior
protected int[] prior
-
numberOfAttributes
protected int numberOfAttributes
-
attParent
protected int[] attParent
-
attCode
protected int[] attCode
-
attValue
protected java.lang.String[] attValue
-
numberOfNamespaces
protected int numberOfNamespaces
-
namespaceParent
protected int[] namespaceParent
-
namespaceCode
protected int[] namespaceCode
-
-
Method Detail
-
setNamePool
public void setNamePool(NamePool pool)
Set the name pool used for all names in this document- Specified by:
setNamePool
in interfaceDocumentInfo
-
getNamePool
public NamePool getNamePool()
Get the name pool used for the names in this document- Specified by:
getNamePool
in interfaceDocumentInfo
-
ensureNodeCapacity
protected void ensureNodeCapacity()
-
ensureAttributeCapacity
protected void ensureAttributeCapacity()
-
ensureNamespaceCapacity
protected void ensureNamespaceCapacity()
-
addNode
protected void addNode(short type0, int depth0, int offset0, int length0, int nameCode0)
-
appendChars
protected void appendChars(char[] chars, int start, int length)
-
truncate
protected void truncate(int nodes)
Truncate the tree: used in preview mode to delete an element after it has been processed
-
ensurePriorIndex
protected void ensurePriorIndex()
On demand, make an index for quick access to preceding-sibling nodes
-
addAttribute
protected void addAttribute(int parent0, int code0, java.lang.String type0, java.lang.String value0)
-
addNamespace
protected void addNamespace(int parent0, int nscode0)
-
getNode
public TinyNodeImpl getNode(int nr)
-
getSequenceNumber
public long getSequenceNumber()
Get the node sequence number (in document order). Sequence numbers are monotonic but not consecutive.- Overrides:
getSequenceNumber
in classTinyNodeImpl
-
getAttributeNode
protected TinyAttributeImpl getAttributeNode(int nr)
Make a (transient) attribute node from the array of attributes
-
isUsingNamespaces
protected boolean isUsingNamespaces()
determine whether this document uses namespaces
-
getNamespaceNode
protected TinyNamespaceImpl getNamespaceNode(int nr)
Make a (transient) namespace node from the array of namespace declarations
-
setSystemId
public void setSystemId(java.lang.String uri)
Set the system id of this node- Specified by:
setSystemId
in interfacejavax.xml.transform.Source
- Overrides:
setSystemId
in classTinyNodeImpl
-
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 classTinyNodeImpl
- Returns:
- the System Identifier of the entity in the source document containing the node, or null if not known. Note this is not the same as the base URI: the base URI can be modified by xml:base, but the system ID cannot.
-
getBaseURI
public java.lang.String getBaseURI()
Get the base URI of this root node. For a root node the base URI is the same as the System ID.- Specified by:
getBaseURI
in interfaceorg.w3c.dom.Node
- Specified by:
getBaseURI
in interfaceNodeInfo
- Overrides:
getBaseURI
in classTinyNodeImpl
-
setSystemId
protected void setSystemId(int seq, java.lang.String uri)
Set the system id of an element in the document
-
getSystemId
protected java.lang.String getSystemId(int seq)
Get the system id of an element in the document
-
setLineNumbering
public void setLineNumbering()
Set line numbering on
-
setLineNumber
protected void setLineNumber(int sequence, int line)
Set the line number for an element. Ignored if line numbering is off.
-
getLineNumber
protected int getLineNumber(int sequence)
Get the line number for an element. Return -1 if line numbering is off.
-
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 classTinyNodeImpl
- Returns:
- 0 always
-
getNodeType
public final short getNodeType()
Return the type of node.- Specified by:
getNodeType
in interfaceorg.w3c.dom.Node
- Specified by:
getNodeType
in interfaceNodeInfo
- Returns:
- NodeInfo.ROOT (always)
-
getParent
public NodeInfo getParent()
Find the parent node of this node.- Specified by:
getParent
in interfaceNodeInfo
- Overrides:
getParent
in classTinyNodeImpl
- Returns:
- The Node object describing the containing element or root node.
-
getDocumentRoot
public DocumentInfo getDocumentRoot()
Get the root (document) node- Specified by:
getDocumentRoot
in interfaceNodeInfo
- Overrides:
getDocumentRoot
in classTinyNodeImpl
- Returns:
- the DocumentInfo representing this document
-
generateId
public java.lang.String generateId()
Get a character string that uniquely identifies this node within the document- Specified by:
generateId
in interfaceNodeInfo
- Overrides:
generateId
in classTinyNodeImpl
- Returns:
- the empty string
-
getAllElements
protected AxisEnumeration getAllElements(int fingerprint)
Get a list of all elements with a given name. This is implemented as a memo function: the first time it is called for a particular element type, it remembers the result for next time.
-
selectID
public NodeInfo selectID(java.lang.String id)
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()- Returns:
- The NodeInfo (always an Element) for the given ID if one has been registered, otherwise null.
-
getKeyIndex
public java.util.Hashtable getKeyIndex(KeyManager keymanager, int fingerprint)
Get the index for a given key- Specified by:
getKeyIndex
in interfaceDocumentInfo
- Parameters:
keymanager
- The key manager managing this keyfingerprint
- The fingerprint of the name of the key (unique with the key manager)- Returns:
- The index, if one has been built, in the form of a Hashtable that maps the key value to a set of nodes having that key value. If no index has been built, returns null.
-
setKeyIndex
public void setKeyIndex(KeyManager keymanager, int fingerprint, java.util.Hashtable keyindex)
Set the index for a given key. The method is synchronized because the same document can be used by several stylesheets at the same time.- Specified by:
setKeyIndex
in interfaceDocumentInfo
- Parameters:
keymanager
- The key manager managing this keyfingerprint
- The fingerprint of the name of the key (unique with the key manager)keyindex
- the index, in the form of a Hashtable that maps the key value to a set of nodes having that key value. Or the String "under construction", indicating that the index is being built.
-
setUnparsedEntity
protected void setUnparsedEntity(java.lang.String name, java.lang.String uri)
Set an unparsed entity URI associated with this document. For system use only, while building the document.
-
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:
- the URI of the entity if there is one, or empty string if not
-
copy
public void copy(Outputter out) throws javax.xml.transform.TransformerException
Copy this node to a given outputter
-
diagnosticDump
public void diagnosticDump()
Produce diagnostic print of main tree arrays
-
adoptNode
public org.w3c.dom.Node adoptNode(org.w3c.dom.Node source) throws org.w3c.dom.DOMException
Attempts to adopt a node from another document to this document.- Specified by:
adoptNode
in interfaceorg.w3c.dom.Document
- Parameters:
source
- The node to move into this document.- Returns:
- The adopted node, or
null
if this operation fails, such as when the source node comes from a different implementation. - Throws:
org.w3c.dom.DOMException
- NOT_SUPPORTED_ERR: Raised if the source node is of typeDOCUMENT
,DOCUMENT_TYPE
.
NO_MODIFICATION_ALLOWED_ERR: Raised when the source node is readonly.- Since:
- DOM Level 3
-
getDocumentURI
public java.lang.String getDocumentURI()
The location of the document ornull
if undefined or if theDocument
was created usingDOMImplementation.createDocument
. No lexical checking is performed when setting this attribute; this could result in anull
value returned when usingNode.baseURI
.
Beware that when theDocument
supports the feature "HTML" [DOM Level 2 HTML] , the href attribute of the HTML BASE element takes precedence over this attribute when computingNode.baseURI
.- Specified by:
getDocumentURI
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
getDomConfig
public org.w3c.dom.DOMConfiguration getDomConfig()
The configuration used whenDocument.normalizeDocument()
is invoked.- Specified by:
getDomConfig
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
getInputEncoding
public java.lang.String getInputEncoding()
An attribute specifying the encoding used for this document at the time of the parsing. This isnull
when it is not known, such as when theDocument
was created in memory.- Specified by:
getInputEncoding
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
getStrictErrorChecking
public boolean getStrictErrorChecking()
An attribute specifying whether error checking is enforced or not. When set tofalse
, the implementation is free to not test every possible error case normally defined on DOM operations, and not raise anyDOMException
on DOM operations or report errors while usingDocument.normalizeDocument()
. In case of error, the behavior is undefined. This attribute istrue
by default.- Specified by:
getStrictErrorChecking
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
getXmlEncoding
public java.lang.String getXmlEncoding()
An attribute specifying, as part of the XML declaration, the encoding of this document. This isnull
when unspecified or when it is not known, such as when theDocument
was created in memory.- Specified by:
getXmlEncoding
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
getXmlStandalone
public boolean getXmlStandalone()
An attribute specifying, as part of the XML declaration, whether this document is standalone. This isfalse
when unspecified.Note: No verification is done on the value when setting this attribute. Applications should use
Document.normalizeDocument()
with the "validate" parameter to verify if the value matches the validity constraint for standalone document declaration as defined in [XML 1.0].- Specified by:
getXmlStandalone
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
getXmlVersion
public java.lang.String getXmlVersion()
An attribute specifying, as part of the XML declaration, the version number of this document. If there is no declaration and if this document supports the "XML" feature, the value is"1.0"
.- Specified by:
getXmlVersion
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
normalizeDocument
public void normalizeDocument()
This method acts as if the document was going through a save and load cycle, putting the document in a "normal" form.- Specified by:
normalizeDocument
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
renameNode
public org.w3c.dom.Node renameNode(org.w3c.dom.Node n, java.lang.String namespaceURI, java.lang.String qualifiedName) throws org.w3c.dom.DOMException
Rename an existing node of typeELEMENT_NODE
orATTRIBUTE_NODE
.- Specified by:
renameNode
in interfaceorg.w3c.dom.Document
- Parameters:
n
- The node to rename.namespaceURI
- The new namespace URI.qualifiedName
- The new qualified name.- Returns:
- The renamed node. This is either the specified node or the new node that was created to replace the specified node.
- Throws:
org.w3c.dom.DOMException
- NOT_SUPPORTED_ERR: Raised when the type of the specified node is neitherELEMENT_NODE
norATTRIBUTE_NODE
, or if the implementation does not support the renaming of the document element.
INVALID_CHARACTER_ERR: Raised if the new qualified name is not an XML name according to the XML version in use specified in theDocument.xmlVersion
attribute.
WRONG_DOCUMENT_ERR: Raised when the specified node was created from a different document than this document.
NAMESPACE_ERR: Raised if thequalifiedName
is a malformed qualified name, if thequalifiedName
has a prefix and thenamespaceURI
isnull
, or if thequalifiedName
has a prefix that is "xml" and thenamespaceURI
is different from " http://www.w3.org/XML/1998/namespace" [XML Namespaces] . Also raised, when the node being renamed is an attribute, if thequalifiedName
, or its prefix, is "xmlns" and thenamespaceURI
is different from "http://www.w3.org/2000/xmlns/".- Since:
- DOM Level 3
-
setDocumentURI
public void setDocumentURI(java.lang.String documentURI)
The location of the document ornull
if undefined or if theDocument
was created usingDOMImplementation.createDocument
. No lexical checking is performed when setting this attribute; this could result in anull
value returned when usingNode.baseURI
.
Beware that when theDocument
supports the feature "HTML" [DOM Level 2 HTML] , the href attribute of the HTML BASE element takes precedence over this attribute when computingNode.baseURI
.- Specified by:
setDocumentURI
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
setStrictErrorChecking
public void setStrictErrorChecking(boolean strictErrorChecking)
An attribute specifying whether error checking is enforced or not. When set tofalse
, the implementation is free to not test every possible error case normally defined on DOM operations, and not raise anyDOMException
on DOM operations or report errors while usingDocument.normalizeDocument()
. In case of error, the behavior is undefined. This attribute istrue
by default.- Specified by:
setStrictErrorChecking
in interfaceorg.w3c.dom.Document
- Since:
- DOM Level 3
-
setXmlStandalone
public void setXmlStandalone(boolean xmlStandalone) throws org.w3c.dom.DOMException
An attribute specifying, as part of the XML declaration, whether this document is standalone. This isfalse
when unspecified.Note: No verification is done on the value when setting this attribute. Applications should use
Document.normalizeDocument()
with the "validate" parameter to verify if the value matches the validity constraint for standalone document declaration as defined in [XML 1.0].- Specified by:
setXmlStandalone
in interfaceorg.w3c.dom.Document
- Throws:
org.w3c.dom.DOMException
- NOT_SUPPORTED_ERR: Raised if this document does not support the "XML" feature.- Since:
- DOM Level 3
-
setXmlVersion
public void setXmlVersion(java.lang.String xmlVersion) throws org.w3c.dom.DOMException
An attribute specifying, as part of the XML declaration, the version number of this document. If there is no declaration and if this document supports the "XML" feature, the value is"1.0"
. If this document does not support the "XML" feature, the value is alwaysnull
. Changing this attribute will affect methods that check for invalid characters in XML names. Application should invokeDocument.normalizeDocument()
in order to check for invalid characters in theNode
s that are already part of thisDocument
.
DOM applications may use theDOMImplementation.hasFeature(feature, version)
method with parameter values "XMLVersion" and "1.0" (respectively) to determine if an implementation supports [XML 1.0]. DOM applications may use the same method with parameter values "XMLVersion" and "1.1" (respectively) to determine if an implementation supports [XML 1.1]. In both cases, in order to support XML, an implementation must also support the "XML" feature defined in this specification.Document
objects supporting a version of the "XMLVersion" feature must not raise aNOT_SUPPORTED_ERR
exception for the same version number when usingDocument.xmlVersion
.- Specified by:
setXmlVersion
in interfaceorg.w3c.dom.Document
- Throws:
org.w3c.dom.DOMException
- NOT_SUPPORTED_ERR: Raised if the version is set to a value that is not supported by thisDocument
or if this document does not support the "XML" feature.- Since:
- DOM Level 3
-
-