модуль ActiveJob::QueueAdapters
Адаптеры Active Job
Active Job имеет адаптеры для следующих backends очередей:
-
Примечание: Мы не принимаем запросы на добавление новых адаптеров. Более подробную информацию см. в README.
Для тестирования и разработки Active Job имеет три встроенных адаптера:
Функции бэкэндов
| | Async | Queues | Delayed | Priorities | Timeout | Retries | |-------------------|-------|--------|------------|------------|---------|---------| | Backburner | Yes | Yes | Yes | Yes | Job | Global | | Delayed Job | Yes | Yes | Yes | Job | Global | Global | | Que | Yes | Yes | Yes | Job | No | Job | | queue_classic | Yes | Yes | Yes* | No | No | No | | Resque | Yes | Yes | Yes (Gem) | Queue | Global | Yes | | Sidekiq | Yes | Yes | Yes | Queue | No | Job | | Sneakers | Yes | Yes | No | Queue | Queue | No | | Sucker Punch | Yes | Yes | Yes | No | No | No | | Active Job Async | Yes | Yes | Yes | No | No | No | | Active Job Inline | No | Yes | N/A | N/A | N/A | N/A | | Active Job Test | No | Yes | N/A | N/A | N/A | N/A |
Асинхронный
Да: Адаптер очереди может запускать задачу в неблокирующем режиме. Он выполняется либо в отдельном или разветвлённом процессе, либо в другом потоке.
Нет: Задача выполняется в том же процессе.
Очереди
Да: Задачи могут задавать очередь, в которой они будут выполняться, с помощью `queue_as` или метода `set`.
Отложенный
Да: Адаптер запустит задачу в будущем через `perform_later`.
(Gem): Для использования `perform_later` с этим адаптером требуется дополнительный gem.
Нет: Адаптер выполнит задачи в ближайшее время и не может использовать `perform_later`.
Н/Д: Адаптер не поддерживает очереди.
ПРИМЕЧАНИЕ: `queue_classic` поддерживает планирование задач с версии 3.1. Для более старых версий можно использовать gem `queue_classic-later`.
Приоритеты
Порядок обработки задач может быть настроен по-разному в зависимости от адаптера.
Задача: Любой класс, унаследованный от адаптера, может установить приоритет объекта задачи относительно других задач.
Очередь: Адаптер может установить приоритет для очередей задач, и при настройке очереди с Active Job этот приоритет будет учтён.
Да: Разрешает устанавливать приоритет объекта задачи, на уровне очереди или как параметр по умолчанию.
Нет: Адаптер не позволяет настраивать приоритет задач.
Н/Д: Адаптер не поддерживает очереди, а следовательно, и сортировку.
Таймаут
Время, по истечении которого задача остановится.
Задача: Таймаут может быть установлен для каждого экземпляра класса задачи.
Очередь: Таймаут устанавливается для всех задач в очереди.
Глобально: Адаптер настроен так, что все задачи имеют максимальное время выполнения.
Нет: Адаптер не позволяет настраивать таймаут задач.
Н/Д: Этот адаптер не выполняется в отдельном процессе, поэтому таймаут не поддерживается.
Повторные попытки
Задача: Количество повторов может быть установлено для каждого экземпляра класса задачи.
Да: Количество повторных попыток может быть настроено глобально, для каждого экземпляра или в очереди. Этот адаптер также может представлять собой неудачные экземпляры класса задачи, которые можно перезапустить.
Глобально: Адаптер имеет глобальное количество повторных попыток.
Нет: Адаптер не позволяет настраивать количество повторных попыток.
Н/Д: Адаптер не выполняется в отдельном процессе, и поэтому не поддерживает повторные попытки.
Публичные методы класса
# File activejob/lib/active_job/queue_adapters.rb, line 137 def lookup(name) const_get(name.to_s.camelize << ADAPTER) end
Возвращает адаптер для указанного имени.
ActiveJob::QueueAdapters.lookup(:sidekiq) # => ActiveJob::QueueAdapters::SidekiqAdapter
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.