org.forgerock.openam.utils

Interface SAXParserProvider

public interface SAXParserProvider

Abstract factory interface for constructing SAXParser instances. Implementations may configure and cache instances for performance.

Since:

12.0.0

Method Summary

Modifier and Type	Method and Description
SAXParser	getSAXParser(boolean validating) Gets a pre-configured SAXParser from the underlying implementation.

Method Detail

getSAXParser

SAXParser getSAXParser(boolean validating)
                throws ParserConfigurationException,
                       SAXException

Gets a pre-configured SAXParser from the underlying implementation. Note: SAXParser instances are not thread-safe and so should not shared between threads. Multiple calls to this method on the same provider from the same thread may return the same instance, but are not required to.

Parameters:

validating - Whether the returned document builder should perform XML validation or not.

Returns:

a pre-configured SAX parser.

Throws:

ParserConfigurationException - if there is an error configuring the parser.

SAXException - if an error occurs initialising the SAX parser.