|
An event class that is used for reporting errors that occurred while
processing configuration properties.
Some configuration implementations (e.g.
org.apache.commons.configuration.DatabaseConfiguration
or
org.apache.commons.configuration.JNDIConfiguration
use an underlying storage that can throw an exception on each property
access. In earlier versions of this library such exceptions were logged and
then silently ignored. This makes it impossible for a client to find out that
something went wrong.
To give clients better control over the handling of errors that occur during
access of a configuration object a new event listener mechanism specific for
exceptions is introduced: Clients can register itself at a configuration
object as an error listener and are then notified about all
internal errors related to the source configuration object.
By inheriting from ConfigurationEvent this event class
supports all properties that describe an operation on a configuration
instance. In addition a Throwable object is available
representing the occurred error. The event's type determines the operation
that caused the error. Note that depending on the event type and the occurred
exception not all of the other properties (e.g. name of the affected property
or its value) may be available.
author:
author:
href="http://jakarta.apache.org/commons/configuration/team-list.html">Commons
author:
Configuration team
version:
$Id: ConfigurationErrorEvent.java 495926 2007-01-13 17:06:29Z oheger $
since:
1.4
See Also: ConfigurationEvent | 