Specs

__before_compile__(term(), env :: Macro.Env.t()) :: Macro.t()

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

Specs

delete(cache(), key(), opts()) :: :ok

Deletes a single object from cache.

See Nebulex.Cache.delete/2.

Specs

expire(cache(), key(), ttl :: timeout()) :: timeout() | nil

Returns the expiry timestamp for the given key, if the timeout ttl (in seconds) is successfully updated.

If key doesn't exist, nil is returned.

See Nebulex.Cache.expire/2.

Specs

flush(cache()) :: :ok

Flushes the cache.

See Nebulex.Cache.flush/0.

Specs

get(cache(), key(), opts()) :: object() | nil

Retrieves a single object from cache.

See Nebulex.Cache.get/2.

Specs

get_many(cache(), [key()], opts()) :: map()

Returns a map with the objects for all specified keys. For every key that does not hold a value or does not exist, that key is simply ignored. Because of this, the operation never fails.

See Nebulex.Cache.get_many/2.

Specs

has_key?(cache(), key()) :: boolean()

Returns whether the given key exists in cache.

See Nebulex.Cache.has_key?/1.

Specs

init(opts()) ::
  {:ok, [:supervisor.child_spec() | {module(), term()} | module()]}

Initializes the adapter supervision tree by returning the children

Specs

object_info(cache(), key(), attr :: :ttl | :version) :: term() | nil

Returns the information associated with attr for the given key, or returns nil if key doesn't exist.

See Nebulex.Cache.object_info/2.

Specs

set(cache(), object(), opts()) :: boolean()

Sets the given object under key into the cache.

If the object already exists, it is overwritten. Any previous time to live associated with the key is discarded on successful set operation.

Returns true if an object with key key is found and successfully inserted, otherwise false.

Options

Besides the "Shared options" section in Nebulex.Cache documentation, it accepts:

• :action - It may be one of :add, :replace, :set (the default). See the "Actions" section for more information.

Actions

The :action option supports the following values:

• :add - Only set the key if it does not already exist. If it does, false is returned.

• :replace - Alters the object stored under key, but only if the object already exists into the cache.

• :set - Set key to hold the given object (default).

See Nebulex.Cache.set/3, Nebulex.Cache.add/3, Nebulex.Cache.replace/3.

Specs

set_many(cache(), [object()], opts()) :: :ok | {:error, failed_keys :: [key()]}

Sets the given objects, replacing existing ones, just as regular set.

Returns :ok if the all objects were successfully set, otherwise {:error, failed_keys}, where failed_keys contains the keys that could not be set.

Ideally, this operation should be atomic, so all given keys are set at once. But it depends purely on the adapter's implementation and the backend used internally by the adapter. Hence, it is recommended to checkout the adapter's documentation.

See Nebulex.Cache.set_many/2.

Specs

size(cache()) :: integer()

Returns the total number of cached entries.

See Nebulex.Cache.size/0.

Specs

take(cache(), key(), opts()) :: object() | nil

Returns and removes the object with key key in the cache.

See Nebulex.Cache.take/2.

Specs

update_counter(cache(), key(), incr :: integer(), opts()) :: integer()

Updates (increment or decrement) the counter mapped to the given key.

See Nebulex.Cache.update_counter/3.