Package org.apache.harmony.xml.parsers

Class SAXParserFactoryImpl

java.lang.Object

javax.xml.parsers.SAXParserFactory

org.apache.harmony.xml.parsers.SAXParserFactoryImpl

public class SAXParserFactoryImpl
extends SAXParserFactory

Provides a straightforward SAXParserFactory implementation based on Expat. The class is used internally only, thus only notable members that are not already in the abstract superclass are documented.

Constructor Summary

Constructors

Constructor	Description
SAXParserFactoryImpl()

Method Summary

Modifier and Type	Method	Description
boolean	getFeature(String name)	Returns the particular property requested for in the underlying implementation of org.xml.sax.XMLReader.
boolean	isNamespaceAware()	Indicates whether or not the factory is configured to produce parsers which are namespace aware.
boolean	isValidating()	Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse.
SAXParser	newSAXParser()	Creates a new instance of a SAXParser using the currently configured factory parameters.
void	setFeature(String name, boolean value)	Sets the particular feature in the underlying implementation of org.xml.sax.XMLReader.
void	setNamespaceAware(boolean value)	Specifies that the parser produced by this code will provide support for XML namespaces.
void	setValidating(boolean value)	Specifies that the parser produced by this code will validate documents as they are parsed.

Methods inherited from class javax.xml.parsers.SAXParserFactory

getSchema, isXIncludeAware, newInstance, newInstance, setSchema, setXIncludeAware

Methods inherited from class java.lang.Object

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

Constructor Details

SAXParserFactoryImpl

public SAXParserFactoryImpl()

Method Details

getFeature

public boolean getFeature(String name) throws SAXNotRecognizedException

Description copied from class: SAXParserFactory

Returns the particular property requested for in the underlying implementation of org.xml.sax.XMLReader.

Specified by:

getFeature in class SAXParserFactory

Parameters:

name - The name of the property to be retrieved.

Returns:

Value of the requested property.

Throws:

SAXNotRecognizedException - When the underlying XMLReader does not recognize the property name.

See Also:

XMLReader.getProperty(java.lang.String)

isNamespaceAware

public boolean isNamespaceAware()

Description copied from class: SAXParserFactory

Indicates whether or not the factory is configured to produce parsers which are namespace aware.

Overrides:

isNamespaceAware in class SAXParserFactory

Returns:

true if the factory is configured to produce parsers which are namespace aware; false otherwise.

isValidating

public boolean isValidating()

Description copied from class: SAXParserFactory

Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse.

Overrides:

isValidating in class SAXParserFactory

Returns:

true if the factory is configured to produce parsers which validate the XML content during parse; false otherwise.

newSAXParser

public SAXParser newSAXParser() throws ParserConfigurationException

Description copied from class: SAXParserFactory

Creates a new instance of a SAXParser using the currently configured factory parameters.

Specified by:

newSAXParser in class SAXParserFactory

Returns:

A new instance of a SAXParser.

Throws:

ParserConfigurationException - if a parser cannot be created which satisfies the requested configuration.

setFeature

public void setFeature(String name, boolean value) throws SAXNotRecognizedException

Description copied from class: SAXParserFactory

Sets the particular feature in the underlying implementation of org.xml.sax.XMLReader. A list of the core features and properties can be found at http://www.saxproject.org/

All implementations are required to support the XMLConstants.FEATURE_SECURE_PROCESSING feature. When the feature is

• true: the implementation will limit XML processing to conform to implementation limits. Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources. If XML processing is limited for security reasons, it will be reported via a call to the registered ErrorHandler.fatalError(SAXParseException exception). See SAXParser parse methods for handler specification.
• When the feature is false, the implementation will processing XML according to the XML specifications without regard to possible implementation limits.

Specified by:

setFeature in class SAXParserFactory

Parameters:

name - The name of the feature to be set.

value - The value of the feature to be set.

Throws:

SAXNotRecognizedException - When the underlying XMLReader does not recognize the property name.

See Also:

XMLReader.setFeature(java.lang.String, boolean)

setNamespaceAware

public void setNamespaceAware(boolean value)

Description copied from class: SAXParserFactory

Specifies that the parser produced by this code will provide support for XML namespaces. By default the value of this is set to false.

Overrides:

setNamespaceAware in class SAXParserFactory

Parameters:

value - true if the parser produced by this code will provide support for XML namespaces; false otherwise.

setValidating

public void setValidating(boolean value)

Description copied from class: SAXParserFactory

Specifies that the parser produced by this code will validate documents as they are parsed. By default the value of this is set to false.

Note that "the validation" here means a validating parser as defined in the XML recommendation. In other words, it essentially just controls the DTD validation. (except the legacy two properties defined in JAXP 1.2. See here for more details.)

To use modern schema languages such as W3C XML Schema or RELAX NG instead of DTD, you can configure your parser to be a non-validating parser by leaving the SAXParserFactory.setValidating(boolean) method false, then use the SAXParserFactory.setSchema(Schema) method to associate a schema to a parser.

Overrides:

setValidating in class SAXParserFactory

Parameters:

value - true if the parser produced by this code will validate documents as they are parsed; false otherwise.