001    package users.events;
002    
003    /**
004     * An abstract adapter class for receiving capability data events. The methods in this
005     * class are empty. This class exists as convenience for creating listener objects.
006     *
007     * <p>Extend this class to create a CapabilityDataEvent listener and override the methods
008     * for the events of interest. (If you implement the CapabilityDataListener interface, you
009     * have to define all of the methods in it. This abstract class defines empty method bodies for
010     * them all, so you can concentrate on defining methods only for events you care about.)</p>
011     *
012     * <p>Create a listener object using the extended class and then register it with a
013     * user using the user's {@link users.User#addCapabilityDataListener} method. When a capability
014     * is added or replaced, the relevant method in the listener object is invoked, and the
015     * {@link CapabilityDataEvent} is passed to it.</p>
016     *
017     * @see CapabilityDataEvent
018     * @see CapabilityDataListener
019     * @see users.User
020     * @see users.Capability
021     *
022     * @author Steffen Zschaler
023     * @version 2.0 06/05/1999
024     * @since v2.0
025     */
026    public abstract class CapabilityDataAdapter implements CapabilityDataListener {
027    
028        /**
029         * Called whenever capabilities where added to the source. The new capabilities
030         * will be contained in the event object.
031         *
032         * @param e the event object describing the event.
033         *
034         * @override Sometimes
035         */
036        public void capabilitiesAdded(CapabilityDataEvent e) {};
037    
038        /**
039         * Called whenever capabilities where replaced in the source. The new capabilities
040         * will be contained in the event object.
041         *
042         * @param e the event object describing the event.
043         *
044         * @override Sometimes
045         */
046        public void capabilitiesReplaced(CapabilityDataEvent e) {};
047    }