Spec-Zone .ru спецификации, руководства, описания, API

javax.ejb
Интерфейс TimerService

public interface TimerService

Интерфейс TimerService предоставляет компонентам корпоративного компонента доступ к обеспеченной контейнером Службе Таймера. Служба Таймера EJB позволяет бобам сеанса не сохраняющим состояние, одноэлементным бобам сеанса, управляемым сообщением бобам, и EJB 2.x бобы объекта быть зарегистрированными для событий обратного вызова таймера в требуемое время, после указанного прошедшего времени, после указанного интервала, или согласно основанному на календаре расписанию.

С тех пор:

EJB 2.1

Сводка метода

Таймер	createCalendarTimer(ScheduleExpression schedule) Создайте основанный на календаре таймер, основанный на входном выражении расписания.
Таймер	createCalendarTimer(ScheduleExpression schedule, TimerConfig timerConfig) Создайте основанный на календаре таймер, основанный на входном выражении расписания.
Таймер	createIntervalTimer(java.util.Date initialExpiration, long intervalDuration, TimerConfig timerConfig) Создайте таймер интервала, первое истечение которого происходит в данный момент времени и чьи последующие истечения происходят после указанного интервала.
Таймер	createIntervalTimer(long initialDuration, long intervalDuration, TimerConfig timerConfig) Создайте таймер интервала, первое истечение которого происходит после указанной продолжительности, и чьи последующие истечения происходят после указанного интервала.
Таймер	createSingleActionTimer(java.util.Date expiration, TimerConfig timerConfig) Создайте таймер единственного действия, который истекает в данный момент времени.
Таймер	createSingleActionTimer(long duration, TimerConfig timerConfig) Создайте таймер единственного действия, который истекает после указанной продолжительности.
Таймер	createTimer(java.util.Date initialExpiration, long intervalDuration, java.io.Serializable info) Создайте таймер интервала, первое истечение которого происходит в данный момент времени и чьи последующие истечения происходят после указанного интервала.
Таймер	createTimer(java.util.Date expiration, java.io.Serializable info) Создайте таймер единственного действия, который истекает в данный момент времени.
Таймер	createTimer(long initialDuration, long intervalDuration, java.io.Serializable info) Создайте таймер интервала, первое истечение которого происходит после указанной продолжительности, и чьи последующие истечения происходят после указанного интервала.
Таймер	createTimer(long duration, java.io.Serializable info) Создайте таймер единственного действия, который истекает после указанной продолжительности.
java.util.Collection<Timer>	getTimers() Получите все активные таймеры, связанные с этим бобом.

Деталь метода

createTimer

