XMLParserUtils (Castor JavaDoc)

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

Fields
Modifier and Type Field Description

(package private) static org.apache.commons.logging.Log LOG
Logger to be used.

Fields
Modifier and Type	Field	Description
`(package private) static org.apache.commons.logging.Log`	`LOG`	Logger to be used.

Constructor Summary

Constructors
Constructor Description

XMLParserUtils()

Constructors
Constructor	Description
`XMLParserUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`static OutputFormat`	`getOutputFormat(AbstractProperties properties)`
`static org.xml.sax.Parser`	`getParser(AbstractProperties properties, 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(AbstractProperties properties)`
`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:
    
    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 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(AbstractProperties properties,
                                           java.lang.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(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

Class XMLParserUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOG

Constructor Detail

XMLParserUtils

Method Detail

setFeaturesOnXmlReader

getSAXParser

instantiateXMLReader

instantiateParser

getParser

getSerializer

getOutputFormat

getSerializerFactory