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

Функции в этом модуле устарели и не работают с основанными на модуле спецификациями потомков, представленными в 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], где 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)