Package org.jsoup.nodes

## Class DataNode

- java.lang.Object
- - org.jsoup.nodes.Node
  - - org.jsoup.nodes.DataNode

All Implemented Interfaces:
  `java.lang.Cloneable`

    public class DataNode
    extends Node

A data node, for contents of style, script tags etc, where contents should not show in text().

Author:
  Jonathan Hedley, jonathan@hedley.net

### Constructor Summary

Constructors
`DataNode​(java.lang.String data)` Create a new DataNode.

### Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
`java.lang.String` `absUrl​(java.lang.String key)` Get an absolute URL from a URL attribute that may be relative (such as an `<a href>` or `<img src>`).
`java.lang.String` `attr​(java.lang.String key)` Get an attribute's value by its key.
`Node` `attr​(java.lang.String key, java.lang.String value)` Set an attribute (key=value).
`Attributes` `attributes()` Get all of the element's attributes.
`java.lang.String` `baseUri()` Get the base URI that applies to this node.
`int` `childNodeSize()` Get the number of child nodes that this node holds.
`DataNode` `clone()` Create a stand-alone, deep copy of this node, and all of its children.
`static DataNode` `createFromEncoded​(java.lang.String encodedData, java.lang.String baseUri)` Deprecated. Unused, and will be removed in 1.15.1.
`protected org.jsoup.nodes.LeafNode` `doClone​(Node parent)`
`protected void` `doSetBaseUri​(java.lang.String baseUri)` Set the baseUri for just this node (not its descendants), if this Node tracks base URIs.
`Node` `empty()` Delete all this node's children.
`protected java.util.List<Node>` `ensureChildNodes()`
`java.lang.String` `getWholeData()` Get the data contents of this node.
`boolean` `hasAttr​(java.lang.String key)` Test if this Node has an attribute.
`protected boolean` `hasAttributes()` Check if this Node has an actual Attributes object.
`java.lang.String` `nodeName()` Get the node name of this node.
`Node` `removeAttr​(java.lang.String key)` Remove an attribute from this node.
`DataNode` `setWholeData​(java.lang.String data)` Set the data contents of this node.
`java.lang.String` `toString()` Gets this node's outer HTML.

### Methods inherited from class org.jsoup.nodes.Node

`addChildren, addChildren, after, after, attributesSize, before, before, childNode, childNodes, childNodesAsArray, childNodesCopy, clearAttributes, equals, filter, hashCode, 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, notify, notifyAll, wait, wait, wait`

### Constructor Detail

#### DataNode

    public DataNode​(java.lang.String data)

Create a new DataNode.

Parameters:
  `data` - data contents

### Method Detail

#### nodeName

    public java.lang.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

#### getWholeData

    public java.lang.String getWholeData()

Get the data contents of this node. Will be unescaped and with original new lines, space etc.

Returns:
  data

#### setWholeData

    public DataNode setWholeData​(java.lang.String data)

Set the data contents of this node.

Parameters:
  `data` - unencoded data
Returns:
  this node, for chaining

#### toString

    public java.lang.String toString()

Description copied from class: `Node`
Gets this node's outer HTML.

Overrides:
  `toString` in class `Node`
Returns:
  outer HTML.
See Also:
  `Node.outerHtml()`

#### clone

    public DataNode clone()

Description copied from class: `Node`
Create a stand-alone, deep copy of this node, and all of its children. The cloned node will have no siblings or parent node. As a stand-alone object, any changes made to the clone or any of its children will not impact the original node.

The cloned node may be adopted into another Document or node structure using `Element.appendChild(Node)`.

Overrides:
  `clone` in class `Node`
Returns:
  a stand-alone cloned node, including clones of any children
See Also:
  `Node.shallowClone()`

#### createFromEncoded

    @Deprecated
    public static DataNode createFromEncoded​(java.lang.String encodedData,
                                             java.lang.String baseUri)

Deprecated.
Unused, and will be removed in 1.15.1.
Create a new DataNode from HTML encoded data.

Parameters:
  `encodedData` - encoded data
  `baseUri` - base URI
Returns:
  new DataNode

#### 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 java.lang.String attr​(java.lang.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​(java.lang.String key,
                     java.lang.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. The key will be set with case sensitivity as set in the parser settings.

Overrides:
  `attr` in class `Node`
Parameters:
  `key` - The attribute key.
  `value` - The attribute value.
Returns:
  this (for chaining)

#### hasAttr

    public boolean hasAttr​(java.lang.String key)

Description copied from class: `Node`
Test if this Node 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​(java.lang.String key)

Description copied from class: `Node`
Remove an attribute from this node.

Overrides:
  `removeAttr` in class `Node`
Parameters:
  `key` - The attribute to remove.
Returns:
  this (for chaining)

#### absUrl

    public java.lang.String absUrl​(java.lang.String key)

Description copied from class: `Node`
Get an absolute URL from a URL attribute that may be relative (such as 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 java.lang.String baseUri()

Description copied from class: `Node`
Get the base URI that applies to this node. Will return an empty string if not defined. Used to make relative links absolute.

Specified by:
  `baseUri` in class `Node`
Returns:
  base URI
See Also:
  `Node.absUrl(java.lang.String)`

#### doSetBaseUri

    protected void doSetBaseUri​(java.lang.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.

#### empty

    public Node empty()

Description copied from class: `Node`
Delete all this node's children.

Specified by:
  `empty` in class `Node`
Returns:
  this node, for chaining

#### ensureChildNodes

    protected java.util.List<Node> ensureChildNodes()

Specified by:
  `ensureChildNodes` in class `Node`

#### doClone

    protected org.jsoup.nodes.LeafNode doClone​(Node parent)

Overrides:
  `doClone` in class `Node`