Package org.jsoup.nodes

Class TextNode

java.lang.Object

org.jsoup.nodes.Node

org.jsoup.nodes.TextNode

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

CDataNode

public class TextNode
extends Node

A text node.

Author:

Jonathan Hedley, jonathan@hedley.net

Constructor Summary

Constructors

Constructor	Description
TextNode(String text)	Create a new TextNode representing the supplied (unencoded) text).
TextNode(String text, String baseUri)	Deprecated. use TextNode(String)

Method Summary

Modifier and Type	Method	Description
String	absUrl(String key)	Get an absolute URL from a URL attribute that may be relative (i.e.
String	attr(String key)	Get an attribute's value by its key.
Node	attr(String key, String value)	Set an attribute (key=value).
Attributes	attributes()	Get all of the element's attributes.
String	baseUri()	Get the base URI of this node.
int	childNodeSize()	Get the number of child nodes that this node holds.
static TextNode	createFromEncoded(String encodedText)	Create a new TextNode from HTML encoded (aka escaped) data.
static TextNode	createFromEncoded(String encodedText, String baseUri)	Deprecated. use createFromEncoded(String) instead, as LeafNodes don't carry base URIs.
protected void	doSetBaseUri(String baseUri)	Set the baseUri for just this node (not its descendants), if this Node tracks base URIs.
protected List<Node>	ensureChildNodes()
String	getWholeText()	Get the (unencoded) text of this text node, including any newlines and spaces present in the original.
boolean	hasAttr(String key)	Test if this element has an attribute.
protected boolean	hasAttributes()	Check if this Node has an actual Attributes object.
boolean	isBlank()	Test if this text node is blank -- that is, empty or only whitespace (including newlines).
String	nodeName()	Get the node name of this node.
Node	removeAttr(String key)	Remove an attribute from this element.
TextNode	splitText(int offset)	Split this text node into two nodes at the specified string offset.
String	text()	Get the text content of this text node.
TextNode	text(String text)	Set the text content of this text node.
String	toString()

Methods inherited from class org.jsoup.nodes.Node

addChildren, addChildren, after, after, before, before, childNode, childNodes, childNodesAsArray, childNodesCopy, clearAttributes, clone, doClone, equals, filter, hasParent, hasSameValue, html, indent, nextSibling, outerHtml, outerHtml, ownerDocument, parent, parentNode, previousSibling, remove, removeChild, reparentChild, replaceChild, replaceWith, root, setBaseUri, setParentNode, setSiblingIndex, shallowClone, siblingIndex, siblingNodes, traverse, unwrap, wrap

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TextNode

public TextNode(String text)

Create a new TextNode representing the supplied (unencoded) text).

Parameters:

text - raw text

See Also:

createFromEncoded(String)

TextNode

public TextNode(String text,
                String baseUri)

Deprecated. use TextNode(String)

Create a new TextNode representing the supplied (unencoded) text).

Parameters:

text - raw text

baseUri - base uri - ignored for this node type

See Also:

createFromEncoded(String, String)

Method Detail

nodeName

public String nodeName()

Description copied from class: Node

Get the node name of this node. Use for debugging purposes and not logic switching (for that, use instanceof).

Specified by:

nodeName in class Node

Returns:

node name

text

public String text()

Get the text content of this text node.

Returns:

Unencoded, normalised text.

See Also:

getWholeText()

text

public TextNode text(String text)

Set the text content of this text node.

Parameters:

text - unencoded text

Returns:

this, for chaining

getWholeText

public String getWholeText()

Get the (unencoded) text of this text node, including any newlines and spaces present in the original.

Returns:

text

isBlank

public boolean isBlank()

Test if this text node is blank -- that is, empty or only whitespace (including newlines).

Returns:

true if this document is empty or only whitespace, false if it contains any text content.

splitText

public TextNode splitText(int offset)

Split this text node into two nodes at the specified string offset. After splitting, this node will contain the original text up to the offset, and will have a new text node sibling containing the text after the offset.

Parameters:

offset - string offset point to split node at.

Returns:

