org.quartz
Interface ListenerManager

All Known Implementing Classes:

ListenerManagerImpl

public interface ListenerManager

Client programs may be interested in the 'listener' interfaces that are available from Quartz. The JobListener interface provides notifications of Job executions. The TriggerListener interface provides notifications of Trigger firings. The SchedulerListener interface provides notifications of Scheduler events and errors. Listeners can be associated with local schedulers through the ListenerManager interface.

Since:

2.0 - previously listeners were managed directly on the Scheduler interface.

Author:

jhouse

Method Summary

void	addJobListener(JobListener jobListener, java.util.List<Matcher<JobKey>> matchers) Add the given JobListener to the Scheduler, and register it to receive events for Jobs that are matched by ANY of the given Matchers.
void	addJobListener(JobListener jobListener, Matcher<JobKey>... matchers) Add the given JobListener to the Scheduler, and register it to receive events for Jobs that are matched by ANY of the given Matchers.
boolean	addJobListenerMatcher(java.lang.String listenerName, Matcher<JobKey> matcher) Add the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.
void	addSchedulerListener(SchedulerListener schedulerListener) Register the given SchedulerListener with the Scheduler.
void	addTriggerListener(TriggerListener triggerListener, java.util.List<Matcher<TriggerKey>> matchers) Add the given TriggerListener to the Scheduler, and register it to receive events for Triggers that are matched by ANY of the given Matchers.
void	addTriggerListener(TriggerListener triggerListener, Matcher<TriggerKey>... matchers) Add the given TriggerListener to the Scheduler, and register it to receive events for Triggers that are matched by ANY of the given Matchers.
boolean	addTriggerListenerMatcher(java.lang.String listenerName, Matcher<TriggerKey> matcher) Add the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.
JobListener	getJobListener(java.lang.String name) Get the JobListener that has the given name.
java.util.List<Matcher<JobKey>>	getJobListenerMatchers(java.lang.String listenerName) Get the set of Matchers for which the listener will receive events if ANY of the matchers match.
java.util.List<JobListener>	getJobListeners() Get a List containing all of the JobListeners in the Scheduler.
java.util.List<SchedulerListener>	getSchedulerListeners() Get a List containing all of the SchedulerListeners registered with the Scheduler.
TriggerListener	getTriggerListener(java.lang.String name) Get the TriggerListener that has the given name.
java.util.List<Matcher<TriggerKey>>	getTriggerListenerMatchers(java.lang.String listenerName) Get the set of Matchers for which the listener will receive events if ANY of the matchers match.
java.util.List<TriggerListener>	getTriggerListeners() Get a List containing all of the TriggerListeners in the Scheduler.
boolean	removeJobListener(java.lang.String name) Remove the identified JobListener from the Scheduler.
boolean	removeJobListenerMatcher(java.lang.String listenerName, Matcher<JobKey> matcher) Remove the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.
boolean	removeSchedulerListener(SchedulerListener schedulerListener) Remove the given SchedulerListener from the Scheduler.
boolean	removeTriggerListener(java.lang.String name) Remove the identified TriggerListener from the Scheduler.
boolean	removeTriggerListenerMatcher(java.lang.String listenerName, Matcher<TriggerKey> matcher) Remove the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.
boolean	setJobListenerMatchers(java.lang.String listenerName, java.util.List<Matcher<JobKey>> matchers) Set the set of Matchers for which the listener will receive events if ANY of the matchers match.
boolean	setTriggerListenerMatchers(java.lang.String listenerName, java.util.List<Matcher<TriggerKey>> matchers) Set the set of Matchers for which the listener will receive events if ANY of the matchers match.

Method Detail

addJobListener

void addJobListener(JobListener jobListener,
                    Matcher<JobKey>... matchers)

Add the given JobListener to the Scheduler, and register it to receive events for Jobs that are matched by ANY of the given Matchers. If no matchers are provided, the EverythingMatcher will be used.

See Also:

Matcher, EverythingMatcher

addJobListener

void addJobListener(JobListener jobListener,
                    java.util.List<Matcher<JobKey>> matchers)

Add the given JobListener to the Scheduler, and register it to receive events for Jobs that are matched by ANY of the given Matchers. If no matchers are provided, the EverythingMatcher will be used.

See Also:

Matcher, EverythingMatcher

addJobListenerMatcher

boolean addJobListenerMatcher(java.lang.String listenerName,
                              Matcher<JobKey> matcher)

Add the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.

Parameters:

listenerName - the name of the listener to add the matcher to

matcher - the additional matcher to apply for selecting events

Returns:

true if the identified listener was found and updated

Throws:

SchedulerException

removeJobListenerMatcher

boolean removeJobListenerMatcher(java.lang.String listenerName,
                                 Matcher<JobKey> matcher)

Remove the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.

