Package org.apache.avalon.framework.configuration

Component configuration interfaces and XML-based implementations.

See: Description

Interface Summary

Interface	Description
Configurable	This interface should be implemented by classes that need to be configured with custom parameters before initialization.
Configuration	Configuration is a interface encapsulating a configuration node used to retrieve configuration values.
MutableConfiguration	A read/write extension of the Configuration interface.
Reconfigurable	Extends Configurable to allow reconfiguration at runtime.

Class Summary

Class	Description
AbstractConfiguration	This is an abstract Configuration implementation that deals with methods that can be abstracted away from underlying implementations.
ConfigurationUtil	This class has a bunch of utility methods to work with configuration objects.
DefaultConfiguration	This is the default Configuration implementation.
DefaultConfigurationBuilder	A DefaultConfigurationBuilder builds Configurations from XML, via a SAX2 compliant parser.
DefaultConfigurationSerializer	A ConfigurationSerializer serializes configurations via SAX2 compliant parser.
DefaultImmutableConfiguration	An immutable implementation of the Configuration interface.
NamespacedSAXConfigurationHandler	A SAXConfigurationHandler helps build Configurations out of sax events, including namespace information.
SAXConfigurationHandler	A SAXConfigurationHandler helps build Configurations out of sax events.

Exception Summary

Exception	Description
ConfigurationException	Thrown when a Configurable component cannot be configured properly, or if a value cannot be retrieved properly.

Package org.apache.avalon.framework.configuration Description

Component configuration interfaces and XML-based implementations.

The org.apache.avalon.framework.configuration package contains primarily:

• The Configurable interface, which a Component implements if it needs to be configured with externally-specified data before it is initialized.
• The Configuration interface, an implementation of which will be passed to Components that implement Configurable.
• The Reconfigurable interface, which Components implement if they need to be reconfigured at runtime.
• Various classes providing the default XML-based implementation of Configuration. The mapping from XML to Configuration tree is described in DefaultConfigurationBuilder.