org.ops4j.util.xml
Class ElementHelper

java.lang.Object
  org.ops4j.util.xml.ElementHelper

public final class ElementHelper
extends Object

Utility class supporting the XML document parsing.

Version:

$Id$

Author:

Open Participation Software for Java

Method Summary

static String	getAttribute(Element node, String key) Return the value of an element attribute.
static String	getAttribute(Element node, String key, String def) Return the value of an element attribute.
static Element	getChild(Element root, String name) Return a named child relative to a supplied element.
static Element[]	getChildren(Element root) Return all children of the supplied parent.
static Element[]	getChildren(Element root, String name) Return all children matching the supplied element name.
static Element	getRootElement(InputStream input) Return the root element of the supplied input stream.
static String	getValue(Element node) Return the value of an element.

Methods inherited from class java.lang.Object

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

Method Detail

getRootElement

public static Element getRootElement(InputStream input)
                              throws ParserConfigurationException,
                                     IOException,
                                     SAXException

Return the root element of the supplied input stream.

Parameters:

input - the input stream containing a XML definition

Returns:

the root element

Throws:

IOException - If an underlying I/O problem occurred.

ParserConfigurationException - if there is a severe problem in the XML parsing subsystem.

SAXException - If the XML is malformed in some way.

getChild

public static Element getChild(Element root,
                               String name)

Return a named child relative to a supplied element.

Parameters:

root - the parent DOM element

name - the name of a child element

Returns:

the child element of null if the child does not exist

getChildren

public static Element[] getChildren(Element root,
                                    String name)

Return all children matching the supplied element name.

Parameters:

root - the parent DOM element

name - the name against which child element will be matched

Returns:

the array of child elements with a matching name

getChildren

public static Element[] getChildren(Element root)

Return all children of the supplied parent.

Parameters:

root - the parent DOM element

Returns:

the array of all children

getValue

public static String getValue(Element node)

Return the value of an element.

Parameters:

node - the DOM node

Returns:

the node value

getAttribute

public static String getAttribute(Element node,
                                  String key)

Return the value of an element attribute.

Parameters:

node - the DOM node

key - the attribute key

Returns:

the attribute value or null if the attribute is undefined

getAttribute

public static String getAttribute(Element node,
                                  String key,
                                  String def)

Return the value of an element attribute.

Parameters:

node - the DOM node

key - the attribute key

def - the default value if the attribute is undefined

Returns:

the attribute value or the default value if undefined