http://commons.apache.org/configuration/: Tools to assist in the reading of configuration/preferences files in various formats. (The Apache Software Foundation)
  • Konstantin Shaposhnikov (scand.com)
  • Jamie M. Guillemette (TD Bank)
  • Jorge Ferrer ()
  • Gabriele Garuglieri (Infoblu S.p.A)
  • Nicolas De Loof (Cap Gemini)
  • Daniel Rall (CollabNet, Inc.)
  • Jason van Zyl (Zenplex)
  • Martin Poeschl (tucana.at)
  • dIon Gillard (Multitask Consulting)
  • Henning P. Schmiedehausen
  • Eric Pugh (upstate.com)
  • Brian E. Dunbar (dunbarconsulting.org)
  • Emmanuel Bourg (Ariane Software)
  • Oliver Heger (Agfa HealthCare)
  • Jörg Schaible
  • Ralph Goers (Intuit) 
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.commons.configuration.event;



An event listener interface to be implemented by observers that are
interested in internal errors caused by processing of configuration
properties.




Some configuration classes use an underlying storage where each access of a
property can cause an exception. In earlier versions of this library such
exceptions were typically ignored. By implementing this interface and
registering at a configuration object as an error listener it is now possible
for clients to receive notifications about those internal problems.



Author:Commons
Configuration team
See Also:
Version:$Id: ConfigurationErrorListener.java 1207610 2011-11-28 21:06:22Z oheger $
Since:1.4
/**
 * <p>
 * An event listener interface to be implemented by observers that are
 * interested in internal errors caused by processing of configuration
 * properties.
 * </p>
 * <p>
 * Some configuration classes use an underlying storage where each access of a
 * property can cause an exception. In earlier versions of this library such
 * exceptions were typically ignored. By implementing this interface and
 * registering at a configuration object as an error listener it is now possible
 * for clients to receive notifications about those internal problems.
 * </p>
 *
 * @author <a
 * href="http://commons.apache.org/configuration/team-list.html">Commons
 * Configuration team</a>
 * @version $Id: ConfigurationErrorListener.java 1207610 2011-11-28 21:06:22Z oheger $
 * @since 1.4
 * @see ConfigurationErrorEvent
 */
public interface ConfigurationErrorListener
{
    
Notifies this listener that in an observed configuration an error occurred. All information available about this error, including the causing Throwable object, can be obtained from the passed in event object. 
Params:
  • event – the event object with information about the error
/**
     * Notifies this listener that in an observed configuration an error
     * occurred. All information available about this error, including the
     * causing {@code Throwable} object, can be obtained from the passed
     * in event object.
     *
     * @param event the event object with information about the error
     */
    void configurationError(ConfigurationErrorEvent event);
}