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
Callback implementation for c:Mnemonix.Store.Behaviours.Map.delete/2
Callback implementation for c:Mnemonix.Store.Behaviours.Map.fetch/2
Callback implementation for c:Mnemonix.Store.Behaviours.Map.put/3
Creates a Mnesia table to store state in using provided opts
Starts a new store using the Mnemonix.Stores.Mnesia
module with options
Starts a new store using Mnemonix.Stores.Mnesia
with store
and server
options
Link to this section Functions
delete(Mnemonix.Store.t(), Mnemonix.key()) :: {:ok, Mnemonix.Store.t()} | Mnemonix.Store.Behaviour.exception()
Callback implementation for c:Mnemonix.Store.Behaviours.Map.delete/2
.
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
.
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
.
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
- Default:
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:
%{}
- Default:
The rest of the options are passed into :dets.open_file/2
verbaitm, except
for type:
, which will always be :set
.
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"
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"