|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnu.xom.Node
nu.xom.LeafNode
nu.xom.Text
This class represents a run of text. CDATA sections are not treated differently than normal text.
Constructor Summary | |
Text(java.lang.String data)
This constructor creates a new Text object. |
|
Text(Text text)
Creates a copy of the specified Text object. |
Method Summary | |
protected void |
checkValue(java.lang.String data)
Subclasses can override this method to perform additional checks. |
Node |
copy()
Returns a deep copy of this Text with no parent,
that can be added to this document or a different one. |
java.lang.String |
getValue()
Returns the XPath 1.0 string-value of this Text
node. |
void |
setValue(java.lang.String data)
This sets the content of the Text object
to the specified data. |
java.lang.String |
toString()
Returns a String
representation of this Text suitable for
debugging and diagnosis. |
java.lang.String |
toXML()
Returns a string containing the XML serialization of this text node. |
Methods inherited from class nu.xom.LeafNode |
getChild, getChildCount, hasChildren |
Methods inherited from class nu.xom.Node |
checkDetach, detach, equals, getBaseURI, getDocument, getParent, hashCode |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public Text(java.lang.String data)
This constructor creates a new Text
object.
The data is checked for legality according to XML 1.0 rules.
Characters that can be serialized by escaping them
such as < and & are allowed. However, characters
such as the form feed, null, vertical tab,
unmatched halves of surrogate pairs,
and 0xFFFE and 0xFFFF are not allowed.
data
- the initial text of the object
IllegalCharacterDataException
- if data contains any
characters which are illegal in well-formed XML 1.0 such as
null, vertical tab, or unmatched halves of surrogate pairspublic Text(Text text)
Creates a copy of the specified Text
object.
text
- the Text
object to copyMethod Detail |
public final void setValue(java.lang.String data)
This sets the content of the Text
object
to the specified data. The data is checked for
legality according to XML 1.0 rules. Characters that
can be serialized such as < and & are allowed.
However, characters such as the form feed, null,
vertical tab, unmatched halves of surrogate pairs,
and 0xFFFE and 0xFFFF are not allowed.
data
- the text to install in the object
IllegalCharacterDataException
- if data contains any
characters which are illegal in well-formed XML 1.0 such as
null, vertical tab, or unmatched halves of surrogate pairsprotected void checkValue(java.lang.String data)
Subclasses can override this method to perform additional
checks. For example, an Integer
subclass could
verify that the text was a legal base-10 integer. However,
this can only be used to add checks, not remove them. All
text in text nodes must be potentially well-formed when
serialized.
data
- the text to checkpublic final java.lang.String getValue()
Returns the XPath 1.0 string-value of this Text
node. The XPath string-value of a text node is the same as
the text of the node.
getValue
in class Node
Node.getValue()
public Node copy()
Returns a deep copy of this Text
with no parent,
that can be added to this document or a different one.
copy
in class Node
Node.copy()
public final java.lang.String toXML()
Returns a string containing the XML serialization of this text
node. Unlike getValue
, this method escapes
characters such as & and < using entity references such
as &
and <
.
It escapes the carriage return (\r) as 
.
toXML
in class Node
Node.toXML()
public final java.lang.String toString()
Returns a String
representation of this Text
suitable for
debugging and diagnosis. This is not
the XML representation of this Text
node.
toString
in class Node
Object.toString()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |