Application: gvSIG desktop » Library: org.gvsig.tools

import org.gvsig.tools.observer.impl.DefaultComplexNotification;

/**

 * A interface to be implemented by objects that want to be

 * informed of changes in {@link Observable} objects.

 * 

 * @see ComplexObserver

 * 

 * @author gvSIG Team

 * @version $Id$

 */

    /**

     * Called whenever a {@link Observable} object is changed and this

     * {@link Observer} has registered on it to receive notifications.

     * <p>

     * Implementations of this method will be called for each simple

     * notification or, if a complex notification is created, for each of the

     * child notifications.

     * </p>

     * <p>

     * In the latter case, don't assume any ordering in the notification between

     * this {@link Observer} and other {@link Observer}s listening to the same

     * {@link Observable}.

     * </p>

     * <p>

     * In a complex notification scenario, if you want to receive only the

     * complex notification and not each of the child notifications, just

     * implement the {@link ComplexObserver} and prepare this method

     * implementation to handle receiving {@link DefaultComplexNotification} instances

     * as well as direct notification objects.

     * </p>

     * 

     * @param observable

     *            the observable object.

     * @param notification

     *            the notification data.

     */