Packages
eventstore
0.13.1
1.4.8
1.4.7
1.4.6
1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
1.3.2
1.3.1
1.3.0
1.2.3
1.2.2
1.2.1
1.2.0
1.1.0
1.0.3
1.0.2
1.0.1
1.0.0
1.0.0-rc.0
0.17.0
0.16.2
0.16.1
0.16.0
0.15.1
0.15.0
0.14.0
0.14.0-rc.0
0.13.2
0.13.1
0.13.0
0.12.1
0.12.0
0.11.0
0.11.0-rc.0
0.10.1
0.10.0
0.9.0
0.8.1
0.8.0
0.7.4
0.7.3
0.7.2
0.7.1
0.7.0
0.6.2
0.6.1
0.6.0
0.5.2
0.5.1
0.5.0
0.4.3
0.4.2
0.4.1
0.4.0
0.3.0
0.2.1
0.2.0
0.1.0
0.0.5
0.0.4
0.0.3
0.0.2
0.0.1
Event store using PostgreSQL for persistence.
Current section
Files
Jump to
Current section
Files
lib/event_store/streams/stream.ex
defmodule EventStore.Streams.Stream do
@moduledoc """
An event stream
"""
use GenServer
use EventStore.Registration
alias EventStore.{EventData,RecordedEvent,Storage,Subscriptions,Writer}
alias EventStore.Streams.Stream
defstruct [
serializer: nil,
stream_uuid: nil,
stream_id: nil,
stream_version: 0,
]
def start_link(serializer, stream_uuid, opts \\ []) do
stream = %Stream{
serializer: serializer,
stream_uuid: stream_uuid,
}
GenServer.start_link(__MODULE__, stream, opts)
end
def name(stream_uuid), do: {Stream, stream_uuid}
@doc """
Append a list of events to the stream, expected version is used for optimistic concurrency.
Each logical stream is a separate process; writes to a single stream will always be serialized.
Returns `:ok` on success.
"""
def append_to_stream(stream_uuid, expected_version, events, timeout \\ 5_000)
def append_to_stream(stream_uuid, expected_version, events, timeout) do
GenServer.call(via_name(stream_uuid), {:append_to_stream, expected_version, events}, timeout)
end
def read_stream_forward(stream_uuid, start_version, count) do
GenServer.call(via_name(stream_uuid), {:read_stream_forward, start_version, count})
end
def stream_forward(stream_uuid, start_version, read_batch_size) do
GenServer.call(via_name(stream_uuid), {:stream_forward, start_version, read_batch_size})
end
def subscribe_to_stream(stream_uuid, subscription_name, subscriber, opts) do
GenServer.call(via_name(stream_uuid), {:subscribe_to_stream, subscription_name, subscriber, opts})
end
def stream_version(stream_uuid) do
GenServer.call(via_name(stream_uuid), {:stream_version})
end
def close(stream_uuid) do
GenServer.stop(via_name(stream_uuid), :shutdown)
end
def init(%Stream{stream_uuid: stream_uuid} = state) do
GenServer.cast(self(), {:open_stream, stream_uuid})
{:ok, state}
end
def handle_cast({:open_stream, stream_uuid}, %Stream{} = state) do
{:ok, stream_id, stream_version} = Storage.stream_info(stream_uuid)
state = %Stream{state |
stream_id: stream_id,
stream_version: stream_version,
}
{:noreply, state}
end
def handle_call({:append_to_stream, expected_version, events}, _from, %Stream{stream_version: stream_version} = state) do
{reply, state} =
case append_to_storage(expected_version, events, state) do
{:ok, state} ->
{:ok, %Stream{state | stream_version: stream_version + length(events)}}
{:error, _reason} = reply ->
{reply, state}
end
{:reply, reply, state}
end
def handle_call({:read_stream_forward, start_version, count}, _from, %Stream{stream_id: stream_id, serializer: serializer} = state) do
reply = read_storage_forward(stream_id, start_version, count, serializer)
{:reply, reply, state}
end
def handle_call({:stream_forward, start_version, read_batch_size}, _from, %Stream{stream_id: stream_id, serializer: serializer} = state) do
reply = stream_storage_forward(stream_id, start_version, read_batch_size, serializer)
{:reply, reply, state}
end
def handle_call({:subscribe_to_stream, subscription_name, subscriber, opts}, _from, %Stream{stream_uuid: stream_uuid} = state) do
{start_from, opts} = Keyword.pop(opts, :start_from, :origin)
opts = Keyword.merge([start_from_stream_version: start_from_stream_version(start_from, state)], opts)
reply = Subscriptions.subscribe_to_stream(stream_uuid, subscription_name, subscriber, opts)
{:reply, reply, state}
end
def handle_call({:stream_version}, _from, %Stream{stream_version: stream_version} = state) do
{:reply, {:ok, stream_version}, state}
end
def handle_info(:timeout, %Stream{} = state) do
{:stop, :normal, state}
end
defp start_from_stream_version(:origin, %Stream{}), do: 0
defp start_from_stream_version(:current, %Stream{stream_version: stream_version}), do: stream_version
defp start_from_stream_version(start_from, %Stream{}) when is_integer(start_from), do: start_from
defp append_to_storage(expected_version, events, %Stream{stream_uuid: stream_uuid, stream_id: stream_id, stream_version: stream_version} = state)
when is_nil(stream_id) and stream_version == 0 and expected_version in [0, :any_version, :no_stream]
do
with {:ok, stream_id} <- Storage.create_stream(stream_uuid) do
do_append_to_storage(events, %Stream{state | stream_id: stream_id})
end
end
defp append_to_storage(expected_version, events, %Stream{stream_id: stream_id, stream_version: stream_version} = stream)
when not is_nil(stream_id) and expected_version in [stream_version, :any_version, :stream_exists]
do
do_append_to_storage(events, stream)
end
defp append_to_storage(expected_version, events, %Stream{stream_id: stream_id, stream_version: stream_version} = stream)
when not is_nil(stream_id) and stream_version == 0 and expected_version == :no_stream
do
do_append_to_storage(events, stream)
end
defp append_to_storage(expected_version, _events, %Stream{stream_id: stream_id, stream_version: stream_version})
when is_nil(stream_id) and stream_version == 0 and expected_version == :stream_exists
do
{:error, :stream_does_not_exist}
end
defp append_to_storage(expected_version, _events, %Stream{stream_id: stream_id, stream_version: stream_version})
when not is_nil(stream_id) and stream_version != 0 and expected_version == :no_stream
do
{:error, :stream_exists}
end
defp append_to_storage(_expected_version, _events, _state), do: {:error, :wrong_expected_version}
defp do_append_to_storage(events, %Stream{} = stream) do
reply =
events
|> prepare_events(stream)
|> write_to_stream(stream)
{reply, stream}
end
defp prepare_events(events, %Stream{serializer: serializer, stream_uuid: stream_uuid, stream_version: stream_version}) do
events
|> Enum.map(&map_to_recorded_event(&1, utc_now(), serializer))
|> Enum.with_index(1)
|> Enum.map(fn {recorded_event, index} ->
%RecordedEvent{recorded_event |
stream_uuid: stream_uuid,
stream_version: stream_version + index,
}
end)
end
defp map_to_recorded_event(%EventData{
correlation_id: correlation_id,
causation_id: causation_id,
event_type: event_type,
data: data,
metadata: metadata
}, created_at, serializer)
do
%RecordedEvent{
event_id: UUID.uuid4(),
correlation_id: correlation_id,
causation_id: causation_id,
event_type: event_type,
data: serializer.serialize(data),
metadata: serializer.serialize(metadata),
created_at: created_at,
}
end
# Returns the current naive date time in UTC.
defp utc_now,
do: DateTime.utc_now() |> DateTime.to_naive()
defp write_to_stream(prepared_events, %Stream{stream_id: stream_id, stream_uuid: stream_uuid}) do
Writer.append_to_stream(prepared_events, stream_id, stream_uuid)
end
defp read_storage_forward(stream_id, start_version, count, serializer)
when not is_nil(stream_id)
do
case Storage.read_stream_forward(stream_id, start_version, count) do
{:ok, recorded_events} -> {:ok, deserialize_recorded_events(recorded_events, serializer)}
{:error, _reason} = reply -> reply
end
end
defp read_storage_forward(_stream_id, _start_version, _count, _serializer),
do: {:error, :stream_not_found}
defp stream_storage_forward(stream_id, 0, read_batch_size, serializer),
do: stream_storage_forward(stream_id, 1, read_batch_size, serializer)
defp stream_storage_forward(stream_id, start_version, read_batch_size, serializer) when not is_nil(stream_id) do
Elixir.Stream.resource(
fn -> start_version end,
fn next_version ->
case read_storage_forward(stream_id, next_version, read_batch_size, serializer) do
{:ok, []} -> {:halt, next_version}
{:ok, events} -> {events, next_version + length(events)}
end
end,
fn _ -> :ok end
)
end
defp stream_storage_forward(_stream_id, _start_version, _read_batch_size, _serializer),
do: {:error, :stream_not_found}
defp deserialize_recorded_events(recorded_events, serializer),
do: Enum.map(recorded_events, &RecordedEvent.deserialize(&1, serializer))
defp via_name(stream_uuid),
do: stream_uuid |> name() |> via_tuple()
end