org.exolab.castor.xml.util
Class XMLParserUtils

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

public class XMLParserUtils

extends java.lang.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

Field Summary

(package private) static org.apache.commons.logging.Log

LOG Logger to be used.

Constructor Summary

XMLParserUtils()

Method Summary

static OutputFormat	getOutputFormat(Configuration configuration)
static org.xml.sax.Parser	getParser(Configuration configuration, java.lang.String features)
static javax.xml.parsers.SAXParser	getSAXParser(boolean validation, boolean namespaces) To get a SAXParser instance which is then used to get either parser or XMLReader.
static Serializer	getSerializer(Configuration configuration)
static XMLSerializerFactory	getSerializerFactory(java.lang.String serializerFactoryName) Returns the currently configured XMLSerializerFactory instance.
static org.xml.sax.Parser	instantiateParser(java.lang.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 org.xml.sax.XMLReader	instantiateXMLReader(java.lang.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(java.lang.String parserFeatures, java.lang.String parserFeaturesToDisable, boolean validation, boolean namespaces, org.xml.sax.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

Field Detail

LOG

static final org.apache.commons.logging.Log LOG

Logger to be used.

Constructor Detail

XMLParserUtils

public XMLParserUtils()

Method Detail

setFeaturesOnXmlReader

public static void setFeaturesOnXmlReader(java.lang.String parserFeatures,
                                          java.lang.String parserFeaturesToDisable,
                                          boolean validation,
                                          boolean namespaces,
                                          org.xml.sax.XMLReader xmlReader)

Sets features on XML reader instance.

Parameters:

validation - Whether to enable validation or not.

namespaces - Whether to enable namespace support for not.

xmlReader - The XMLReader instance to configure.

getSAXParser

public static javax.xml.parsers.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

instantiateXMLReader

public static org.xml.sax.XMLReader instantiateXMLReader(java.lang.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 org.xml.sax.Parser instantiateParser(java.lang.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 org.xml.sax.Parser getParser(Configuration configuration,
                                           java.lang.String features)

getSerializer

public static Serializer getSerializer(Configuration configuration)

See Also:

InternalContext.getSerializer()

getOutputFormat

public static OutputFormat getOutputFormat(Configuration configuration)

See Also:

InternalContext.getOutputFormat()

getSerializerFactory

public static XMLSerializerFactory getSerializerFactory(java.lang.String serializerFactoryName)

Returns the currently configured XMLSerializerFactory instance.

Parameters:

serializerFactoryName - the class name of the serializer factory

Returns:

XMLSerializerFactory to use by Castor