Event Listeners

<atlassian-plugin name="Example Listeners" key="crowd.listeners.core" system="false">

    <plugin-info>
        <description>This contains example listeners</description>
        <vendor name="Atlassian Software Systems" url="http://www.atlassian.com"/>
        <version>1.0</version>
    </plugin-info>

    <listener name="Reset Password Listener" key="resetpasswordlistener" class="com.atlassian.crowd.event.listener.ResetPasswordListener">
        <description>Will handle reset password events, sending out a principal their new password.</description>
    </listener>
</atlassian-plugin>

package com.atlassian.event;

/**
 * Defines a listener for Crowd events.
 */
public interface EventListener
{
    /**
     * Perform some action as a response to an event. The EventManager will
     * ensure that this is only called if the class of the event matches one of the
     * classes returned by getHandledEventClasses
     *
     * @param event some event triggered within Crowd
     */
    void handleEvent(Event event);

    /**
     * Determine which event classes this listener is interested in.
     * 
     * <p>The EventManager performs rudimentary filtering of events by their class. If
     * you want to receive only a subset of events passing through the system, return
     * an array of the Classes you wish to listen for from this method.
     *
     * <p>Listening for a class will also listen for all its subclasses. (And listening
     * for an interface will listen for any implementation of that interface)
     *
     * <p>Returning an empty array will allow you to receive every event.
     *
     * @return An array of the event classes that this event listener is interested in,
     *         or an empty array if the listener should receive all events. <b>Must not</b>
     *         return null.
     */
    Class[] getHandledEventClasses();
}