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

javax.ejb
Класс ScheduleExpression

java.lang.Object
  javax.ejb.ScheduleExpression

Все Реализованные Интерфейсы:

java.io. Сериализуемый

public class ScheduleExpression
расширяет java.lang. Объект
реализации java.io. Сериализуемый

Основанное на календаре выражение тайм-аута для таймера корпоративного компонента.

У каждого атрибута, используемого, чтобы определить основанное на календаре расписание тайм-аута, есть два перегруженных метода метода set, тот, который берет Строку и тот, который берет интервал. Международная версия является просто методом удобства для того, чтобы установить атрибут в общем падеже, что значение является простым целочисленным значением.

Например,

scheduleExpression.second(10)

семантически эквивалентно

scheduleExpression.second("10")

Есть семь атрибутов, которые составляют спецификацию расписания, которые упоминаются ниже. Кроме того, timezone атрибут может использоваться, чтобы определить часовой пояс не по умолчанию, в контексте которого должна быть оценена спецификация расписания.

Атрибуты, которые определяют само основанное на календаре расписание, - следующие:

• во-вторых: одна или более секунд в течение минуты

  Допустимые значения: [0,59]

• минута: одна или более минут в течение часа

  Допустимые значения: [0,59]

• час: один или более часов в течение дня

  Допустимые значения: [0,23]

• dayOfMonth: один или более дней в течение месяца

  Допустимые значения:

  • [1,31]
  • [-7, -1]
  • "Последний"
  • {"1-ый", "2-ой", "3-ий", "4-ый", "5-ый", "Последний"} {"Sun", "понедельник", "вторник", "Wed", "четверг", "пятница", "Находился"}

  "Последний" означает прошлый день месяца

  -x (где x находится в диапазоне [-7,-1]) означает x день (ни) перед прошлым днем месяца

  "1-ый", "2-ой", и т.д. применялся ко дню недели, идентифицирует отдельное проявление того дня в течение месяца.

