Перейти к основному содержимому
Начало работы
Руководство администратора
How To статьи
Установка и настройка
Компоненты
Руководство пользователя

Scheduler

Общее описание

Компонент Scheduler используется для инициализации потока по установленному расписанию. Этот компонент похож на компонент Timer, но обладает большей функциональностью в отношении планирования.

Блок Scheduler может использоваться в качестве:

- блока-отправителя.

Настройка блока

В данном разделе описаны параметры блока Scheduler, которые необходимо заполнить при настройке и примеры заполнения значений этих параметров.

Базовые параметры блока Scheduler

Название в UIНазвание атрибутаОбязательныйОписаниеЗначение по умолчаниюТип данных
NamenameДаНазвание планировщикаСтрока
Include MetadataincludeMetadataОпределяет следует ли отправлять в обработку внутреннего движка метаданные, такие как время срабатывания, название планировщика, количество планировщиков и т.д.FalseЛогическое значение
Send Empty Message When IdlesendEmptyMessageWhenIdleОпределяет нужно ли возвращать пустое сообщение, если планировщик запустился, но в результате не было создано или обработано никаких данных.FalseЛогическое значение
Backoff Error ThresholdbackoffErrorThresholdКоличество последовательно полученных ошибок обработки, после которого планировщик перейдет в режим пропуска запусковЦелочисленное значение
Backoff Idle ThresholdbackoffIdleThresholdКоличество последовательных запросов, которые не привели к созданию или обработке данных. После достижения установленного количества планировщик перейдет в режим пропуска запусковЦелочисленное значение
Backoff MultiplierbackoffMultiplier

Если достигнуто количество последовательно полученных ошибок, заданное в параметре Backoff Error Threshold или количество последовательных пустых запросов, установленных в параметре Backoff Idle Threshold, то следующие срабатывания планировщика будут пропущены столько раз, сколько указано в Backoff Multiplier. После пропуска заданного количества срабатываний планировщик начнет работать в обычном режиме, пока снова не перейдет в режим пропуска запусков.

Этот параметр следует задавать в том случае, если установлены параметры Backoff Error Threshold и/или Backoff Idle Threshold.

Целочисленное значение
DelaydelayПромежуток времени в миллисекундах до следующего срабатывания планировщика.500Длинное целое значение
GreedygreedyЕсли значение параметра установлено в True, то после того как планировщик сработал и привел к созданию или обработке данных, он сразу сработает еще раз.FalseЛогическое значение
Initial DelayinitialDelayПромежуток времени в миллисекундах до первого срабатывания.1000Длинное целое значение
Pool sizepoolSizeКоличество тредов в пуле, который будет использовать планировщик.1Целочисленное значение
Repeat CountrepeatCountЗадает максимальное количество срабатываний. Соответственно, если вы установите значение 1, планировщик сработает только один раз. Если вы установите значение 5, планировщик сработает пять раз. Нулевое или отрицательное значение означает, что планировщик срабатывает постоянно без ограничений по количеству срабатываний.0Длинное целое значение
Run Logging LevelrunLoggingLevel

При инициации потока по планировщику будет происходить логирование старта и финиша этого события. Данный параметр позволяет настроить уровень логирования

Возможные значения:

  • TRACE

  • DEBUF

  • INFO

  • WARN

  • ERROR

  • OFF

TRACEСписок
Scheduled Executor ServicescheduledExecutorServiceПозволяет задать имя пользовательского/общего пула потоков, который будет использоваться планировщиком. По умолчанию, каждый планировщик использует свой собственный пул.Строка
SchedulerschedulerПозволяет указать имя CRON-планировщика из компонента Spring или Camel-Quartz. Используйте Value Spring или Quartz для встроенного планировщика.noneСтрока
Scheduler PropertiesschedulerPropertiesПрименяется для настройки дополнительных свойств при использовании пользовательского планировщика или любого из планировщиков на основе Camel-Quartz и Spring.Строка
Start SchedulerstartSchedulerОпределяет следует ли автоматически запускать планировщик.TrueЛогическое значение
Time UnittimeUnit

Задает единицы измерения времени для параметров Initial Delay и Delay.

Возможные значения:

  • Nanoseconds

  • Microseconds

  • Milliseconds

  • Seconds

  • Minutes

  • Hours

  • Days

MillisecondsСписок
Use Fixed Delayuse Fixed Delay

Определяет нужно ли использовать фиксированную задержку после выполнения последнего запуска планировщика или строго выполнять запуск по установленному расписанию.

Если значение параметра True, то между запусками будет фиксированная пауза, равная значению, выставленному в Delay.

Если значение параметра False, то запуск планировщика будет строго привязан к расписанию и пауза, заданная в параметре Delay будет считаться от старта запуска планировщика а не с момента окончания его действия.

TrueЛогическое значение

Расширенные параметры блока Scheduler

Название в UIНазваниеОбязательныйОписаниеЗначение по умолчаниюТип данных
Bridge Error HandlerbridgeErrorHandler

Позволяет передавать возникшую ошибку из блока «наверх», т. е. на уровень потока, позволяя самостоятельно сконфигурировать собственные правила обработки ошибки через вспомогательные блоки.

Примечание: это возможно только в том случае, если сторонний компонент позволяет системе получать оповещение о возникновении исключения. Некоторые компоненты обрабатывают это только внутренне, и поэтому применение Bridge Error Handler невозможно.

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

FalseЛогическое значение
Exception HandlerexceptionHandler

Задает пользовательский обработчик исключений.

Примечание: По умолчанию обработке подлежат исключения, регистрируемые на уровне WARN и ERROR, которые затем игнорируются и не влияют на выполнение логики.

Строка
Exchange PatternexchangePattern

Устанавливает стиль взаимодействия с присоединенной частью потока.

Возможные значения:

  • InOnly — планировщик стартует поток и не ждет подтверждения от самого потока.

  • InОut — планировщик стартует поток и ожидает получения ответа от потока, когда тот закончит выполнять свою логику. Пока ответ не будет получен — следующее срабатывание планировщика не произойдет.

Список
Poll StrategypollStrategyПодключаемая стратегия, позволяющая вам предоставить свою пользовательскую реализацию для управления обработкой ошибок, которые обычно возникают на первых этапах инициации потока согласно расписанию планировщикаСтрока
SynchronoussynchronousОпределяет, следует ли использовать только синхронную обработку.FalseЛогическое значение