Устаревшие функции для построения спецификаций детей.

Функции в этом модуле устарели и не работают со спецификациями детей на основе модулей, введёнными в Elixir v1.5. Пожалуйста, обратитесь к документации Supervisor вместо этого.

Функции для удобства определения спецификаций диспетчера.

Пример

Используя функции этого модуля, можно указать детей, которые будут использоваться под диспетчером, запущенным с помощью Supervisor.start_link/2:

import Supervisor.Spec

children = [
  worker(MyWorker, [arg1, arg2, arg3]),
  supervisor(MySupervisor, [arg1])
]

Supervisor.start_link(children, strategy: :one_for_one)

Иногда может быть полезно определять диспетчеров, поддерживаемых модулем:

defmodule MySupervisor do
  use Supervisor

  def start_link(arg) do
    Supervisor.start_link(__MODULE__, arg)
  end

  def init(arg) do
    children = [
      worker(MyWorker, [arg], restart: :temporary)
    ]

    supervise(children, strategy: :simple_one_for_one)
  end
end

Обратите внимание, что в этом случае нам не нужно явно импортировать Supervisor.Spec, так как use Supervisor автоматически это делает. Определение диспетчера на основе модуля может быть полезным, например, для выполнения задач инициализации в обратном вызове Supervisor.init/1.

Опции диспетчера и рабочих процессов

В примере выше мы определили спецификации для рабочих процессов и диспетчеров. Эти спецификации (как для рабочих процессов, так и для диспетчеров) принимают следующие опции:

• :id - имя, используемое для идентификации спецификации ребёнка внутри диспетчера; по умолчанию соответствует имени модуля для рабочего процесса/диспетчера

• :function - функция, вызываемая для запуска ребёнка

• :restart - атом, определяющий, когда следует перезапускать завершённый процесс ребёнка (см. раздел «Значения перезапуска» ниже)

• :shutdown - атом, определяющий, как должен быть завершён процесс ребёнка (см. раздел «Значения завершения» ниже)

• :modules - это должен быть список с одним элементом [module], где модуль — это имя модуля обратного вызова только в том случае, если процесс ребёнка является Supervisor или GenServer; если процесс ребёнка является GenEvent, :modules должно быть :dynamic

Значения перезапуска (:restart)

В опции :restart поддерживаются следующие значения перезапуска:

• :permanent - процесс ребёнка всегда перезапускается

• :temporary - процесс ребёнка никогда не перезапускается (даже когда стратегия диспетчера — :rest_for_one или :one_for_all)

• :transient - процесс ребёнка перезапускается только в случае ненормального завершения, т. е. с причиной выхода, отличной от :normal, :shutdown или {:shutdown, term}

Обратите внимание, что диспетчер, достигший максимальной интенсивности перезапуска, завершит работу с причиной :shutdown. В этом случае диспетчер будет перезапущен только в том случае, если его спецификация ребёнка была определена с опцией :restart установленной в :permanent (по умолчанию).

Значения завершения (:shutdown)

В опции :shutdown поддерживаются следующие значения завершения:

• :brutal_kill - процесс ребёнка безусловно завершается с помощью Process.exit(child, :kill)

• :infinity - если процесс ребёнка — это диспетчер, это механизм, позволяющий поддереву достаточно времени для завершения работы; его также можно использовать с рабочими процессами с осторожностью

• положительное целое число — количество миллисекунд, которое диспетчер даёт процессу ребёнка для завершения с помощью вызова Process.exit(child, :shutdown), а затем ожидает сигнал выхода обратно. Если сигнал выхода не получен в течение заданного времени, процесс ребёнка безусловно завершается с помощью Process.exit(child, :kill)