javax.ejb
Interface TimerService


public interface TimerService

The TimerService interface provides enterprise bean components with access to the container-provided Timer Service. The EJB Timer Service allows stateless session beans, singleton session beans, message-driven beans, and EJB 2.x entity beans to be registered for timer callback events at a specified time, after a specified elapsed time, after a specified interval, or according to a calendar-based schedule.

Since:
EJB 2.1

Method Summary
 Timer createCalendarTimer(ScheduleExpression schedule)
          Create a calendar-based timer based on the input schedule expression.
 Timer createCalendarTimer(ScheduleExpression schedule, TimerConfig timerConfig)
          Create a calendar-based timer based on the input schedule expression.
 Timer createIntervalTimer(java.util.Date initialExpiration, long intervalDuration, TimerConfig timerConfig)
          Create an interval timer whose first expiration occurs at a given point in time and whose subsequent expirations occur after a specified interval.
 Timer createIntervalTimer(long initialDuration, long intervalDuration, TimerConfig timerConfig)
          Create an interval timer whose first expiration occurs after a specified duration, and whose subsequent expirations occur after a specified interval.
 Timer createSingleActionTimer(java.util.Date expiration, TimerConfig timerConfig)
          Create a single-action timer that expires at a given point in time.
 Timer createSingleActionTimer(long duration, TimerConfig timerConfig)
          Create a single-action timer that expires after a specified duration.
 Timer createTimer(java.util.Date initialExpiration, long intervalDuration, java.io.Serializable info)
          Create an interval timer whose first expiration occurs at a given point in time and whose subsequent expirations occur after a specified interval.
 Timer createTimer(java.util.Date expiration, java.io.Serializable info)
          Create a single-action timer that expires at a given point in time.
 Timer createTimer(long initialDuration, long intervalDuration, java.io.Serializable info)
          Create an interval timer whose first expiration occurs after a specified duration, and whose subsequent expirations occur after a specified interval.
 Timer createTimer(long duration, java.io.Serializable info)
          Create a single-action timer that expires after a specified duration.
 java.util.Collection<Timer> getTimers()
          Get all the active timers associated with this bean.
 

Method Detail

createTimer

Timer createTimer(long duration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException
Create a single-action timer that expires after a specified duration.

Parameters:
duration - the number of milliseconds that must elapse before the timer expires.
info - application information to be delivered along with the timer expiration notification. This can be null.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If duration is negative
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method fails due to a system-level failure.

createSingleActionTimer

Timer createSingleActionTimer(long duration,
                              TimerConfig timerConfig)
                              throws java.lang.IllegalArgumentException,
                                     java.lang.IllegalStateException,
                                     EJBException
Create a single-action timer that expires after a specified duration.

Parameters:
duration - the number of milliseconds that must elapse before the timer expires.
timerConfig - timer configuration.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If duration is negative
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method fails due to a system-level failure.
Since:
EJB 3.1

createTimer

Timer createTimer(long initialDuration,
                  long intervalDuration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException
Create an interval timer whose first expiration occurs after a specified duration, and whose subsequent expirations occur after a specified interval.

Parameters:
initialDuration - The number of milliseconds that must elapse before the first timer expiration notification.
intervalDuration - The number of milliseconds that must elapse between timer expiration notifications. Expiration notifications are scheduled relative to the time of the first expiration. If expiration is delayed (e.g. due to the interleaving of other method calls on the bean), two or more expiration notifications may occur in close succession to "catch up".
info - application information to be delivered along with the timer expiration. This can be null.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If initialDuration is negative or intervalDuration is negative.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.

createIntervalTimer

Timer createIntervalTimer(long initialDuration,
                          long intervalDuration,
                          TimerConfig timerConfig)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException
Create an interval timer whose first expiration occurs after a specified duration, and whose subsequent expirations occur after a specified interval.

Parameters:
initialDuration - The number of milliseconds that must elapse before the first timer expiration notification.
intervalDuration - The number of milliseconds that must elapse between timer expiration notifications. Expiration notifications are scheduled relative to the time of the first expiration. If expiration is delayed (e.g. due to the interleaving of other method calls on the bean), two or more expiration notifications may occur in close succession to "catch up".
timerConfig - timer configuration
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If initialDuration is negative or intervalDuration is negative.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.
Since:
EJB 3.1

createTimer

Timer createTimer(java.util.Date expiration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException
Create a single-action timer that expires at a given point in time.

Parameters:
expiration - The point in time at which the timer must expire.
info - application information to be delivered along with the timer expiration notification. This can be null.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If expiration is null or expiration.getTime() is negative.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.

createSingleActionTimer

Timer createSingleActionTimer(java.util.Date expiration,
                              TimerConfig timerConfig)
                              throws java.lang.IllegalArgumentException,
                                     java.lang.IllegalStateException,
                                     EJBException
Create a single-action timer that expires at a given point in time.

Parameters:
expiration - the point in time at which the timer must expire.
timerConfig - timer configuration.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If expiration is null or expiration.getTime() is negative.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.
Since:
EJB 3.1

createTimer

Timer createTimer(java.util.Date initialExpiration,
                  long intervalDuration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException
Create an interval timer whose first expiration occurs at a given point in time and whose subsequent expirations occur after a specified interval.

Parameters:
initialExpiration - the point in time at which the first timer expiration must occur.
intervalDuration - the number of milliseconds that must elapse between timer expiration notifications. Expiration notifications are scheduled relative to the time of the first expiration. If expiration is delayed (e.g. due to the interleaving of other method calls on the bean), two or more expiration notifications may occur in close succession to "catch up".
info - application information to be delivered along with the timer expiration. This can be null.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If initialExpiration is null, if initialExpiration.getTime() is negative, or if intervalDuration is negative.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.

createIntervalTimer

Timer createIntervalTimer(java.util.Date initialExpiration,
                          long intervalDuration,
                          TimerConfig timerConfig)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException
Create an interval timer whose first expiration occurs at a given point in time and whose subsequent expirations occur after a specified interval.

Parameters:
initialExpiration - the point in time at which the first timer expiration must occur.
intervalDuration - the number of milliseconds that must elapse between timer expiration notifications. Expiration notifications are scheduled relative to the time of the first expiration. If expiration is delayed (e.g. due to the interleaving of other method calls on the bean), two or more expiration notifications may occur in close succession to "catch up".
timerConfig - timer configuration.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If initialExpiration is null, if initialExpiration.getTime() is negative, or if intervalDuration is negative.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.
Since:
EJB 3.1

createCalendarTimer

Timer createCalendarTimer(ScheduleExpression schedule)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException
Create a calendar-based timer based on the input schedule expression.

Parameters:
schedule - a schedule expression describing the timeouts for this timer.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If Schedule represents an invalid schedule expression.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.
Since:
EJB 3.1

createCalendarTimer

Timer createCalendarTimer(ScheduleExpression schedule,
                          TimerConfig timerConfig)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException
Create a calendar-based timer based on the input schedule expression.

Parameters:
schedule - a schedule expression describing the timeouts for this timer.
timerConfig - timer configuration.
Returns:
the newly created Timer.
Throws:
java.lang.IllegalArgumentException - If Schedule represents an invalid schedule expression.
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.
Since:
EJB 3.1

getTimers

java.util.Collection<Timer> getTimers()
                                      throws java.lang.IllegalStateException,
                                             EJBException
Get all the active timers associated with this bean.

Returns:
a collection of javax.ejb.Timer objects.
Throws:
java.lang.IllegalStateException - If this method is invoked while the instance is in a state that does not allow access to this method.
EJBException - If this method could not complete due to a system-level failure.


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41