Packages

Aerospike driver for Elixir with an OTP-native cluster runtime

Current section

Files

Jump to
aerospike_driver lib aerospike command put.ex
Raw

lib/aerospike/command/put.ex

defmodule Aerospike.Command.Put do
@moduledoc false
alias Aerospike.Command.UnaryCommand
alias Aerospike.Command.UnarySupport
alias Aerospike.Error
alias Aerospike.Key
alias Aerospike.Policy
alias Aerospike.Protocol.AsmMsg
alias Aerospike.Protocol.AsmMsg.Operation
alias Aerospike.Protocol.Message
alias Aerospike.Protocol.Response
alias Aerospike.Record
alias Aerospike.Runtime.TxnSupport
@type option ::
{:timeout, non_neg_integer()}
| {:socket_timeout, non_neg_integer()}
| {:max_retries, non_neg_integer()}
| {:sleep_between_retries_ms, non_neg_integer()}
| {:ttl, non_neg_integer() | :default | :never_expire | :dont_update}
| {:generation, non_neg_integer()}
| {:generation_policy, :none | :expect_equal | :expect_gt}
| {:filter, Aerospike.Exp.t() | nil}
| {:commit_level, :all | :master}
| {:durable_delete, boolean()}
| {:send_key, boolean()}
| {:use_compression, boolean()}
| {:exists, :update | :update_only | :create_or_replace | :replace_only | :create_only}
@type result ::
{:ok, Record.metadata()}
| {:error, Error.t()}
| {:error, :cluster_not_ready | :no_master | :unknown_node}
@spec execute(GenServer.server(), Key.t(), Record.bins_input(), [option()]) :: result()
def execute(tender, %Key{} = key, bins, opts \\ []) when is_list(opts) do
with {:ok, txn} <- TxnSupport.txn_from_opts(opts),
{:ok, operations} <- write_operations(bins),
{:ok, policy} <- UnarySupport.write_policy(tender, opts),
{:ok, input} <- command_input(tender, key, operations, opts, txn, policy),
:ok <- TxnSupport.prepare_txn_write(tender, txn, key, opts) do
result = UnarySupport.run_command(tender, key, policy, command(), input)
case result do
{:error, %Error{} = err} ->
TxnSupport.track_txn_in_doubt(tender, txn, key, err)
result
_ ->
result
end
end
end
defp command do
UnaryCommand.new!(
name: __MODULE__,
dispatch: :write,
build_request: &encode_write/1,
parse_response: &parse_metadata_response/2
)
end
defp command_input(conn, key, operations, opts, txn, %Policy.UnaryWrite{} = policy) do
{:ok,
%{
key: key,
conn: conn,
txn: txn,
opts: opts,
operations: operations,
policy: policy,
filter: policy.filter
}}
end
defp write_operations(bins) when is_map(bins) and map_size(bins) > 0 do
bins
|> Enum.reduce_while({:ok, []}, fn {bin_name, value}, {:ok, acc} ->
case Operation.write(normalize_bin_name(bin_name), value) do
{:ok, operation} -> {:cont, {:ok, [operation | acc]}}
{:error, %Error{}} = err -> {:halt, err}
end
end)
|> case do
{:ok, operations} -> {:ok, Enum.reverse(operations)}
{:error, %Error{}} = err -> err
end
end
defp write_operations(bins) when is_map(bins) do
{:error,
Error.from_result_code(:invalid_argument, message: "PUT requires at least one bin write")}
end
defp write_operations(other) do
{:error,
Error.from_result_code(:invalid_argument,
message: "PUT bins must be a non-empty map, got: #{inspect(other)}"
)}
end
defp normalize_bin_name(bin_name) when is_atom(bin_name), do: Atom.to_string(bin_name)
defp normalize_bin_name(bin_name), do: bin_name
defp encode_write(%{
key: %Key{} = key,
conn: conn,
opts: opts,
operations: operations,
policy: policy,
use_compression: use_compression,
filter: filter
}) do
key
|> AsmMsg.key_command(
operations,
[write: true] ++ UnarySupport.write_header_opts(policy, use_compression)
)
|> AsmMsg.maybe_add_filter_exp(filter)
|> TxnSupport.maybe_add_mrt_fields(conn, key, opts, true)
|> AsmMsg.encode()
|> Message.encode_as_msg_iodata()
end
defp parse_metadata_response(body, %{key: key, conn: conn, txn: txn}) do
UnarySupport.parse_as_msg(body, fn msg ->
case Response.parse_record_metadata_response(msg) do
{:ok, _} = ok ->
TxnSupport.track_txn_response(conn, txn, key, :write, msg, ok)
ok
{:error, _} = err ->
err
end
end)
end
end