Current section

Files

Jump to
commanded lib commanded aggregates execution_context.ex
Raw

lib/commanded/aggregates/execution_context.ex

defmodule Commanded.Aggregates.ExecutionContext do
@moduledoc """
Defines the arguments used to execute a command for an aggregate.
The available options are:
- `command` - the command to execute, typically a struct
(e.g. `%OpenBankAccount{...}`).
- `retry_attempts` - the number of retries permitted if an
`{:error, :wrong_expected_version}` is encountered when appending events.
- `causation_id` - the UUID assigned to the dispatched command.
- `correlation_id` - a UUID used to correlate related commands/events.
- `metadata` - a map of key/value pairs containing the metadata to be
associated with all events created by the command.
- `handler` - the module that handles the command. It may be either the
aggregate module itself or a separate command handler module.
- `function` - the name of function, as an atom, that handles the command.
The default value is `:execute`, used to support command dispatch directly
to the aggregate module. For command handlers the `:handle` function is
used.
- `lifespan` - a module implementing the `Commanded.Aggregates.AggregateLifespan`
behaviour to control the aggregate instance process lifespan. The default
value, `Commanded.Aggregates.DefaultLifespan`, keeps the process running
indefinitely.
"""
alias Commanded.Aggregates.DefaultLifespan
defstruct [
:command,
:retry_attempts,
:causation_id,
:correlation_id,
:function,
:handler,
lifespan: DefaultLifespan,
metadata: %{},
]
end