org.apache.xerces.dom
Class CharacterDataImpl

java.lang.Object
  |
  +--org.apache.xerces.dom.NodeImpl
        |
        +--org.apache.xerces.dom.CharacterDataImpl
Direct Known Subclasses:
CommentImpl, TextImpl

public abstract class CharacterDataImpl
extends NodeImpl
implements CharacterData

CharacterData is an abstract Node that can carry character data as its Value. It provides shared behavior for Text, CData, and possibly other node types. All offsets are 0-based.

This implementation includes support for DOM Level 2 Mutation Events. If the static boolean NodeImpl.MUTATIONEVENTS is not set true, that support is disabled and can be optimized out to reduce code size.

Since:
PR-DOM-Level-1-19980818.
Version:
 
See Also:
Serialized Form

Fields inherited from class org.apache.xerces.dom.NodeImpl
ELEMENT_DEFINITION_NODE, fInternalSetNodeValue, MUTATION_AGGREGATE, MUTATION_ALL, MUTATION_LOCAL, MUTATION_NONE, MUTATIONEVENTS, name, nextSibling, ownerDocument, parentNode, previousSibling, readOnly, syncData, userData, value
 
Fields inherited from interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
Constructor Summary
protected CharacterDataImpl(DocumentImpl ownerDocument, java.lang.String data)
          Factory constructor.
 
Method Summary
 void appendData(java.lang.String data)
          Concatenate additional characters onto the end of the data stored in this node.
 void deleteData(int offset, int count)
          Remove a range of characters from the node's value.
 NodeList getChildNodes()
          Returns an empty node list.
 java.lang.String getData()
          Retrieve character data currently stored in this node.
 int getLength()
          Report number of characters currently stored in this node's data.
abstract  java.lang.String getNodeName()
          Returns the node name.
 void insertData(int offset, java.lang.String data)
          Insert additional characters into the data stored in this node, at the offset specified.
 void replaceData(int offset, int count, java.lang.String data)
          Replace a series of characters at the specified (zero-based) offset with a new string, NOT necessarily of the same length.
 void setData(java.lang.String value)
          Store character data into this node.
 java.lang.String substringData(int offset, int count)
          Substring is more than a convenience function.
 
Methods inherited from class org.apache.xerces.dom.NodeImpl
addEventListener, appendChild, changed, cloneNode, dispatchEvent, finalize, getAttributes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getReadOnly, getUserData, hasChildNodes, insertBefore, item, normalize, removeChild, removeEventListener, replaceChild, setNodeValue, setPrefix, setReadOnly, setUserData, supports, synchronizeData, toString
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CharacterDataImpl

protected CharacterDataImpl(DocumentImpl ownerDocument,
                            java.lang.String data)
Factory constructor.
Method Detail

getNodeName

public abstract java.lang.String getNodeName()
Returns the node name.
Overrides:
getNodeName in class NodeImpl

getChildNodes

public NodeList getChildNodes()
Returns an empty node list.
Overrides:
getChildNodes in class NodeImpl

getData

public java.lang.String getData()
Retrieve character data currently stored in this node.
Specified by:
getData in interface CharacterData
Throws:
DOMExcpetion(DOMSTRING_SIZE_ERR) - In some implementations, the stored data may exceed the permitted length of strings. If so, getData() will throw this DOMException advising the user to instead retrieve the data in chunks via the substring() operation.

getLength

public int getLength()
Report number of characters currently stored in this node's data. It may be 0, meaning that the value is an empty string.
Specified by:
getLength in interface CharacterData
Overrides:
getLength in class NodeImpl
Tags copied from class: NodeImpl
Returns:
int
See Also:
NodeContainer

appendData

public void appendData(java.lang.String data)
Concatenate additional characters onto the end of the data stored in this node. Note that this, and insert(), are the paths by which a DOM could wind up accumulating more data than the language's strings can easily handle. (See above discussion.)
Specified by:
appendData in interface CharacterData
Throws:
DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is readonly.

deleteData

public void deleteData(int offset,
                       int count)
                throws DOMException
Remove a range of characters from the node's value. Throws a DOMException if the offset is beyond the end of the string. However, a deletion _count_ that exceeds the available data is accepted as a delete-to-end request.
Specified by:
deleteData in interface CharacterData
Throws:
DOMException(INDEX_SIZE_ERR) - if offset is negative or greater than length, or if count is negative.
DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is readonly.

insertData

public void insertData(int offset,
                       java.lang.String data)
                throws DOMException
Insert additional characters into the data stored in this node, at the offset specified.
Specified by:
insertData in interface CharacterData
Throws:
DOMException(INDEX_SIZE_ERR) - if offset is negative or greater than length.
DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is readonly.

replaceData

public void replaceData(int offset,
                        int count,
                        java.lang.String data)
                 throws DOMException
Replace a series of characters at the specified (zero-based) offset with a new string, NOT necessarily of the same length. Convenience method, equivalent to a delete followed by an insert. Throws a DOMException if the specified offset is beyond the end of the existing data.
Specified by:
replaceData in interface CharacterData
Parameters:
offset - The offset at which to begin replacing.
count - The number of characters to remove, interpreted as in the delete() method.
data - The new string to be inserted at offset in place of the removed data. Note that the entire string will be inserted -- the count parameter does not affect insertion, and the new data may be longer or shorter than the substring it replaces.
Throws:
DOMException(INDEX_SIZE_ERR) - if offset is negative or greater than length, or if count is negative.
DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is readonly.

setData

public void setData(java.lang.String value)
             throws DOMException
Store character data into this node.
Specified by:
setData in interface CharacterData
Throws:
DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is readonly.

substringData

public java.lang.String substringData(int offset,
                                      int count)
                               throws DOMException
Substring is more than a convenience function. In some implementations of the DOM, where the stored data may exceed the length that can be returned in a single string, the only way to read it all is to extract it in chunks via this method.
Specified by:
substringData in interface CharacterData
Parameters:
offset - Zero-based offset of first character to retrieve.
count - Number of characters to retrieve. If the sum of offset and count exceeds the length, all characters to end of data are returned.
Throws:
DOMException(INDEX_SIZE_ERR) - if offset is negative or greater than length, or if count is negative.
DOMException(WSTRING_SIZE_ERR) - In some implementations, count may exceed the permitted length of strings. If so, substring() will throw this DOMException advising the user to instead retrieve the data in smaller chunks.


Copyright © 1999 Apache XML Project. All Rights Reserved.