Package se.swedenconnect.sigval.xml.utils

Class XMLDocumentBuilder

java.lang.Object

se.swedenconnect.sigval.xml.utils.XMLDocumentBuilder

public class XMLDocumentBuilder
extends Object

Safe document builder class for parsing XML data but also providing some function for converting XML documents back to text

Author:

Martin Lindström (martin@idsec.se), Stefan Santesson (stefan@idsec.se)

Constructor Summary

Constructors

Constructor	Description
XMLDocumentBuilder()

Method Summary

Modifier and Type	Method	Description
static byte[]	getCanonicalDocBytes(Document doc)	Provides a canonical print of the XML document.
static DocumentBuilderFactory	getDbFactory()	Getter for a safe document builder factory
static String	getDocText(Document doc)	Generates a pretty XML print of an XML document based on java.xml functions.
static Document	getDocument(byte[] xmlData)	Returns an XML document from a safe document builder process
static String	getParsedXMLText(File xmlFile)	Parse an XML file and returns an XML string
static Document	loadXMLContent(File xmlFile)	Parse an XML file and returns an XML document

Methods inherited from class java.lang.Object

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

Constructor Details

XMLDocumentBuilder

public XMLDocumentBuilder()

Method Details

getDocText

public static String getDocText(Document doc)
                         throws IOException

Generates a pretty XML print of an XML document based on java.xml functions.

Parameters:

doc - The doc being processed

Returns:

Test representation of the XML document

Throws:

IOException - errors parsing document

getCanonicalDocBytes

public static byte[] getCanonicalDocBytes(Document doc)
                                   throws TransformerException

Provides a canonical print of the XML document. The purpose of this print is to try to preserve integrity of an existing signature.

Parameters:

doc - The XML document being processed.

Returns:

The bytes of the xml document

Throws:

TransformerException - transformer error

getDocument

public static Document getDocument(byte[] xmlData)
                            throws IOException,
SAXException,
ParserConfigurationException

Returns an XML document from a safe document builder process

Parameters:

xmlData - XML document bytes

Returns:

XML document

Throws:

IOException - On IO errors

SAXException - Error parsing XML content

ParserConfigurationException - Error in configuration of the parser

loadXMLContent

public static Document loadXMLContent(File xmlFile)
                               throws IOException,
ParserConfigurationException,
SAXException

Parse an XML file and returns an XML document

Parameters:

xmlFile - The XML file being parsed

Returns:

XML Document

Throws:

IOException - On IO errors

SAXException - Error parsing XML content

ParserConfigurationException - Error in configuration of the parser

getParsedXMLText

public static String getParsedXMLText(File xmlFile)
                               throws ParserConfigurationException,
SAXException,
IOException

Parse an XML file and returns an XML string

Parameters:

xmlFile - The XML file being parsed

Returns:

XML String

Throws:

ParserConfigurationException - parser configuration errors

SAXException - XML parsing errors

IOException - other data parsing errors

getDbFactory

public static DocumentBuilderFactory getDbFactory()

Getter for a safe document builder factory

Returns:

safe document builder factory