Spec-Zone.ru › Elixir 1.9

GenEvent поведение

Это поведение устарело. Используйте модуль :gen_event Erlang/OTP вместо этого.

Менеджер событий с поведением обработчиков событий.

Если вы заинтересованы в реализации менеджера событий, пожалуйста, прочитайте раздел "Альтернативы" ниже. Если вам необходимо реализовать обработчик событий для интеграции с существующей системой, такой как Elixir's Logger, пожалуйста, используйте :gen_event.

Альтернативы

Существует несколько подходящих альтернатив GenEvent. Каждая из них может быть наиболее выгодной в зависимости от сценария использования.

Supervisor и GenServers

Альтернативой GenEvent является очень простое решение, которое состоит из использования супервайзера и нескольких GenServers, запущенных под ним. Супервайзер выступает как "менеджер событий", а дочерние GenServers как "обработчики событий". Этот подход имеет некоторые недостатки (например, он не предоставляет обратную связь), но все же может заменить GenEvent для нетребовательных сценариев его использования. Эта публикация в блоге от José Valim содержит более подробную информацию об этом подходе.

GenStage

Если сценарий использования, в котором вы использовали GenEvent, требует более сложной логики, GenStage предоставляет отличную альтернативу. GenStage — это внешняя библиотека Elixir, поддерживаемая командой Elixir; она предоставляет инструмент для реализации систем, которые обмениваются событиями в режиме запроса-ответа с встроенной поддержкой обратной связи. Более подробную информацию см. в документации GenStage.

:gen_event

Если ваш сценарий использования требует именно того, что предоставлял GenEvent, или вам необходимо интегрироваться с существующей системой на основе :gen_event, вы по-прежнему можете использовать :gen_event модуль Erlang.

Краткое описание

Типы

handler()
manager()
name()
on_start()
options()

Обработчики

code_change(old_vsn, state, extra)
handle_call(request, state)
handle_event(event, state)
handle_info(msg, state)
init(args)
terminate(reason, state)

Типы

handler()

Спецификации

handler() :: atom() | {atom(), term()}

manager()

Спецификации

manager() :: pid() | name() | {atom(), node()}

name()

Спецификации

name() :: atom() | {:global, term()} | {:via, module(), term()}

on_start()

Спецификации

on_start() :: {:ok, pid()} | {:error, {:already_started, pid()}}

options()

Спецификации

options() :: [{:name, name()}]

Обработчики

code_change(old_vsn, state, extra)

Спецификации

code_change(old_vsn, state :: term(), extra :: term()) ::
  {:ok, new_state :: term()}
when old_vsn: term() | {:down, term()}

handle_call(request, state)

Спецификации

handle_call(request :: term(), state :: term()) ::
  {:ok, reply, new_state}
  | {:ok, reply, new_state, :hibernate}
  | {:remove_handler, reply}
when reply: term(), new_state: term()

handle_event(event, state)

Спецификации

handle_event(event :: term(), state :: term()) ::
  {:ok, new_state} | {:ok, new_state, :hibernate} | :remove_handler
when new_state: term()

handle_info(msg, state)

Спецификации

handle_info(msg :: term(), state :: term()) ::
  {:ok, new_state} | {:ok, new_state, :hibernate} | :remove_handler
when new_state: term()

init(args)

Спецификации

init(args :: term()) ::
  {:ok, state} | {:ok, state, :hibernate} | {:error, reason :: any()}
when state: any()

terminate(reason, state)

Спецификации

terminate(reason, state :: term()) :: term()
when reason:
       :stop | {:stop, term()} | :remove_handler | {:error, term()} | term()

© 2012 Plataformatec
Licensed under the Apache License, Version 2.0.
https://hexdocs.pm/elixir/1.9.4/GenEvent.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API