Package org.anchoranalysis.core.serialize

Class XMLParser

Object

XMLParser

public class XMLParser
extends Object

Utility functions for parsing XML files using standard Java APIs.

Author:

Owen Feehan

Method Summary

Modifier and Type	Method	Description
static DocumentBuilder	createBuilderWithDefaultErrorHandler()	Creates a document-builder with default error-handling.
static Document	createNewDocument()	Creates a new XML document.
static TransformerFactory	createTransformerFactory()	Creates a TransformerFactory that ignores any DTDs in the document and disables external entities (to prevent XXE attacks).
static Document	parse(File file)	Parses a XML file to produce a Document.

Methods inherited from class java.lang.Object

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

Method Details

createBuilderWithDefaultErrorHandler

public static DocumentBuilder createBuilderWithDefaultErrorHandler()
                                                            throws ParserConfigurationException

Creates a document-builder with default error-handling.

Returns:

a document-builder with default-error-handling.

Throws:

ParserConfigurationException - if a DocumentBuilder cannot be created which satisfies the configuration requested.

createTransformerFactory

public static TransformerFactory createTransformerFactory()
                                                   throws TransformerConfigurationException

Creates a TransformerFactory that ignores any DTDs in the document and disables external entities (to prevent XXE attacks).

Returns:

a newly created DocumentBuilderFactory

Throws:

TransformerConfigurationException - if thrown by TransformerFactory.setFeature(java.lang.String, boolean).

parse

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

Parses a XML file to produce a Document.

Parameters:

file - the XML file to parse.

Returns:

the parsed document

Throws:

SAXException - if any parse errors occur.

IOException - if any IO errors occur.

ParserConfigurationException - if a DocumentBuilder cannot be created which satisfies the configuration requested.

createNewDocument

public static Document createNewDocument()
                                  throws ParserConfigurationException

Creates a new XML document.

Returns:

the newly created Document

Throws:

ParserConfigurationException - if a DocumentBuilder cannot be created which satisfies the configuration requested.