net.sourceforge.htmlunit.xerces.util

Class ParserConfigurationSettings

java.lang.Object

net.sourceforge.htmlunit.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

Field Summary

Fields

Modifier and Type	Field and Description
protected HashMap<String,Boolean>	fFeatures Features.
protected HashMap<String,Object>	fProperties Properties.
protected ArrayList<String>	fRecognizedFeatures Recognized features.
protected ArrayList<String>	fRecognizedProperties Recognized properties.

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

Field Detail

fRecognizedProperties

protected final ArrayList<String> fRecognizedProperties

Recognized properties.

fProperties

protected final HashMap<String,Object> fProperties

Properties.

fRecognizedFeatures

protected final ArrayList<String> fRecognizedFeatures

Recognized features.

fFeatures

protected final HashMap<String,Boolean> fFeatures

Features.

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.