org.apache.xerces.util
Class ParserConfigurationSettings

java.lang.Object
  |
  +--org.apache.xerces.util.ParserConfigurationSettings
All Implemented Interfaces:
org.apache.xerces.xni.parser.XMLComponentManager
Direct Known Subclasses:
BasicParserConfiguration, DOMConfigurationImpl

public class ParserConfigurationSettings
extends java.lang.Object
implements org.apache.xerces.xni.parser.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.

Version:
$Id: ParserConfigurationSettings.java,v 1.5 2002/09/24 23:05:18 elena Exp $
Author:
Andy Clark, IBM

Field Summary
protected  java.util.Hashtable fFeatures
          Features.
protected  org.apache.xerces.xni.parser.XMLComponentManager fParentSettings
          Parent parser configuration settings.
protected  java.util.Hashtable fProperties
          Properties.
protected  java.util.Vector fRecognizedFeatures
          Recognized features.
protected  java.util.Vector fRecognizedProperties
          Recognized properties.
 
Constructor Summary
ParserConfigurationSettings()
          Default Constructor.
ParserConfigurationSettings(org.apache.xerces.xni.parser.XMLComponentManager parent)
          Constructs a parser configuration settings object with a parent settings object.
 
Method Summary
 void addRecognizedFeatures(java.lang.String[] featureIds)
          Allows a parser to add parser specific features to be recognized and managed by the parser configuration.
 void addRecognizedProperties(java.lang.String[] propertyIds)
          Allows a parser to add parser specific properties to be recognized and managed by the parser configuration.
protected  void checkFeature(java.lang.String featureId)
          Check a feature.
protected  void checkProperty(java.lang.String propertyId)
          Check a property.
 boolean getFeature(java.lang.String featureId)
          Returns the state of a feature.
 java.lang.Object getProperty(java.lang.String propertyId)
          Returns the value of a property.
 void setFeature(java.lang.String featureId, boolean state)
           
 void setProperty(java.lang.String propertyId, java.lang.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 java.util.Vector fRecognizedProperties
Recognized properties.

fProperties

protected java.util.Hashtable fProperties
Properties.

fRecognizedFeatures

protected java.util.Vector fRecognizedFeatures
Recognized features.

fFeatures

protected java.util.Hashtable fFeatures
Features.

fParentSettings

protected org.apache.xerces.xni.parser.XMLComponentManager fParentSettings
Parent parser configuration settings.
Constructor Detail

ParserConfigurationSettings

public ParserConfigurationSettings()
Default Constructor.

ParserConfigurationSettings

public ParserConfigurationSettings(org.apache.xerces.xni.parser.XMLComponentManager parent)
Constructs a parser configuration settings object with a parent settings object.
Method Detail

addRecognizedFeatures

public void addRecognizedFeatures(java.lang.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(java.lang.String featureId,
                       boolean state)
                throws org.apache.xerces.xni.parser.XMLConfigurationException

addRecognizedProperties

public void addRecognizedProperties(java.lang.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(java.lang.String propertyId,
                        java.lang.Object value)
                 throws org.apache.xerces.xni.parser.XMLConfigurationException
setProperty
Parameters:
propertyId -  
value -  
Throws:
org.apache.xerces.xni.parser.XMLConfigurationException - If the requested feature is not known.

getFeature

public boolean getFeature(java.lang.String featureId)
                   throws org.apache.xerces.xni.parser.XMLConfigurationException
Returns the state of a feature.
Specified by:
getFeature in interface org.apache.xerces.xni.parser.XMLComponentManager
Parameters:
featureId - The feature identifier.
Returns:
true if the feature is supported
Throws:
org.apache.xerces.xni.parser.XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

getProperty

public java.lang.Object getProperty(java.lang.String propertyId)
                             throws org.apache.xerces.xni.parser.XMLConfigurationException
Returns the value of a property.
Specified by:
getProperty in interface org.apache.xerces.xni.parser.XMLComponentManager
Parameters:
propertyId - The property identifier.
Returns:
the value of the property
Throws:
org.apache.xerces.xni.parser.XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

checkFeature

protected void checkFeature(java.lang.String featureId)
                     throws org.apache.xerces.xni.parser.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:
org.apache.xerces.xni.parser.XMLConfigurationException - If the requested feature is not known.

checkProperty

protected void checkProperty(java.lang.String propertyId)
                      throws org.apache.xerces.xni.parser.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:
org.apache.xerces.xni.parser.XMLConfigurationException - If the requested feature is not known.


Copyright © 1999-2003 Apache XML Project. All Rights Reserved.