xml

Class DOMHelper

java.lang.Object

xml.DOMHelper

public class DOMHelper
extends Object

A class consisting of helper methods for dealing with DOMS.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DOMHelper.Table Parses an (html)-file for a table with a given ID.

Field Summary

Fields

Modifier and Type	Field and Description
static String	TD The tag denoting a table column.
static String	TR The tag denoting a table row.

Constructor Summary

Constructors

Constructor and Description
DOMHelper()

Method Summary

Modifier and Type	Method and Description
static Element	addTextNode(Element parent, String text) Adds a single text node to this element.
static List<String>	getStringsFromElements(List<Node> scan) Converts a list of elements that have a text node as their first child to a list of the text values of these child nodes.
static List<List<String>>	getTable(Element tab) Scans a table element for entries, returns each table row (tr) as a list of strings, the elements in this list are the td tags.
static List<String>	getTextElementContent(Node xml, String tagname) Scans the DOM for all occurences of the element with the given name.
static List<Node>	getTextElements(Node xml, String tagname) Scans the DOM for all occurrences of elements with the given tag name.
static String	singleAttribute(Node xml, String tag, String att) Scans the node for the sole occurence of the stated element.
static Element	singleElement(Node xml, String tagname) Scans the node for the occurence of the given element.
static String	singleText(Node xml, String tagname) Scans the node for the occurrence of the given element.
static String	toElementName(String upper) Converts a string into a typical element notation, thus to lower case except the starting char.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TR

public static final String TR

The tag denoting a table row.

See Also:

Constant Field Values

TD

public static final String TD

The tag denoting a table column.

See Also:

Constant Field Values

Constructor Detail

DOMHelper

public DOMHelper()

Method Detail

singleText

public static final String singleText(Node xml,
                                      String tagname)

Scans the node for the occurrence of the given element. If the element is found and present only once and has a text node as the first child, the value of this text node is trimmed and returned. If this is not fulfilled, null is returned.

Parameters:

xml - Either an Element or a Document

toElementName

public static final String toElementName(String upper)

Converts a string into a typical element notation, thus to lower case except the starting char.

singleElement

public static final Element singleElement(Node xml,
                                          String tagname)

Scans the node for the occurence of the given element. If it is present only once, this element is returned, otherwise null is returned.

singleAttribute

public static final String singleAttribute(Node xml,
                                           String tag,
                                           String att)

Scans the node for the sole occurence of the stated element. The atrribute stated to this element is returned.

getTextElements

public static final List<Node> getTextElements(Node xml,
                                               String tagname)

Scans the DOM for all occurrences of elements with the given tag name. If the element found has a text node as its first child, this element is stored in the returned list.

Returns:

A list of elements or an empty list.

getStringsFromElements

public static final List<String> getStringsFromElements(List<Node> scan)

Converts a list of elements that have a text node as their first child to a list of the text values of these child nodes.

Returns:

A list of strings or an empty list.

getTextElementContent

public static final List<String> getTextElementContent(Node xml,
                                                       String tagname)

Scans the DOM for all occurences of the element with the given name. All elements found whose first child node is a text node contribute its text value to the list of returned items.
This public method calls the methods getTextElements(org.w3c.dom.Node, java.lang.String) and getStringsFromElements(java.util.List<org.w3c.dom.Node>).

Returns:

A list of strings or an empty list.

getTable

public static List<List<String>> getTable(Element tab)

Scans a table element for entries, returns each table row (tr) as a list of strings, the elements in this list are the td tags.

addTextNode

public static final Element addTextNode(Element parent,
                                        String text)

Adds a single text node to this element. The text node is filled with the value supplied and added as the last child to the element. The element is then returned.