org.axonframework.eventhandling.scheduling
Interface EventScheduler

All Known Implementing Classes:

QuartzEventScheduler, SimpleEventScheduler, StubEventScheduler

public interface EventScheduler

Interface towards a mechanism capable of scheduling the publication of events. The accuracy of the publication time depends on the exact implementation used.

Since:

0.7

Author:

Allard Buijze

Method Summary

void	cancelSchedule(ScheduleToken scheduleToken) Cancel the publication of a scheduled event.
ScheduleToken	schedule(org.joda.time.DateTime triggerDateTime, Object event) Schedule the given event for publication at the given triggerDateTime.
ScheduleToken	schedule(org.joda.time.Duration triggerDuration, Object event) Schedule the given event for publication after the given triggerDuration.

Method Detail

schedule

ScheduleToken schedule(org.joda.time.DateTime triggerDateTime,
                       Object event)

Schedule the given event for publication at the given triggerDateTime. The returned ScheduleToken can be used to cancel the planned publication.

The given event may be any object, as well as an EventMessage. In the latter case, the instance provided is the donor for the payload and Meta Data of the actual message being dispatched. In the former case, the given event will be wrapped as the payload of an EventMessage.

Parameters:

triggerDateTime - The moment to trigger publication of the event

event - The event to publish

Returns:

the token to use when cancelling the schedule

schedule

ScheduleToken schedule(org.joda.time.Duration triggerDuration,
                       Object event)

Schedule the given event for publication after the given triggerDuration. The returned ScheduleToken can be used to cancel the planned publication.

The given event may be any object, as well as an EventMessage. In the latter case, the instance provided is the donor for the payload and Meta Data of the actual message being dispatched. In the former case, the given event will be wrapped as the payload of an EventMessage.

Parameters:

triggerDuration - The amount of time to wait before publishing the event

event - The event to publish

Returns:

the token to use when cancelling the schedule

cancelSchedule

void cancelSchedule(ScheduleToken scheduleToken)

Cancel the publication of a scheduled event. If the events has already been published, this method does nothing.

Parameters:

scheduleToken - the token returned when the event was scheduled

Throws:

IllegalArgumentException - if the token belongs to another scheduler