org.jdom
public class CDATA extends Object implements Serializable, Cloneable
CDATA
represents character-based content within an
XML document represented by JDOM. It is intended to provide a modular,
printable method of representing CDATA. Additionally,
CDATA
makes no guarantees about the underlying textual
representation of character data, but does expose that data as a Java
String
.
Version: $Revision: 1.20 $, $Date: 2002/03/12 07:11:39 $
Field Summary | |
---|---|
protected Object | parent This CDATA node's parent. |
protected String | value The actual character content |
Constructor Summary | |
---|---|
protected | CDATA() This is the protected, no-args constructor standard in all JDOM classes. |
CDATA(String str) This constructor creates a new |
Method Summary | |
---|---|
void | append(String str) This will append character content to whatever content already
exists within this |
void | append(CDATA cdata) This will append the content of another |
Object | clone() This will return a clone of this |
CDATA | detach()
Detaches the |
boolean | equals(Object ob)
This tests for equality of this |
Document | getDocument() |
Element | getParent() This will return the parent of this |
String | getText() This returns the value of this |
String | getTextNormalize() This returns the textual content with all surrounding whitespace removed and internal whitespace normalized to a single space. |
String | getTextTrim() This returns the textual content with all surrounding whitespace removed. |
int | hashCode() This will generate a hash code for this node. |
protected CDATA | setParent(Element parent) This will set the parent of the |
CDATA | setText(String str) This will set the value of this |
String | toString() This returns a |
CDATA
node's parent.This is the protected, no-args constructor standard in all JDOM classes. It allows subclassers to get a raw instance with no initialization.
This constructor creates a new CDATA
node, with the
supplied string value as it's character content.
Parameters: str the node's character content.
This will append character content to whatever content already
exists within this CDATA
node.
Parameters: str character content to append.
This will append the content of another CDATA
node
to this node.
Parameters: cdata CDATA node to append.
This will return a clone of this CDATA
node, with the
same character content, but no parent.
Returns: CDATA
- cloned node.
Detaches the CDATA
from its parent, or does nothing
if the CDATA
has no parent.
Returns: CDATA
- this CDATA
modified.
This tests for equality of this CDATA
to the supplied
Object
, explicitly using the == operator.
Parameters: ob Object
to compare to
Returns: whether the CDATA
nodes are equal
This retrieves the owning Document
for
this CDATA
, or null if not a currently a member
of a Document
.
Returns: Document
owning this CDATA
, or null.
This will return the parent of this CDATA
node, which
is always a JDOM Element
.
Returns: Element
- this node's parent.
This returns the value of this CDATA
node as a Java
String
.
Returns: String
- character content of this node.
This returns the textual content with all surrounding whitespace removed and internal whitespace normalized to a single space. If only whitespace exists, the empty string is returned.
Returns: normalized cdata content or empty string
This returns the textual content with all surrounding whitespace removed. If only whitespace exists, the empty string is returned.
Returns: trimmed cdata content or empty string
This will generate a hash code for this node.
Returns: int
- hash code for this node.
This will set the parent of the CDATA
node to the
supplied Element
. This method is intentionally
left as protected
so that only JDOM internals use it.
If you need an instance of this CDATA
node with a new
parent, you should get a copy of this node with
CDATA
and set it on the desired (new) parent
Element
.
Parameters: parent parent for this node.
This will set the value of this CDATA
node.
Parameters: str value for node's content.
This returns a String
representation of the
CDATA
node, suitable for debugging. If the XML
representation of the CDATA
node is desired,
either CDATA
or
XMLOutputter
should be used.
Returns: String
- information about this node.