• месяц: один или более месяцев в течение года

  Допустимые значения:

  • [1,12]
  • {"Ян", "февраль", "март", "апрель", "май", "июнь", "июль", "август", "сентябрь", "октябрь", "ноябрь", декабрь"}

• dayOfWeek: один или более дней в течение недели

  Допустимые значения:

  • [0,7]
  • {"Sun", "понедельник", "вторник", "Wed", "четверг", "пятница", "Находился"}

  "0" и "7" оба обращаются к воскресенью

• год: определенный календарный год

  Допустимые значения: четырехразрядный календарный год

Каждый атрибут поддерживает значения, выраженные в одной из следующих форм

• Единственное Значение. Это ограничивает атрибут к только одному из его возможных значений.

   
   Example: second = "10"
   Example: month = "Sep"

• Подстановочный знак. "*" представляет все допустимые значения для данного атрибута.

   Example: second = "*"
   Example: dayOfWeek = "*"

• Список. Это ограничивает атрибут к двум или больше допустимым значениям или диапазонам с запятой, используемой в качестве символа разделителя в пределах строки. Каждый элемент в списке должен быть единственным значением или диапазоном. Элементы списка не могут быть списками, подстановочными знаками, или инкрементами. Игнорируются двойные значения.

   Example: second = "10,20,30"
   Example: dayOfWeek = "Mon,Wed,Fri"
   Example: minute = "0-10,30,40"

• Диапазон. Это ограничивает атрибут к содержащему диапазону значений с тире, разделяющим оба конца диапазона. Каждая сторона диапазона должна быть единственным значением атрибута. Элементы диапазона не могут быть списками, подстановочными знаками, диапазонами, или инкрементами. Если x больше чем y в диапазоне "x-y", диапазон эквивалентен "x-max, min-y", где max самое большое значение соответствующего атрибута и min является самым маленьким. Диапазон "x-x", то, где оба значения диапазона являются тем же самым, оценивает к единственному значению x. День недельного диапазона "0-7" эквивалентно "*".

   Example: second = "1-10"
   Example: dayOfWeek = "Fri-Mon"
   Example: dayOfMonth = "27-3" (Equivalent to "27-Last , 1-3")

• Инкременты. Наклонная черта вправо ограничивает атрибут, основанный на начальной точке и интервале, и используется, чтобы определить каждый N секунды, минуты, или часы в течение минуты, час, или день, соответственно. Для выражения x/y, атрибут ограничивается к каждому yth оценивают в пределах набора допустимых значений, начинающихся во время x. x значение является содержащим. Подстановочный символ (*) может использоваться в x позиция, и эквивалентна 0. Использование инкрементов только поддерживается в пределах second, minute, и hour атрибуты. Для second и minute атрибуты, x и y должен каждый быть в диапазоне [0,59]. Для hour атрибут, x и y должен каждый быть в диапазоне [0,23].

   Example: minute = "∗/5" (Every five minutes within the hour)

  Это эквивалентно: minute = "0,5,10,15,20,25,30,35,40,45,50,55"

   Example: second = "30/10" (Every 10 seconds within the minute, starting at second 30) 

  Это эквивалентно: second = "30,40,50"

  Отметьте, что набор соответствия остановок значений инкремента однажды максимальное значение для того атрибута превышается. Это не "переворачивается" мимо границы.

   Example : ( minute = "∗/14", hour="1,2")

  Это эквивалентно: (minute = "0,14,28,42,56", hour = "1,2") (Каждые 14 минут в течение часа, в течение часов 1:00 и 2:00)

Следующие дополнительные правила применяются к атрибутам спецификации расписания:

• Если dayOfMonth у атрибута есть неподстановочное значение и dayOfWeek у атрибута есть неподстановочное значение, тогда любой день, соответствуя любому dayOfMonth значение или dayOfWeek значение, как будут полагать, будет применяться.
• Пробел игнорируется, за исключением строковых констант и числовых значений.
• Все строковые константы (например, "Sun", "Jan", "1st", и т.д.), являются нечувствительными к регистру.

Основанные на расписании времена таймера оцениваются в контексте часового пояса значения по умолчанию, связанного с контейнером, в котором выполняется приложение. Основанный на расписании таймер может дополнительно переопределить это значение по умолчанию и партнера непосредственно с определенным часовым поясом. Если основанный на расписании таймер связывается с определенным часовым поясом, все его времена оцениваются в контексте того часового пояса, независимо от часового пояса значения по умолчанию, в котором выполняется контейнер.

Ни один из методов ScheduleExpression не обязан быть вызванным. Значения по умолчанию:

• во-вторых: "0"
• минута: "0"
• час: "0"
• dayOfMonth: "*"
• месяц: "*"
• dayOfWeek: "*"
• год: "*"
• часовой пояс: часовой пояс JVM значения по умолчанию
• запустите: после создания таймера
• конец: никакая дата окончания

Приложения не должны положиться на методы метода get, которые возвращаются, атрибуты основанного на календаре тайм-аута планируют возвращать их в том же самом синтаксическом формате, в котором в них передали к a ScheduleExpression метод или предоставленный Schedule аннотация, и переносимые реализации не должны принять определенный синтаксический формат. Реализации требуются только сохранить семантическую эквивалентность.

С тех пор:

EJB 3.1

См. Также:

Сериализированная Форма

Сводка конструктора

ScheduleExpression()
Создайте расписание со значениями по умолчанию.

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

ScheduleExpression	dayOfMonth(int d) Установите день атрибута месяца.
ScheduleExpression	dayOfMonth(java.lang.String d) Установите день атрибута месяца.
ScheduleExpression	dayOfWeek(int d) Установите день недельного атрибута.
ScheduleExpression	dayOfWeek(java.lang.String d) Установите день недельного атрибута.
ScheduleExpression	end(java.util.Date e) Установите дату окончания.
java.lang.String	getDayOfMonth() Возвратите значение дня атрибута месяца.
java.lang.String	getDayOfWeek() Возвратите значение дня недельного атрибута.
java.util.Date	getEnd() Возвратите дату окончания, если установлено; иначе нуль.
java.lang.String	getHour() Возвратите значение атрибута часа.
java.lang.String	getMinute() Возвратите значение мелкого атрибута.
java.lang.String	getMonth() Возвратите значение атрибута месяца.
java.lang.String	getSecond() Возвратите значение второго атрибута.
java.util.Date	getStart() Возвратите дату начала, если установлено; иначе нуль.
java.lang.String	getTimezone() Возвратите часовой пояс, если установлено; иначе нуль.
java.lang.String	getYear() Возвратите значение атрибута года.
ScheduleExpression	hour(int h) Установите атрибут часа.
ScheduleExpression	hour(java.lang.String h) Установите атрибут часа.
ScheduleExpression	minute(int m) Установите мелкий атрибут.
ScheduleExpression	minute(java.lang.String m) Установите мелкий атрибут.
ScheduleExpression	month(int m) Установите атрибут месяца.
ScheduleExpression	month(java.lang.String m) Установите атрибут месяца.
ScheduleExpression	second(int s) Установите второй атрибут.
ScheduleExpression	second(java.lang.String s) Установите второй атрибут.
ScheduleExpression	start(java.util.Date s) Установите дату начала.
ScheduleExpression	timezone(java.lang.String timezoneID) Установите часовой пояс.
java.lang.String	toString()
ScheduleExpression	year(int y) Установите атрибут года.
ScheduleExpression	year(java.lang.String y) Установите атрибут года.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь конструктора

ScheduleExpression

public ScheduleExpression()

Создайте расписание со значениями по умолчанию.

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

второй

public ScheduleExpression second(java.lang.String s)

Установите второй атрибут.

второй

public ScheduleExpression second(int s)

Установите второй атрибут.

getSecond

public java.lang.String getSecond()

Возвратите значение второго атрибута.

Возвраты:

второй

минута

public ScheduleExpression minute(java.lang.String m)

Установите мелкий атрибут.

минута

public ScheduleExpression minute(int m)

Установите мелкий атрибут.

getMinute

public java.lang.String getMinute()

Возвратите значение мелкого атрибута.

Возвраты:

минута

час

public ScheduleExpression hour(java.lang.String h)

Установите атрибут часа.

час

public ScheduleExpression hour(int h)

Установите атрибут часа.

getHour

public java.lang.String getHour()

Возвратите значение атрибута часа.

Возвраты:

час

dayOfMonth

public ScheduleExpression dayOfMonth(java.lang.String d)

Установите день атрибута месяца.

dayOfMonth

public ScheduleExpression dayOfMonth(int d)

Установите день атрибута месяца.

getDayOfMonth

public java.lang.String getDayOfMonth()

Возвратите значение дня атрибута месяца.

Возвраты:

день месяца

месяц

public ScheduleExpression month(java.lang.String m)

Установите атрибут месяца.

месяц

public ScheduleExpression month(int m)

Установите атрибут месяца.

getMonth

public java.lang.String getMonth()

Возвратите значение атрибута месяца.

Возвраты:

месяц

dayOfWeek

public ScheduleExpression dayOfWeek(java.lang.String d)

Установите день недельного атрибута.

dayOfWeek

public ScheduleExpression dayOfWeek(int d)

Установите день недельного атрибута.

getDayOfWeek

public java.lang.String getDayOfWeek()

Возвратите значение дня недельного атрибута.

Возвраты:

день недели

год

public ScheduleExpression year(java.lang.String y)

Установите атрибут года.

год

public ScheduleExpression year(int y)

Установите атрибут года.

getYear

public java.lang.String getYear()

Возвратите значение атрибута года.

Возвраты:

год

часовой пояс

public ScheduleExpression timezone(java.lang.String timezoneID)

Установите часовой пояс.

getTimezone

public java.lang.String getTimezone()

Возвратите часовой пояс, если установлено; иначе нуль.

Возвраты:

часовой пояс

запустить

public ScheduleExpression start(java.util.Date s)

Установите дату начала.

getStart

public java.util.Date getStart()

Возвратите дату начала, если установлено; иначе нуль.

Возвраты:

дата начала

конец

public ScheduleExpression end(java.util.Date e)

Установите дату окончания.

getEnd

public java.util.Date getEnd()

Возвратите дату окончания, если установлено; иначе нуль.

Возвраты:

дата окончания

toString

public java.lang.String toString()

Переопределения:

toString в class java.lang.Object