Parameters:

listenerName - the name of the listener to add the matcher to

matcher - the additional matcher to apply for selecting events

Returns:

true if the given matcher was found and removed from the listener's list of matchers

Throws:

SchedulerException

setJobListenerMatchers

boolean setJobListenerMatchers(java.lang.String listenerName,
                               java.util.List<Matcher<JobKey>> matchers)

Set the set of Matchers for which the listener will receive events if ANY of the matchers match.

Removes any existing matchers for the identified listener!

Parameters:

listenerName - the name of the listener to add the matcher to

matchers - the matchers to apply for selecting events

Returns:

true if the given matcher was found and removed from the listener's list of matchers

Throws:

SchedulerException

getJobListenerMatchers

java.util.List<Matcher<JobKey>> getJobListenerMatchers(java.lang.String listenerName)

Get the set of Matchers for which the listener will receive events if ANY of the matchers match.

Parameters:

listenerName - the name of the listener to add the matcher to

Returns:

the matchers registered for selecting events for the identified listener

Throws:

SchedulerException

removeJobListener

boolean removeJobListener(java.lang.String name)

Remove the identified JobListener from the Scheduler.

Returns:

true if the identified listener was found in the list, and removed.

getJobListeners

java.util.List<JobListener> getJobListeners()

Get a List containing all of the JobListeners in the Scheduler.

getJobListener

JobListener getJobListener(java.lang.String name)

Get the JobListener that has the given name.

addTriggerListener

void addTriggerListener(TriggerListener triggerListener,
                        Matcher<TriggerKey>... matchers)

Add the given TriggerListener to the Scheduler, and register it to receive events for Triggers that are matched by ANY of the given Matchers. If no matcher is provided, the EverythingMatcher will be used.

See Also:

Matcher, EverythingMatcher

addTriggerListener

void addTriggerListener(TriggerListener triggerListener,
                        java.util.List<Matcher<TriggerKey>> matchers)

Add the given TriggerListener to the Scheduler, and register it to receive events for Triggers that are matched by ANY of the given Matchers. If no matcher is provided, the EverythingMatcher will be used.

See Also:

Matcher, EverythingMatcher

addTriggerListenerMatcher

boolean addTriggerListenerMatcher(java.lang.String listenerName,
                                  Matcher<TriggerKey> matcher)

Add the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.

Parameters:

listenerName - the name of the listener to add the matcher to

matcher - the additional matcher to apply for selecting events

Returns:

true if the identified listener was found and updated

Throws:

SchedulerException

removeTriggerListenerMatcher

boolean removeTriggerListenerMatcher(java.lang.String listenerName,
                                     Matcher<TriggerKey> matcher)

Remove the given Matcher to the set of matchers for which the listener will receive events if ANY of the matchers match.

Parameters:

listenerName - the name of the listener to add the matcher to

matcher - the additional matcher to apply for selecting events

Returns:

true if the given matcher was found and removed from the listener's list of matchers

Throws:

SchedulerException

setTriggerListenerMatchers

boolean setTriggerListenerMatchers(java.lang.String listenerName,
                                   java.util.List<Matcher<TriggerKey>> matchers)

Set the set of Matchers for which the listener will receive events if ANY of the matchers match.

Removes any existing matchers for the identified listener!

Parameters:

listenerName - the name of the listener to add the matcher to

matchers - the matchers to apply for selecting events

Returns:

true if the given matcher was found and removed from the listener's list of matchers

Throws:

SchedulerException

getTriggerListenerMatchers

java.util.List<Matcher<TriggerKey>> getTriggerListenerMatchers(java.lang.String listenerName)

Get the set of Matchers for which the listener will receive events if ANY of the matchers match.

Parameters:

listenerName - the name of the listener to add the matcher to

Returns:

the matchers registered for selecting events for the identified listener

Throws:

SchedulerException

removeTriggerListener

boolean removeTriggerListener(java.lang.String name)

Remove the identified TriggerListener from the Scheduler.

Returns:

true if the identified listener was found in the list, and removed.

getTriggerListeners

java.util.List<TriggerListener> getTriggerListeners()

Get a List containing all of the TriggerListeners in the Scheduler.

getTriggerListener

TriggerListener getTriggerListener(java.lang.String name)

Get the TriggerListener that has the given name.

addSchedulerListener

void addSchedulerListener(SchedulerListener schedulerListener)

Register the given SchedulerListener with the Scheduler.

removeSchedulerListener

boolean removeSchedulerListener(SchedulerListener schedulerListener)

Remove the given SchedulerListener from the Scheduler.

Returns:

true if the identified listener was found in the list, and removed.

getSchedulerListeners

java.util.List<SchedulerListener> getSchedulerListeners()

Get a List containing all of the SchedulerListeners registered with the Scheduler.