org.jempbox.impl

Class XMLUtil


public class XMLUtil
extends java.lang.Object

This class with handle some simple XML operations.
Version:
$Revision: 1.1 $
Author:
Ben Litchfield (ben@benlitchfield.com)

Method Summary

static Element
getElement(Element parent, String elementName)
Get the first instance of an element by name.
static Integer
getIntValue(Element parent, String nodeName)
Get the integer value of a subnode.
static String
getStringValue(Element node)
This will get the text value of an element.
static String
getStringValue(Element parent, String nodeName)
Get the value of a subnode.
static Document
newDocument()
Create a new blank XML document.
static Document
parse(InputStream is)
This will parse an XML stream and create a DOM document.
static Document
parse(String fileName)
This will parse an XML stream and create a DOM document.
static void
save(Document doc, String file, String encoding)
Save the XML document to a file.
static void
setElementableValue(Element parent, String name, Elementable node)
Set an XML element document.
static void
setIntValue(Element parent, String nodeName, Integer intValue)
Set the integer value of an element.
static void
setStringValue(Element node, String value)
This will set the text value of an element.
static void
setStringValue(Element parent, String nodeName, String nodeValue)
Set the value of an element.

Method Details

getElement

public static Element getElement(Element parent,
                                 String elementName)
Get the first instance of an element by name.
Parameters:
parent - The parent to get the element from.
elementName - The name of the element to look for.
Returns:
The element or null if it is not found.

getIntValue

public static Integer getIntValue(Element parent,
                                  String nodeName)
Get the integer value of a subnode.
Parameters:
parent - The parent element that holds the values.
nodeName - The name of the node that holds the integer value.
Returns:
The integer value of the node.

getStringValue

public static String getStringValue(Element node)
This will get the text value of an element.
Parameters:
node - The node to get the text value for.
Returns:
The text of the node.

getStringValue

public static String getStringValue(Element parent,
                                    String nodeName)
Get the value of a subnode.
Parameters:
parent - The parent element that holds the values.
nodeName - The name of the node that holds the value.
Returns:
The value of the sub node.

newDocument

public static Document newDocument()
            throws IOException
Create a new blank XML document.
Returns:
The new blank XML document.

parse

public static Document parse(InputStream is)
            throws IOException
This will parse an XML stream and create a DOM document.
Parameters:
is - The stream to get the XML from.
Returns:
The DOM document.

parse

public static Document parse(String fileName)
            throws IOException
This will parse an XML stream and create a DOM document.
Parameters:
fileName - The file to get the XML from.
Returns:
The DOM document.

save

public static void save(Document doc,
                        String file,
                        String encoding)
            throws TransformerException
Save the XML document to a file.
Parameters:
doc - The XML document to save.
file - The file to save the document to.
encoding - The encoding to save the file as.

setElementableValue

public static void setElementableValue(Element parent,
                                       String name,
                                       Elementable node)
Set an XML element document.
Parameters:
parent - The parent document to set the value in.
name - The name of the XML element to set.
node - The node to set or clear.

setIntValue

public static void setIntValue(Element parent,
                               String nodeName,
                               Integer intValue)
Set the integer value of an element.
Parameters:
parent - The parent element that will hold this subelement.
nodeName - The name of the subelement.
intValue - The value to set.

setStringValue

public static void setStringValue(Element node,
                                  String value)
This will set the text value of an element.
Parameters:
node - The node to get the text value for.
value - The new value to set the node to.

setStringValue

public static void setStringValue(Element parent,
                                  String nodeName,
                                  String nodeValue)
Set the value of an element.
Parameters:
parent - The parent element that will hold this subelement.
nodeName - The name of the subelement.
nodeValue - The value to set.