public abstract class CharacterDataImpl extends LeafNodeImpl implements CharacterData
Some of the fields may have package visibility, so other classes belonging to the DOM implementation can easily access them while maintaining the DOM tree structure.
Modifier and Type | Field and Description |
---|---|
protected StringBuffer |
buffer |
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
Modifier and Type | Method and Description |
---|---|
void |
appendData(String arg)
Append the string to the end of the character data of the node.
|
void |
appendDataTo(StringBuilder stringBuilder)
Appends this node's text content to the given builder.
|
void |
deleteData(int offset,
int count)
Remove a range of 16-bit units from the node.
|
String |
getData()
The character data of the node that implements this interface.
|
int |
getLength()
The number of 16-bit units that are available through
data
and the substringData method below. |
String |
getNodeValue()
The value of this node, depending on its type; see the table above.
|
void |
insertData(int offset,
String arg)
Insert a string at the specified 16-bit unit offset.
|
void |
replaceData(int offset,
int count,
String arg)
Replace the characters starting at the specified 16-bit unit offset
with the specified string.
|
void |
setData(String data)
The character data of the node that implements this interface.
|
String |
substringData(int offset,
int count)
Extracts a range of data from the node.
|
getNextSibling, getParentNode, getPreviousSibling
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNodeName, getNodeType, getOwnerDocument, getPrefix, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
protected StringBuffer buffer
public void appendData(String arg) throws DOMException
CharacterData
data
provides access to the concatenation of
data
and the DOMString
specified.appendData
in interface CharacterData
arg
- The DOMString
to append.DOMException
- NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.public void deleteData(int offset, int count) throws DOMException
CharacterData
data
and length
reflect the change.deleteData
in interface CharacterData
offset
- The offset from which to start removing.count
- The number of 16-bit units to delete. If the sum of
offset
and count
exceeds
length
then all 16-bit units from offset
to the end of the data are deleted.DOMException
- INDEX_SIZE_ERR: Raised if the specified offset
is
negative or greater than the number of 16-bit units in
data
, or if the specified count
is
negative.
public String getData() throws DOMException
CharacterData
CharacterData
node. However,
implementation limits may mean that the entirety of a node's data may
not fit into a single DOMString
. In such cases, the user
may call substringData
to retrieve the data in
appropriately sized pieces.getData
in interface CharacterData
DOMException
- DOMSTRING_SIZE_ERR: Raised when it would return more characters than
fit in a DOMString
variable on the implementation
platform.public void appendDataTo(StringBuilder stringBuilder)
public int getLength()
CharacterData
data
and the substringData
method below. This may have the
value zero, i.e., CharacterData
nodes may be empty.getLength
in interface CharacterData
public String getNodeValue()
Node
null
, setting it has no effect,
including if the node is read-only.getNodeValue
in interface Node
getNodeValue
in class NodeImpl
public void insertData(int offset, String arg) throws DOMException
CharacterData
insertData
in interface CharacterData
offset
- The character offset at which to insert.arg
- The DOMString
to insert.DOMException
- INDEX_SIZE_ERR: Raised if the specified offset
is
negative or greater than the number of 16-bit units in
data
.
public void replaceData(int offset, int count, String arg) throws DOMException
CharacterData
replaceData
in interface CharacterData
offset
- The offset from which to start replacing.count
- The number of 16-bit units to replace. If the sum of
offset
and count
exceeds
length
, then all 16-bit units to the end of the data
are replaced; (i.e., the effect is the same as a remove
method call with the same range, followed by an append
method invocation).arg
- The DOMString
with which the range must be
replaced.DOMException
- INDEX_SIZE_ERR: Raised if the specified offset
is
negative or greater than the number of 16-bit units in
data
, or if the specified count
is
negative.
public void setData(String data) throws DOMException
CharacterData
CharacterData
node. However,
implementation limits may mean that the entirety of a node's data may
not fit into a single DOMString
. In such cases, the user
may call substringData
to retrieve the data in
appropriately sized pieces.setData
in interface CharacterData
DOMException
- NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.public String substringData(int offset, int count) throws DOMException
CharacterData
substringData
in interface CharacterData
offset
- Start offset of substring to extract.count
- The number of 16-bit units to extract.offset
and
count
exceeds the length
, then all 16-bit
units to the end of the data are returned.DOMException
- INDEX_SIZE_ERR: Raised if the specified offset
is
negative or greater than the number of 16-bit units in
data
, or if the specified count
is
negative.
DOMString
.