the newly created text node containing the text after the offset.

toString

public String toString()

Overrides:

toString in class Node

createFromEncoded

public static TextNode createFromEncoded(String encodedText,
                                         String baseUri)

Deprecated. use createFromEncoded(String) instead, as LeafNodes don't carry base URIs.

Create a new TextNode from HTML encoded (aka escaped) data.

Parameters:

encodedText - Text containing encoded HTML (e.g. <)

baseUri - Base uri

Returns:

TextNode containing unencoded data (e.g. <)

createFromEncoded

public static TextNode createFromEncoded(String encodedText)

Create a new TextNode from HTML encoded (aka escaped) data.

Parameters:

encodedText - Text containing encoded HTML (e.g. &lt;)

Returns:

TextNode containing unencoded data (e.g. <)

hasAttributes

protected final boolean hasAttributes()

Description copied from class: Node

Check if this Node has an actual Attributes object.

Specified by:

hasAttributes in class Node

attributes

public final Attributes attributes()

Description copied from class: Node

Get all of the element's attributes.

Specified by:

attributes in class Node

Returns:

attributes (which implements iterable, in same order as presented in original HTML).

attr

public String attr(String key)

Description copied from class: Node

Get an attribute's value by its key. Case insensitive

To get an absolute URL from an attribute that may be a relative URL, prefix the key with abs, which is a shortcut to the Node.absUrl(java.lang.String) method.

E.g.:

String url = a.attr("abs:href");

Overrides:

attr in class Node

Parameters:

key - The attribute key.

Returns:

The attribute, or empty string if not present (to avoid nulls).

See Also:

Node.attributes(), Node.hasAttr(String), Node.absUrl(String)

attr

public Node attr(String key,
                 String value)

Description copied from class: Node

Set an attribute (key=value). If the attribute already exists, it is replaced. The attribute key comparison is case insensitive.

Overrides:

attr in class Node

Parameters:

key - The attribute key.

value - The attribute value.

Returns:

this (for chaining)

hasAttr

public boolean hasAttr(String key)

Description copied from class: Node

Test if this element has an attribute. Case insensitive

Overrides:

hasAttr in class Node

Parameters:

key - The attribute key to check.

Returns:

true if the attribute exists, false if not.

removeAttr

public Node removeAttr(String key)

Description copied from class: Node

Remove an attribute from this element.

Overrides:

removeAttr in class Node

Parameters:

key - The attribute to remove.

Returns:

this (for chaining)

absUrl

public String absUrl(String key)

Description copied from class: Node

Get an absolute URL from a URL attribute that may be relative (i.e. an <a href> or <img src>).

E.g.: String absUrl = linkEl.absUrl("href");

If the attribute value is already absolute (i.e. it starts with a protocol, like http:// or https:// etc), and it successfully parses as a URL, the attribute is returned directly. Otherwise, it is treated as a URL relative to the element's Node.baseUri(), and made absolute using that.

As an alternate, you can use the Node.attr(java.lang.String) method with the abs: prefix, e.g.: String absUrl = linkEl.attr("abs:href");

Overrides:

absUrl in class Node

Parameters:

key - The attribute key

Returns:

An absolute URL if one could be made, or an empty string (not null) if the attribute was missing or could not be made successfully into a URL.

See Also:

Node.attr(java.lang.String), URL(java.net.URL, String)

baseUri

public String baseUri()

Description copied from class: Node

Get the base URI of this node.

Specified by:

baseUri in class Node

Returns:

base URI

doSetBaseUri

protected void doSetBaseUri(String baseUri)

Description copied from class: Node

Set the baseUri for just this node (not its descendants), if this Node tracks base URIs.

Specified by:

doSetBaseUri in class Node

Parameters:

baseUri - new URI

childNodeSize

public int childNodeSize()

Description copied from class: Node

Get the number of child nodes that this node holds.

Specified by:

childNodeSize in class Node

Returns:

the number of child nodes that this node holds.

ensureChildNodes

protected List<Node> ensureChildNodes()

Specified by:

ensureChildNodes in class Node