blockade v0.2.0

View Source blockade (blockade v0.2.0)

This module defines the public API for the blockade application.

Link to this section Summary

Types

dispatch_opts/0
Dispatch options.
event/0
The name of the event.
event_discard/0
Boolean indicating whether to discard events or not in case the priority of the event is lower than the priority of the event manager.
event_manager/0
The name of the event manager process.
event_payload/0
Event payload which can be any term.
priority/0
Priority level. The higher the priority the more important the event.
priority_opts/0
Priority options.
queued_event/0
Queued event.
start_up_opts/0
Start up options which can be passed to the start_link function.

Functions

add_handler(EventManager, Event)

Adds a handler to an event. The process calling the function will be added to the event group.

child_spec(Opts)
Child spec for the blockade event manager supervisor.
discard_events(EventManager, Flag)

Boolean flag to enable or disable the event discarding feature.

dispatch(EventManager, Event, Payload)

Dispatches event asynchronously.

dispatch(EventManager, Event, Payload, Opts)

Dispatches event asynchronously with options.

dispatch_sync(EventManager, Event, Payload)

Dispatches event synchronously.

dispatch_sync(EventManager, Event, Payload, Opts)

Dispatches event synchronously with options.

get_event_queue(EventManager)
Returns the list of queued events.
get_events(EventManager)
Returns a list of events registered under the event manager.
get_handlers(EventManager, Event)
Returns a list of process identifiers that are subscribed to the event.
get_priority(EventManager)
Returns the priority of the event queue.
local_manager_state(EventManager)
Returns the state of the event manager.
prune_event_queue(EventManager)
Removes all queued events.
remove_handler(EventManager, Event)

Remove a handler from an event.

set_priority(EventManager, Priority)

Sets the priority of the event queue.

set_priority(EventManager, Priority, Opts)

Sets the priority of the event queue with options.

start_link(Opts)
Start a blockade event manager supervisor.

Link to this section Types

Link to this type

dispatch_opts/0

View Source 
-type dispatch_opts() ::
    #{priority => priority(),
      members => local | global | external | [node()],
      discard_event => event_discard(),
      atomic_priority_set => priority()}.
Dispatch options.
Link to this type

event/0

View Source 
-type event() :: atom().
The name of the event.
Link to this type

event_discard/0

View Source 
-type event_discard() :: boolean().
Boolean indicating whether to discard events or not in case the priority of the event is lower than the priority of the event manager.
Link to this type

event_manager/0

View Source 
-type event_manager() :: atom().
The name of the event manager process.
Link to this type

event_payload/0

View Source 
-type event_payload() :: term().
Event payload which can be any term.
Link to this type

priority/0

View Source 
-type priority() :: integer().
Priority level. The higher the priority the more important the event.
Link to this type

priority_opts/0

View Source 
-type priority_opts() :: #{reset_after => integer(), discard_events => event_discard()}.
Priority options.
Link to this type

queued_event/0

View Source 
-type queued_event() :: {event(), event_payload(), dispatch_opts()}.
Queued event.
Link to this type

start_up_opts/0

View Source 
-type start_up_opts() ::
    #{name => event_manager(), priority => priority(), discard_events => event_discard()}.
Start up options which can be passed to the start_link function.

Link to this section Functions

Link to this function

add_handler(EventManager, Event)

View Source 
-spec add_handler(event_manager(), event()) -> ok.

Adds a handler to an event. The process calling the function will be added to the event group.

Calling this function multiple times with the same event will add the process to the event group multiple times and the process will receive the event multiple times.
Link to this function

child_spec(Opts)

View Source 
-spec child_spec(map()) -> map().
Child spec for the blockade event manager supervisor.
Link to this function

discard_events(EventManager, Flag)

View Source 
-spec discard_events(event_manager(), event_discard()) -> ok | {error, flag_not_boolean}.

Boolean flag to enable or disable the event discarding feature.

If the flag is set to true, the event queue will discard events that have lower priority than the event queue priority.
Link to this function

dispatch(EventManager, Event, Payload)

View Source 
-spec dispatch(event_manager(), event(), event_payload()) -> ok.

Dispatches event asynchronously.

The event will be dispatched to all the processes that are subscribed to the event.

If no options are passed to the function, the event will be dispatched across the cluster.
Link to this function

dispatch(EventManager, Event, Payload, Opts)

View Source 
-spec dispatch(event_manager(), event(), event_payload(), dispatch_opts()) -> ok.

Dispatches event asynchronously with options.

The event will be dispatched to all the processes that are subscribed to the event.
Link to this function

dispatch_sync(EventManager, Event, Payload)

View Source 
-spec dispatch_sync(event_manager(), event(), event_payload()) ->
                 {ok, event_dispatched} | {ok, event_queued} | {ok, event_discarded}.

Dispatches event synchronously.

The function will return when all messages are sent to the subscribed processes. This does not mean that all processes have handled the event because the messages are sent asynchronously.

The event will be dispatched to all the processes that are subscribed to the event.

If no options are passed to the function, the event will be dispatched across the cluster.
Link to this function

dispatch_sync(EventManager, Event, Payload, Opts)

View Source 
-spec dispatch_sync(event_manager(), event(), event_payload(), dispatch_opts()) ->
                 {ok, event_dispatched} | {ok, event_queued} | {ok, event_discarded}.

Dispatches event synchronously with options.

The function will return when all messages are sent to the subscribed processes. This does not mean that all processes have handled the event because the messages are sent asynchronously.

The event will be dispatched to all the processes that are subscribed to the event.

If no options are passed to the function, the event will be dispatched across the cluster.
Link to this function

get_event_queue(EventManager)

View Source 
-spec get_event_queue(event_manager()) -> {ok, list()}.
Returns the list of queued events.
Link to this function

get_events(EventManager)

View Source 
-spec get_events(event_manager()) -> {ok, [event()]}.
Returns a list of events registered under the event manager.
Link to this function

get_handlers(EventManager, Event)

View Source 
-spec get_handlers(event_manager(), event()) -> {ok, [pid()]}.
Returns a list of process identifiers that are subscribed to the event.
Link to this function

get_priority(EventManager)

View Source 
-spec get_priority(event_manager()) -> {ok, priority()}.
Returns the priority of the event queue.
Link to this function

local_manager_state(EventManager)

View Source 
-spec local_manager_state(event_manager()) -> {ok, map()}.
Returns the state of the event manager.
Link to this function

prune_event_queue(EventManager)

View Source 
-spec prune_event_queue(event_manager()) -> ok.
Removes all queued events.
Link to this function

remove_handler(EventManager, Event)

View Source 
-spec remove_handler(event_manager(), event()) -> ok | not_joined.

Remove a handler from an event.

The process calling the function will be removed from the event group.
Link to this function

set_priority(EventManager, Priority)

View Source 
-spec set_priority(event_manager(), priority()) -> ok | {error, priority_not_integer}.

Sets the priority of the event queue.

The priority will be propagated to all the nodes in the cluster.

Default priority is 0.
Link to this function

set_priority(EventManager, Priority, Opts)

View Source 
-spec set_priority(event_manager(), priority(), priority_opts()) -> ok | {error, priority_not_integer}.

Sets the priority of the event queue with options.

The priority will be propagated to all the nodes in the cluster.

Optionally the priority can be reset after a certain number of milliseconds and events can be discarded if the priority of the event is lower than the priority of the event queue.

Default priority is 0.
Link to this function

start_link(Opts)

View Source 
-spec start_link(start_up_opts()) -> {ok, pid()} | ignore | {error, term()}.
Start a blockade event manager supervisor.