edu.tum.cs.commons.xml
Class XMLUtils

java.lang.Object
  edu.tum.cs.commons.xml.XMLUtils

public class XMLUtils
extends Object

Collection of utility methods for XML.

Version:

$Rev: 26369 $

Author:

Florian Deissenboeck, $Author: hummelb $

Rating:

GREEN Hash: 3E4CDEC5A0EAAC290A6EDF7279A9C811

Constructor Summary

XMLUtils()

Method Summary

static Document	createEmptyDocument() Creates an empty XML document.
static List<Element>	elementNodes(NodeList nodeList) Extracts all ElementNodes from a NodeList and returns the result as a list.
static int	getElementPosition(Element element) Determines the index (starting at 0) of the given element relative to other element nodes for the same parent.
static Element	getNamedChild(Element element, String name) Returns the first child of the given element which is an element named as specified.
static String	getNamedChildContent(Element parent, String name) Get the text content of the given element's first child that is an element named as specified.
static List<Element>	getNamedChildren(Element element, String elementNames) Returns all children of the given element which are element named as specified.
static List<Element>	leafElementNodes(Element root) Get all leaf elements of an XML tree rooted at an element
static Document	parse(File file) Parse a file without validation.
static Document	parse(File file, File schema) Same as parse(File, URL) but with schema file.
static Document	parse(File file, URL schemaURL) Parse and validate file using schema.
static Document	parse(InputSource input) Parse an input source without validation.
static Document	parse(InputSource input, URL schemaURL) Parse and validate file using schema.
static void	parseSAX(File file, DefaultHandler handler) Parse an input source using SAX without validation.
static void	parseSAX(File file, URL schemaURL, DefaultHandler handler) Parse and validate file using SAX and schema.
static void	parseSAX(InputSource input, DefaultHandler handler) Parse an input source using SAX without validation.
static void	parseSAX(InputSource input, URL schemaURL, DefaultHandler handler) Parse and validate file using SAX and schema.
static String	prettyPrint(Document doc) Returns a string representation of the given XML document, which is "pretty printed", i.e. the tags are indented.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLUtils

public XMLUtils()

Method Detail

parse

public static Document parse(File file)
                      throws SAXException,
                             IOException

Parse a file without validation.

Parameters:

file - the file to parse.

Returns:

the DOM document.

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed.

IOException - if an IO exception occurs.

parse

public static Document parse(InputSource input)
                      throws SAXException,
                             IOException

Parse an input source without validation.

Parameters:

input - the input source to parse

Returns:

the DOM document.

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed.

IOException - if an IO exception occurs.

parseSAX

public static void parseSAX(File file,
                            DefaultHandler handler)
                     throws SAXException,
                            IOException

Parse an input source using SAX without validation.

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed.

IOException - if an IO exception occurs.

parseSAX

public static void parseSAX(InputSource input,
                            DefaultHandler handler)
                     throws SAXException,
                            IOException

Parse an input source using SAX without validation.

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed.

IOException - if an IO exception occurs.

parse

public static Document parse(File file,
                             URL schemaURL)
                      throws SAXException,
                             IOException

Parse and validate file using schema. This implements a custom error handler to avoid different behaviour between the JAXP implementations shipping with Java 1.5 and Java 1.6.

Parameters:

file - the file to parse.

schemaURL - URL point to schema, may not be null

Returns:

the DOM document.

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed or not valid

IOException - if an IO exception occurs.

parse

public static Document parse(InputSource input,
                             URL schemaURL)
                      throws SAXException,
                             IOException

Parse and validate file using schema. This implements a custom error handler to avoid different behaviour between the JAXP implementations shipping with Java 1.5 and Java 1.6.

Parameters:

input - the input to parse.

schemaURL - URL point to schema, may not be null

Returns:

the DOM document.

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed or not valid

IOException - if an IO exception occurs.

parseSAX

public static void parseSAX(File file,
                            URL schemaURL,
                            DefaultHandler handler)
                     throws SAXException,
                            IOException

Parse and validate file using SAX and schema.

Parameters:

file - the file to parse.

schemaURL - URL point to schema, may not be null

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed or not valid

IOException - if an IO exception occurs.

parseSAX

public static void parseSAX(InputSource input,
                            URL schemaURL,
                            DefaultHandler handler)
                     throws SAXException,
                            IOException

Parse and validate file using SAX and schema.

Parameters:

input - the input to parse.

schemaURL - URL point to schema, may not be null

Throws:

SAXException - if a parsing exception occurs, i.e. if the file is not well-formed or not valid

IOException - if an IO exception occurs.

parse

public static Document parse(File file,
                             File schema)
                      throws SAXException,
                             IOException

Same as parse(File, URL) but with schema file.

Throws:

IllegalArgumentException - if the schema file could not be converted to an URL

SAXException

IOException

prettyPrint

public static String prettyPrint(Document doc)
                          throws TransformerException

Returns a string representation of the given XML document, which is "pretty printed", i.e. the tags are indented.

Throws:

TransformerException

getElementPosition

public static int getElementPosition(Element element)

Determines the index (starting at 0) of the given element relative to other element nodes for the same parent.

getNamedChildren

public static List<Element> getNamedChildren(Element element,
                                             String elementNames)

Returns all children of the given element which are element named as specified.

getNamedChild

public static Element getNamedChild(Element element,
                                    String name)

Returns the first child of the given element which is an element named as specified. Returns null if none are found.

getNamedChildContent

public static String getNamedChildContent(Element parent,
                                          String name)

Get the text content of the given element's first child that is an element named as specified. If none is found, the empty string is returned.

elementNodes

public static List<Element> elementNodes(NodeList nodeList)

Extracts all ElementNodes from a NodeList and returns the result as a list.

Parameters:

nodeList - the NodeList to be searched for ElementNodes.

Returns:

an array containing all ElementNodes stored in the given node list or null if the input has been null.

leafElementNodes

public static List<Element> leafElementNodes(Element root)

Get all leaf elements of an XML tree rooted at an element

Parameters:

root - The root element

Returns:

List of all leaf elements

createEmptyDocument

public static Document createEmptyDocument()

Creates an empty XML document.