org.exolab.castor.xml.util
Class XMLParserUtils

java.lang.Object
  org.exolab.castor.xml.util.XMLParserUtils

public class XMLParserUtils
extends Object

A couple of routines to manipulate XMLParser instances. Mostly extracted from 'old' LocalConfiguration class.

Since:

1.1.3

Version:

$Id$

Author:

Joachim Grueneis, jgrueneis_at_gmail_dot_com

Constructor Summary

XMLParserUtils()

Method Summary

static OutputFormat	getOutputFormat(AbstractProperties properties)
static Parser	getParser(AbstractProperties properties, String features)
static SAXParser	getSAXParser(boolean validation, boolean namespaces) To get a SAXParser instance which is then used to get either parser or XMLReader.
static SAXParser	getSAXParser(SAXParserFactory saxParserFactory) To get a SAXParser instance from a given SAXParserFactory, which is then used to obtain either Parser or XMLReader.
static SAXParserFactory	getSAXParserFactory(boolean validation, boolean namespaces) To get a SAXParserFactory instance which is then used to obtain an SAXParser instance.
static Serializer	getSerializer(AbstractProperties properties)
static XMLSerializerFactory	getSerializerFactory(String serializerFactoryName) Returns the currently configured XMLSerializerFactory instance.
static Parser	instantiateParser(String className) Instantiates an Parser instance directly, using Class.forName(String) to obtain the Class instance, and uses Class.newInstance() to create the actual instance.
static XMLReader	instantiateXMLReader(String className) Instantiates an XMLReader instance directly, using Class.forName(String) to obtain the Class instance, and uses Class.newInstance() to create the actual instance.
static void	setFeaturesOnXmlReader(String parserFeatures, String parserFeaturesToDisable, boolean validation, boolean namespaces, XMLReader xmlReader) Sets features on XML reader instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLParserUtils

public XMLParserUtils()

Method Detail

setFeaturesOnXmlReader

public static void setFeaturesOnXmlReader(String parserFeatures,
                                          String parserFeaturesToDisable,
                                          boolean validation,
                                          boolean namespaces,
                                          XMLReader xmlReader)

Sets features on XML reader instance.

Parameters:

properties - the Properties to read parser features from

defaultFeatures - any default features to use

validation - Whether to enable validation or not.

namespaces - Whether to enable namespace support for not.

xmlReader - The XMLReader instance to configure.

getSAXParser

public static SAXParser getSAXParser(boolean validation,
                                     boolean namespaces)

To get a SAXParser instance which is then used to get either parser or XMLReader.

Parameters:

validation - validation flag to set into parser factory

namespaces - namespace flag to set into parser factory

Returns:

the SAXParser for further use

getSAXParser

public static SAXParser getSAXParser(SAXParserFactory saxParserFactory)

To get a SAXParser instance from a given SAXParserFactory, which is then used to obtain either Parser or XMLReader.

Returns:

the SAXParser for further use

getSAXParserFactory

public static SAXParserFactory getSAXParserFactory(boolean validation,
                                                   boolean namespaces)

To get a SAXParserFactory instance which is then used to obtain an SAXParser instance.

Parameters:

namespaces - Whether to provide namespace support.

validation - Whether to produce a validating SAX parser.

Returns:

the SAXParserFactory for further use

instantiateXMLReader

public static XMLReader instantiateXMLReader(String className)

Instantiates an XMLReader instance directly, using Class.forName(String) to obtain the Class instance, and uses Class.newInstance() to create the actual instance.

Parameters:

className - The class name of the XMLReader instance to be instantiated.

Returns:

An XMLReader instance.

instantiateParser

public static Parser instantiateParser(String className)

Instantiates an Parser instance directly, using Class.forName(String) to obtain the Class instance, and uses Class.newInstance() to create the actual instance.

Parameters:

className - The class name of the Parser instance to be instantiated.

Returns:

An Parser instance.

getParser

public static Parser getParser(AbstractProperties properties,
                               String features)

getSerializer

public static Serializer getSerializer(AbstractProperties properties)

See Also:

InternalContext.getSerializer()

getOutputFormat

public static OutputFormat getOutputFormat(AbstractProperties properties)

See Also:

InternalContext.getOutputFormat()

getSerializerFactory

public static XMLSerializerFactory getSerializerFactory(String serializerFactoryName)

Returns the currently configured XMLSerializerFactory instance.

Parameters:

serializerFactoryName - the class name of the serializer factory

Returns:

XMLSerializerFactory to use by Castor