Class 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 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
    • Constructor Detail

      • TinyDocumentImpl

        public TinyDocumentImpl()
    • Method Detail

      • setNamePool

        public void setNamePool​(NamePool pool)
        Set the name pool used for all names in this document
        Specified by:
        setNamePool in interface DocumentInfo
      • 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)
      • getSequenceNumber

        public long getSequenceNumber()
        Get the node sequence number (in document order). Sequence numbers are monotonic but not consecutive.
        Overrides:
        getSequenceNumber in class TinyNodeImpl
      • 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 interface javax.xml.transform.Source
        Overrides:
        setSystemId in class TinyNodeImpl
      • getSystemId

        public java.lang.String getSystemId()
        Get the system id of this root node
        Specified by:
        getSystemId in interface NodeInfo
        Specified by:
        getSystemId in interface javax.xml.transform.Source
        Specified by:
        getSystemId in interface javax.xml.transform.SourceLocator
        Overrides:
        getSystemId in class TinyNodeImpl
        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 interface org.w3c.dom.Node
        Specified by:
        getBaseURI in interface NodeInfo
        Overrides:
        getBaseURI in class TinyNodeImpl
      • 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 interface NodeInfo
        Specified by:
        getLineNumber in interface javax.xml.transform.SourceLocator
        Overrides:
        getLineNumber in class TinyNodeImpl
        Returns:
        0 always
      • getNodeType

        public final short getNodeType()
        Return the type of node.
        Specified by:
        getNodeType in interface org.w3c.dom.Node
        Specified by:
        getNodeType in interface NodeInfo
        Returns:
        NodeInfo.ROOT (always)
      • getParent

        public NodeInfo getParent()
        Find the parent node of this node.
        Specified by:
        getParent in interface NodeInfo
        Overrides:
        getParent in class TinyNodeImpl
        Returns:
        The Node object describing the containing element or root node.
      • generateId

        public java.lang.String generateId()
        Get a character string that uniquely identifies this node within the document
        Specified by:
        generateId in interface NodeInfo
        Overrides:
        generateId in class TinyNodeImpl
        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 interface DocumentInfo
        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 interface DocumentInfo
        Parameters:
        keymanager - The key manager managing this key
        fingerprint - 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 interface DocumentInfo
        Parameters:
        keymanager - The key manager managing this key
        fingerprint - 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 interface DocumentInfo
        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
        Specified by:
        copy in interface NodeInfo
        Throws:
        javax.xml.transform.TransformerException
      • 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 interface org.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 type DOCUMENT, 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 or null if undefined or if the Document was created using DOMImplementation.createDocument. No lexical checking is performed when setting this attribute; this could result in a null value returned when using Node.baseURI .
        Beware that when the Document supports the feature "HTML" [DOM Level 2 HTML] , the href attribute of the HTML BASE element takes precedence over this attribute when computing Node.baseURI.
        Specified by:
        getDocumentURI in interface org.w3c.dom.Document
        Since:
        DOM Level 3
      • getDomConfig

        public org.w3c.dom.DOMConfiguration getDomConfig()
        The configuration used when Document.normalizeDocument() is invoked.
        Specified by:
        getDomConfig in interface org.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 is null when it is not known, such as when the Document was created in memory.
        Specified by:
        getInputEncoding in interface org.w3c.dom.Document
        Since:
        DOM Level 3
      • getStrictErrorChecking

        public boolean getStrictErrorChecking()
        An attribute specifying whether error checking is enforced or not. When set to false, the implementation is free to not test every possible error case normally defined on DOM operations, and not raise any DOMException on DOM operations or report errors while using Document.normalizeDocument(). In case of error, the behavior is undefined. This attribute is true by default.
        Specified by:
        getStrictErrorChecking in interface org.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 is null when unspecified or when it is not known, such as when the Document was created in memory.
        Specified by:
        getXmlEncoding in interface org.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 is false 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 interface org.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 interface org.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 interface org.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 type ELEMENT_NODE or ATTRIBUTE_NODE.
        Specified by:
        renameNode in interface org.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 neither ELEMENT_NODE nor ATTRIBUTE_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 the Document.xmlVersion attribute.
        WRONG_DOCUMENT_ERR: Raised when the specified node was created from a different document than this document.
        NAMESPACE_ERR: Raised if the qualifiedName is a malformed qualified name, if the qualifiedName has a prefix and the namespaceURI is null, or if the qualifiedName has a prefix that is "xml" and the namespaceURI is different from " http://www.w3.org/XML/1998/namespace" [XML Namespaces] . Also raised, when the node being renamed is an attribute, if the qualifiedName, or its prefix, is "xmlns" and the namespaceURI 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 or null if undefined or if the Document was created using DOMImplementation.createDocument. No lexical checking is performed when setting this attribute; this could result in a null value returned when using Node.baseURI .
        Beware that when the Document supports the feature "HTML" [DOM Level 2 HTML] , the href attribute of the HTML BASE element takes precedence over this attribute when computing Node.baseURI.
        Specified by:
        setDocumentURI in interface org.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 to false, the implementation is free to not test every possible error case normally defined on DOM operations, and not raise any DOMException on DOM operations or report errors while using Document.normalizeDocument(). In case of error, the behavior is undefined. This attribute is true by default.
        Specified by:
        setStrictErrorChecking in interface org.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 is false 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 interface org.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 always null. Changing this attribute will affect methods that check for invalid characters in XML names. Application should invoke Document.normalizeDocument() in order to check for invalid characters in the Nodes that are already part of this Document.
        DOM applications may use the DOMImplementation.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 a NOT_SUPPORTED_ERR exception for the same version number when using Document.xmlVersion.
        Specified by:
        setXmlVersion in interface org.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 this Document or if this document does not support the "XML" feature.
        Since:
        DOM Level 3