Timer createTimer(long duration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException

Создайте таймер единственного действия, который истекает после указанной продолжительности.

Параметры:

duration - число миллисекунд, которые должны протечь перед таймером, истекает.

info - информация по применению, которая будет поставлена наряду с уведомлением об истечении таймера. Это может быть нулем.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если продолжительность отрицательна

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод перестал работать из-за отказа на уровне системы.

createSingleActionTimer

Timer createSingleActionTimer(long duration,
                              TimerConfig timerConfig)
                              throws java.lang.IllegalArgumentException,
                                     java.lang.IllegalStateException,
                                     EJBException

Создайте таймер единственного действия, который истекает после указанной продолжительности.

Параметры:

duration - число миллисекунд, которые должны протечь перед таймером, истекает.

timerConfig - конфигурация таймера.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если продолжительность отрицательна

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод перестал работать из-за отказа на уровне системы.

С тех пор:

EJB 3.1

createTimer

Timer createTimer(long initialDuration,
                  long intervalDuration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException

Создайте таймер интервала, первое истечение которого происходит после указанной продолжительности, и чьи последующие истечения происходят после указанного интервала.

Параметры:

initialDuration - Число миллисекунд, которые должны протечь перед уведомлением об истечении впервые приехавшего.

intervalDuration - Число миллисекунд, которые должны протечь между уведомлениями об истечении таймера. Уведомления об истечении планируются относительно времени первого истечения. Если истечение задерживается (например, из-за чередования других вызовов метода на бобе), два или больше уведомления об истечении могут произойти в близкой последовательности, чтобы "нагнать".

info - информация по применению, которая будет поставлена наряду с истечением таймера. Это может быть нулем.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если initialDuration отрицателен, или intervalDuration отрицателен.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

createIntervalTimer

Timer createIntervalTimer(long initialDuration,
                          long intervalDuration,
                          TimerConfig timerConfig)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException

Создайте таймер интервала, первое истечение которого происходит после указанной продолжительности, и чьи последующие истечения происходят после указанного интервала.

Параметры:

initialDuration - Число миллисекунд, которые должны протечь перед уведомлением об истечении впервые приехавшего.

intervalDuration - Число миллисекунд, которые должны протечь между уведомлениями об истечении таймера. Уведомления об истечении планируются относительно времени первого истечения. Если истечение задерживается (например, из-за чередования других вызовов метода на бобе), два или больше уведомления об истечении могут произойти в близкой последовательности, чтобы "нагнать".

timerConfig - конфигурация таймера

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если initialDuration отрицателен, или intervalDuration отрицателен.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

С тех пор:

EJB 3.1

createTimer

Timer createTimer(java.util.Date expiration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException

Создайте таймер единственного действия, который истекает в данный момент времени.

Параметры:

expiration - Момент времени, в котором должен истечь таймер.

info - информация по применению, которая будет поставлена наряду с уведомлением об истечении таймера. Это может быть нулем.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если истечение является нулем, или expiration.getTime () отрицателен.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

createSingleActionTimer

Timer createSingleActionTimer(java.util.Date expiration,
                              TimerConfig timerConfig)
                              throws java.lang.IllegalArgumentException,
                                     java.lang.IllegalStateException,
                                     EJBException

Создайте таймер единственного действия, который истекает в данный момент времени.

Параметры:

expiration - момент времени, в котором должен истечь таймер.

timerConfig - конфигурация таймера.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если истечение является нулем, или expiration.getTime () отрицателен.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

С тех пор:

EJB 3.1

createTimer

Timer createTimer(java.util.Date initialExpiration,
                  long intervalDuration,
                  java.io.Serializable info)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException,
                         EJBException

Создайте таймер интервала, первое истечение которого происходит в данный момент времени и чьи последующие истечения происходят после указанного интервала.

Параметры:

initialExpiration - момент времени, в котором должно произойти истечение впервые приехавшего.

intervalDuration - число миллисекунд, которые должны протечь между уведомлениями об истечении таймера. Уведомления об истечении планируются относительно времени первого истечения. Если истечение задерживается (например, из-за чередования других вызовов метода на бобе), два или больше уведомления об истечении могут произойти в близкой последовательности, чтобы "нагнать".

info - информация по применению, которая будет поставлена наряду с истечением таймера. Это может быть нулем.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если initialExpiration является нулем, если initialExpiration.getTime () отрицателен, или если intervalDuration отрицателен.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

createIntervalTimer

Timer createIntervalTimer(java.util.Date initialExpiration,
                          long intervalDuration,
                          TimerConfig timerConfig)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException

Создайте таймер интервала, первое истечение которого происходит в данный момент времени и чьи последующие истечения происходят после указанного интервала.

Параметры:

initialExpiration - момент времени, в котором должно произойти истечение впервые приехавшего.

intervalDuration - число миллисекунд, которые должны протечь между уведомлениями об истечении таймера. Уведомления об истечении планируются относительно времени первого истечения. Если истечение задерживается (например, из-за чередования других вызовов метода на бобе), два или больше уведомления об истечении могут произойти в близкой последовательности, чтобы "нагнать".

timerConfig - конфигурация таймера.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если initialExpiration является нулем, если initialExpiration.getTime () отрицателен, или если intervalDuration отрицателен.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

С тех пор:

EJB 3.1

createCalendarTimer

Timer createCalendarTimer(ScheduleExpression schedule)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException

Создайте основанный на календаре таймер, основанный на входном выражении расписания.

Параметры:

schedule - выражение расписания, описывающее тайм-ауты для этого таймера.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если Расписание представляет недопустимое выражение расписания.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

С тех пор:

EJB 3.1

createCalendarTimer

Timer createCalendarTimer(ScheduleExpression schedule,
                          TimerConfig timerConfig)
                          throws java.lang.IllegalArgumentException,
                                 java.lang.IllegalStateException,
                                 EJBException

Создайте основанный на календаре таймер, основанный на входном выражении расписания.

Параметры:

schedule - выражение расписания, описывающее тайм-ауты для этого таймера.

timerConfig - конфигурация таймера.

Возвраты:

недавно создаваемый Таймер.

Броски:

java.lang.IllegalArgumentException - Если Расписание представляет недопустимое выражение расписания.

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.

С тех пор:

EJB 3.1

getTimers

java.util.Collection<Timer> getTimers()
                                      throws java.lang.IllegalStateException,
                                             EJBException

Получите все активные таймеры, связанные с этим бобом.

Возвраты:

набор javax.ejb.Timer объекты.

Броски:

java.lang.IllegalStateException - Если этот метод вызывается, в то время как экземпляр находится в состоянии, которое не предоставляет доступ к этому методу.

EJBException - Если этот метод не мог бы завершиться из-за отказа на уровне системы.