public class

TextImpl

extends CharacterDataImpl
implements CharacterData Text
java.lang.Object
   ↳ org.apache.xerces.dom.NodeImpl
     ↳ org.apache.xerces.dom.ChildNode
       ↳ org.apache.xerces.dom.CharacterDataImpl
         ↳ org.apache.xerces.dom.TextImpl
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

Text nodes hold the non-markup, non-Entity content of an Element or Attribute.

When a document is first made available to the DOM, there is only one Text object for each block of adjacent plain-text. Users (ie, applications) may create multiple adjacent Texts during editing -- see normalize() for discussion.

Note that CDATASection is a subclass of Text. This is conceptually valid, since they're really just two different ways of quoting characters when they're written out as part of an XML stream.@xerces.internal

Summary

[Expand]
Inherited Constants
From class org.apache.xerces.dom.NodeImpl
From interface org.w3c.dom.Node
[Expand]
Inherited Fields
From class org.apache.xerces.dom.CharacterDataImpl
From class org.apache.xerces.dom.ChildNode
From class org.apache.xerces.dom.NodeImpl
Public Constructors
TextImpl()
Default constructor
TextImpl(CoreDocumentImpl ownerDoc, String data)
Factory constructor.
Public Methods
String getNodeName()
Returns the node name.
short getNodeType()
A short integer indicating what type of node this is.
String getWholeText()
DOM Level 3 WD - Experimental.
boolean isElementContentWhitespace()
DOM L3 Core CR - Experimental Returns whether this text node contains element content whitespace, often abusively called "ignorable whitespace".
boolean isIgnorableWhitespace()
NON-DOM: Returns whether this Text is ignorable whitespace.
String removeData()
NON-DOM (used by DOMParser: Sets data to empty string.
void replaceData(String value)
NON-DOM (used by DOMParser): Reset data for the node.
Text replaceWholeText(String content)
Replaces the text of the current node and all logically-adjacent text nodes with the specified text.
void setIgnorableWhitespace(boolean ignore)
NON-DOM: Set whether this Text is ignorable whitespace.
void setValues(CoreDocumentImpl ownerDoc, String data)
NON-DOM: resets node and sets specified values for the current node
Text splitText(int offset)
Break a text node into two sibling nodes.
Protected Methods
void insertTextContent(StringBuffer buf)
internal method taking a StringBuffer in parameter and inserts the text content at the start of the buffer
[Expand]
Inherited Methods
From class org.apache.xerces.dom.CharacterDataImpl
From class org.apache.xerces.dom.ChildNode
From class org.apache.xerces.dom.NodeImpl
From class java.lang.Object
From interface org.w3c.dom.CharacterData
From interface org.w3c.dom.Node
From interface org.w3c.dom.NodeList
From interface org.w3c.dom.Text
From interface org.w3c.dom.events.EventTarget

Public Constructors

public TextImpl ()

Default constructor

public TextImpl (CoreDocumentImpl ownerDoc, String data)

Factory constructor.

Public Methods

public String getNodeName ()

Returns the node name.

public short getNodeType ()

A short integer indicating what type of node this is. The named constants for this value are defined in the org.w3c.dom.Node interface.

public String getWholeText ()

DOM Level 3 WD - Experimental. Returns all text of Text nodes logically-adjacent text nodes to this node, concatenated in document order.

public boolean isElementContentWhitespace ()

DOM L3 Core CR - Experimental Returns whether this text node contains element content whitespace, often abusively called "ignorable whitespace". The text node is determined to contain whitespace in element content during the load of the document or if validation occurs while using Document.normalizeDocument().

public boolean isIgnorableWhitespace ()

NON-DOM: Returns whether this Text is ignorable whitespace.

public String removeData ()

NON-DOM (used by DOMParser: Sets data to empty string. Returns the value the data was set to.

public void replaceData (String value)

NON-DOM (used by DOMParser): Reset data for the node.

public Text replaceWholeText (String content)

Replaces the text of the current node and all logically-adjacent text nodes with the specified text. All logically-adjacent text nodes are removed including the current node unless it was the recipient of the replacement text.

Parameters
content The content of the replacing Text node.
Returns
  • text - The Text node created with the specified content.
Throws
DOMException

public void setIgnorableWhitespace (boolean ignore)

NON-DOM: Set whether this Text is ignorable whitespace.

public void setValues (CoreDocumentImpl ownerDoc, String data)

NON-DOM: resets node and sets specified values for the current node

public Text splitText (int offset)

Break a text node into two sibling nodes. (Note that if the current node has no parent, they won't wind up as "siblings" -- they'll both be orphans.)

Parameters
offset The offset at which to split. If offset is at the end of the available data, the second node will be empty.
Returns
  • A reference to the new node (containing data after the offset point). The original node will contain data up to that point.
Throws
if offset is <0 or >length.
if node is read-only.
DOMException

Protected Methods

protected void insertTextContent (StringBuffer buf)

internal method taking a StringBuffer in parameter and inserts the text content at the start of the buffer

Throws
DOMException