org.htmlunit.cyberneko.xerces.util

Class ParserConfigurationSettings

java.lang.Object

org.htmlunit.cyberneko.xerces.util.ParserConfigurationSettings

All Implemented Interfaces:

XMLComponentManager

Direct Known Subclasses:

HTMLConfiguration

public class ParserConfigurationSettings
extends Object
implements XMLComponentManager

This class implements the basic operations for managing parser configuration features and properties. This utility class can be used as a base class for parser configurations or separately to encapsulate a number of parser settings as a component manager.

This class can be constructed with a "parent" settings object (in the form of an XMLComponentManager) that allows parser configuration settings to be "chained" together.

Author:

Andy Clark, IBM

Constructor Summary

Constructors

Constructor and Description
ParserConfigurationSettings()

Method Summary

Modifier and Type	Method and Description
void	addRecognizedFeatures(String[] featureIds) Allows a parser to add parser specific features to be recognized and managed by the parser configuration.
void	addRecognizedProperties(String[] propertyIds) Allows a parser to add parser specific properties to be recognized and managed by the parser configuration.
protected void	checkFeature(String featureId) Check a feature.
protected void	checkProperty(String propertyId) Check a property.
boolean	getFeature(String featureId)
Object	getProperty(String propertyId)
void	setFeature(String featureId, boolean state) Set the state of a feature.
void	setProperty(String propertyId, Object value) setProperty

Methods inherited from class java.lang.Object

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

Constructor Detail

ParserConfigurationSettings

public ParserConfigurationSettings()

Method Detail

addRecognizedFeatures

public void addRecognizedFeatures(String[] featureIds)

Allows a parser to add parser specific features to be recognized and managed by the parser configuration.

Parameters:

featureIds - An array of the additional feature identifiers to be recognized.

setFeature

public void setFeature(String featureId,
                       boolean state)
                throws XMLConfigurationException

Set the state of a feature.

Set the state of any feature in a SAX2 parser. The parser might not recognize the feature, and if it does recognize it, it might not be able to fulfill the request.

Parameters:

featureId - The unique identifier (URI) of the feature.

state - The requested state of the feature (true or false).

Throws:

XMLConfigurationException - If the requested feature is not known.

addRecognizedProperties

public void addRecognizedProperties(String[] propertyIds)

Allows a parser to add parser specific properties to be recognized and managed by the parser configuration.

Parameters:

propertyIds - An array of the additional property identifiers to be recognized.

setProperty

public void setProperty(String propertyId,
                        Object value)
                 throws XMLConfigurationException

setProperty

Parameters:

propertyId - the property id

value - the value

Throws:

XMLConfigurationException - If the requested feature is not known.

getFeature

public boolean getFeature(String featureId)
                   throws XMLConfigurationException

Specified by:

getFeature in interface XMLComponentManager

Parameters:

featureId - The feature identifier.

Returns:

the state of a feature.

Throws:

XMLConfigurationException - Thrown on configuration error.

getProperty

public Object getProperty(String propertyId)
                   throws XMLConfigurationException

Specified by:

getProperty in interface XMLComponentManager

Parameters:

propertyId - The property identifier.

Returns:

the value of a property.

Throws:

XMLConfigurationException - Thrown on configuration error.

checkFeature

protected void checkFeature(String featureId)
                     throws XMLConfigurationException

Check a feature. If feature is known and supported, this method simply returns. Otherwise, the appropriate exception is thrown.

Parameters:

featureId - The unique identifier (URI) of the feature.

Throws:

XMLConfigurationException - If the requested feature is not known.

checkProperty

protected void checkProperty(String propertyId)
                      throws XMLConfigurationException

Check a property. If the property is known and supported, this method simply returns. Otherwise, the appropriate exception is thrown.

Parameters:

propertyId - The unique identifier (URI) of the property being set.

Throws:

XMLConfigurationException - If the requested feature is not known.