View Source Nebulex.Adapter behaviour (Nebulex v2.6.4)

Specifies the minimal API required from adapters.

Summary

Types

adapter_meta()

The metadata returned by the adapter init/1.

metadata()

Metadata type

t()

Adapter

Callbacks

__before_compile__(env)

The callback invoked in case the adapter needs to inject code.

init(config)

Initializes the adapter supervision tree by returning the children.

Functions

defspan(fun, opts \\ [], list)

Helper macro for the adapters so they can add the logic for emitting the recommended Telemetry events.

with_meta(name_or_pid, fun)

Executes the function fun passing as parameters the adapter and metadata (from the init/1 callback) associated with the given cache name_or_pid.

Types

adapter_meta()

@type adapter_meta() :: metadata()

The metadata returned by the adapter init/1.

It must be a map and Nebulex itself will always inject two keys into the meta:

:cache - The cache module.
:pid - The PID returned by the child spec returned in init/1

metadata()

@type metadata() :: %{optional(atom()) => term()}

Metadata type

t()

@type t() :: module()

Adapter

Callbacks

__before_compile__(env)

@macrocallback __before_compile__(env :: Macro.Env.t()) :: Macro.t()

The callback invoked in case the adapter needs to inject code.

init(config)

@callback init(config :: Keyword.t()) :: {:ok, :supervisor.child_spec(), adapter_meta()}

Initializes the adapter supervision tree by returning the children.

Functions

defspan(fun, opts \\ [], list)

(macro)

Helper macro for the adapters so they can add the logic for emitting the recommended Telemetry events.

See the built-in adapters for more information on how to use this macro.

with_meta(name_or_pid, fun)

@spec with_meta(atom() | pid(), (module(), adapter_meta() -> term())) :: term()

Executes the function fun passing as parameters the adapter and metadata (from the init/1 callback) associated with the given cache name_or_pid.

It expects a name or a PID representing the cache.