| java.lang.Object org.itsnat.core.domutil.ItsNatDOMUtil
ItsNatDOMUtil | public class ItsNatDOMUtil (Code) | | This class provides methods to do frequent DOM related tasks. Most of them
access DOM Element objects filtering/ignoring any other node type.
author: Jose Maria Arranz Santamaria |
Method Summary | |
public static Element | createElement(String tagName, String text, Document doc) Creates a new DOM Element with the specified tag name containing a text node
with the specified text. | public static Node | extractChildren(Node parentNode) Removes and returns the content of the specified node.
If the node is empty returns null. | public static Element | getElementById(String id, Element container) Returns the first element with the specified id attribute below or the same
as the specified element.
Use this method when several elements in the tree have the same id attribute
(duplicated id) because Document.getElementById(String) returns the first one. | public static String | getTextContent(Element elem) Returns the string content of the text node inside the specified Element.
If the element contains a child node different to a text node a cast exception is thrown.
Parameters: elem - the parent element. | public static void | removeAllChildren(Node parentNode) Makes empty the specified node removing all child nodes. | public static void | setTextContent(Element elem, String value) Sets the string content of the text node inside the specified Element.
If the element already contains a text node, then is updated with the
new value. |
createElement | public static Element createElement(String tagName, String text, Document doc)(Code) | | Creates a new DOM Element with the specified tag name containing a text node
with the specified text.
Parameters: tagName - the tag name of the new element. Parameters: text - the string contained by the element as a text node, if null or empty no text node is added. Parameters: doc - the document owner of the new element. |
extractChildren | public static Node extractChildren(Node parentNode)(Code) | | Removes and returns the content of the specified node.
If the node is empty returns null. If only contains a child node
returns this child node. If contains more than one child node returns
a DocumentFragment with the child nodes.
Parameters: parentNode - the node to remove the content. a node with the content. May be null a tree node or a DocumentFragment . |
getElementById | public static Element getElementById(String id, Element container)(Code) | | Returns the first element with the specified id attribute below or the same
as the specified element.
Use this method when several elements in the tree have the same id attribute
(duplicated id) because Document.getElementById(String) returns the first one.
Parameters: id - the id attribute value to search. Parameters: container - the top most element to search below. the first element object with the specified id or null if not found. |
getTextContent | public static String getTextContent(Element elem)(Code) | | Returns the string content of the text node inside the specified Element.
If the element contains a child node different to a text node a cast exception is thrown.
Parameters: elem - the parent element. the string value of the text child node. If element is empty returns an empty String. |
removeAllChildren | public static void removeAllChildren(Node parentNode)(Code) | | Makes empty the specified node removing all child nodes.
Parameters: parentNode - the node to remove the content. |
setTextContent | public static void setTextContent(Element elem, String value)(Code) | | Sets the string content of the text node inside the specified Element.
If the element already contains a text node, then is updated with the
new value. If the new string value is null or empty the child text node is removed.
If first child node is different to a text node a cast exception is thrown.
Parameters: elem - the parent element. Parameters: value - the new string value of the text child node. |
|
|