Mnemonix

v0.10.0

Mnemonix v0.10.0 Mnemonix.Stores.Mnesia View Source

A Mnemonix.Store that uses a Mnesia table to store state.

Before using, your current node should be part of a Mnesia schema and the Mnesia application must have been started.

iex> {:ok, store} = Mnemonix.Stores.Mnesia.start_link
iex> Mnemonix.put(store, "foo", "bar")
iex> Mnemonix.get(store, "foo")
"bar"
iex> Mnemonix.delete(store, "foo")
iex> Mnemonix.get(store, "foo")
nil

This store throws errors on the functions in Mnemonix.Features.Enumerable.

Link to this section Summary

Functions

delete(store, key)

Callback implementation for c:Mnemonix.Store.Behaviours.Map.delete/2

fetch(store, key)

Callback implementation for c:Mnemonix.Store.Behaviours.Map.fetch/2

put(store, key, value)

Callback implementation for c:Mnemonix.Store.Behaviours.Map.put/3

setup(opts)

Creates a Mnesia table to store state in using provided opts

start_link(options \\ [])

Starts a new store using the Mnemonix.Stores.Mnesia module with options

start_link(store, server)

Starts a new store using Mnemonix.Stores.Mnesia with store and server options

Link to this section Functions

Link to this function delete(store, key) View Source 
delete(Mnemonix.Store.t(), Mnemonix.key()) ::
  {:ok, Mnemonix.Store.t()} |
  Mnemonix.Store.Behaviour.exception()

Callback implementation for c:Mnemonix.Store.Behaviours.Map.delete/2.

Link to this function fetch(store, key) View Source 
fetch(Mnemonix.Store.t(), Mnemonix.key()) ::
  {:ok, Mnemonix.Store.t(), {:ok, Mnemonix.value()} | :error} |
  Mnemonix.Store.Behaviour.exception()

Callback implementation for c:Mnemonix.Store.Behaviours.Map.fetch/2.

Link to this function put(store, key, value) View Source 
put(Mnemonix.Store.t(), Mnemonix.key(), Mnemonix.Store.value()) ::
  {:ok, Mnemonix.Store.t()} |
  Mnemonix.Store.Behaviour.exception()

Callback implementation for c:Mnemonix.Store.Behaviours.Map.put/3.

Link to this function setup(opts) View Source 
setup(Mnemonix.Store.options()) ::
  {:ok, state :: term()} |
  {:stop, reason :: any()}

Creates a Mnesia table to store state in using provided opts.

If the table specified already exists, it will use that instead.

Options

  • table: Name of the table to use, will be created if it doesn’t exist.

    • Default: Mnemonix.Stores.Mnesia.Table

  • transactional: Whether or not to perform transactional reads or writes.

    • Allowed: :reads | :writes | :both | nil

    • Default: :both

  • initial: A map of key/value pairs to ensure are set on the table at boot.

    • Default: %{}

The rest of the options are passed into :dets.open_file/2 verbaitm, except for type:, which will always be :set.

Link to this function start_link(options \\ []) View Source 
start_link(Mnemonix.Supervisor.options()) :: GenServer.on_start()

Starts a new store using the Mnemonix.Stores.Mnesia module with options.

The options are the same as described in Mnemonix.Features.Supervision.start_link/2. The :store options are used in config/1 to start the store; the :server options are passed directly to GenServer.start_link/2.

The returned GenServer.server/0 reference can be used as the primary argument to the Mnemonix API.

Examples 

iex> {:ok, store} = Mnemonix.Stores.Mnesia.start_link()
iex> Mnemonix.put(store, "foo", "bar")
iex> Mnemonix.get(store, "foo")
"bar"

iex> {:ok, _store} = Mnemonix.Stores.Mnesia.start_link(server: [name: My.Mnemonix.Stores.Mnesia])
iex> Mnemonix.put(My.Mnemonix.Stores.Mnesia, "foo", "bar")
iex> Mnemonix.get(My.Mnemonix.Stores.Mnesia, "foo")
"bar"
Link to this function start_link(store, server) View Source 
start_link(Mnemonix.Supervisor.options(), GenServer.options()) :: GenServer.on_start()

Starts a new store using Mnemonix.Stores.Mnesia with store and server options.

The options are the same as described in Mnemonix.start_link/2. The store options are used in config/1 to start the store; the server options are passed directly to GenServer.start_link/2.

The returned GenServer.server/0 reference can be used as the primary argument to the Mnemonix API.

Examples 

iex> {:ok, store} = Mnemonix.Stores.Mnesia.start_link([], [])
iex> Mnemonix.put(store, "foo", "bar")
iex> Mnemonix.get(store, "foo")
"bar"

iex> {:ok, _store} = Mnemonix.Stores.Mnesia.start_link([], [name: My.Mnemonix.Stores.Mnesia])
iex> Mnemonix.put(My.Mnemonix.Stores.Mnesia, "foo", "bar")
iex> Mnemonix.get(My.Mnemonix.Stores.Mnesia, "foo")
"bar"