DeferredCDATASectionImpl.javaAPI DocJava SE 5 API5263Fri Aug 26 14:55:42 BST


public class DeferredCDATASectionImpl extends CDATASectionImpl implements DeferredNode
XML provides the CDATA markup to allow a region of text in which most of the XML delimiter recognition does not take place. This is intended to ease the task of quoting XML fragments and other programmatic information in a document's text without needing to escape these special characters. It's primarily a convenience feature for those who are hand-editing XML.

CDATASection is an Extended DOM feature, and is not used in HTML contexts.

Within the DOM, CDATASections are treated essentially as Text blocks. Their distinct type is retained in order to allow us to properly recreate the XML syntax when we write them out.

Reminder: CDATA IS NOT A COMPLETELY GENERAL SOLUTION; it can't quote its own end-of-block marking. If you need to write out a CDATA that contains the ]]> sequence, it's your responsibility to split that string over two successive CDATAs at that time.

CDATA does not participate in Element.normalize() processing.

$Id:,v 1.10 2002/01/29 01:15:07 lehors Exp $

Fields Summary
static final long
Serialization version.
protected transient int
Node index.
Constructors Summary
DeferredCDATASectionImpl(DeferredDocumentImpl ownerDocument, int nodeIndex)
This is the deferred constructor. Only the fNodeIndex is given here. All other data, can be requested from the ownerDocument via the index.

    // Constructors

        super(ownerDocument, null);

        fNodeIndex = nodeIndex;

Methods Summary
public intgetNodeIndex()
Returns the node index.

        return fNodeIndex;
protected voidsynchronizeData()
Synchronizes the data (name and value) for fast nodes.

        // no need to sync in the future

        // fluff data
        DeferredDocumentImpl ownerDocument =
            (DeferredDocumentImpl) this.ownerDocument();
        data = ownerDocument.getNodeValueString(fNodeIndex);