Struct PostgresEventRepository

pub struct PostgresEventRepository { /* private fields */ }

An event repository relying on a Postgres database for persistence.

Implementations

impl PostgresEventRepository

pub fn new(pool: Pool<Postgres>) -> Self

Creates a new PostgresEventRepository from the provided database connection. This uses the default tables ‘events’ and ‘snapshots’.

use sqlx::{Pool, Postgres};
use postgres_es::PostgresEventRepository;

fn configure_repo(pool: Pool<Postgres>) -> PostgresEventRepository {
    PostgresEventRepository::new(pool)
}

pub fn with_streaming_channel_size(self, stream_channel_size: usize) -> Self

Configures a PostgresEventRepository to use a streaming queue of the provided size.

Example: configure the repository to stream with a 1000 event buffer.

use sqlx::{Pool, Postgres};
use postgres_es::PostgresEventRepository;

fn configure_repo(pool: Pool<Postgres>) -> PostgresEventRepository {
    let store = PostgresEventRepository::new(pool);
    store.with_streaming_channel_size(1000)
}

pub fn with_tables(self, events_table: &str, snapshots_table: &str) -> Self

Configures a PostgresEventRepository to use the provided table names.

Example: configure the repository to use “my_event_table” and “my_snapshot_table” for the event and snapshot table names.

use sqlx::{Pool, Postgres};
use postgres_es::PostgresEventRepository;

fn configure_repo(pool: Pool<Postgres>) -> PostgresEventRepository {
    let store = PostgresEventRepository::new(pool);
    store.with_tables("my_event_table", "my_snapshot_table")
}

Trait Implementations

impl PersistedEventRepository for PostgresEventRepository

fn get_events<'life0, 'life1, 'async_trait, A>( &'life0 self, aggregate_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<SerializedEvent>, PersistenceError>> + Send + 'async_trait>>

where A: 'async_trait + Aggregate, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns all events for a single aggregate instance.

fn get_last_events<'life0, 'life1, 'async_trait, A>( &'life0 self, aggregate_id: &'life1 str, last_sequence: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<SerializedEvent>, PersistenceError>> + Send + 'async_trait>>

where A: 'async_trait + Aggregate, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the last events for a single aggregate instance.

fn get_snapshot<'life0, 'life1, 'async_trait, A>( &'life0 self, aggregate_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<SerializedSnapshot>, PersistenceError>> + Send + 'async_trait>>

where A: 'async_trait + Aggregate, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the current snapshot for an aggregate instance.

fn persist<'life0, 'life1, 'async_trait, A>( &'life0 self, events: &'life1 [SerializedEvent], snapshot_update: Option<(String, Value, usize)>, ) -> Pin<Box<dyn Future<Output = Result<(), PersistenceError>> + Send + 'async_trait>>

where A: 'async_trait + Aggregate, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Commits the updated aggregate and accompanying events.

fn stream_events<'life0, 'life1, 'async_trait, A>( &'life0 self, aggregate_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ReplayStream, PersistenceError>> + Send + 'async_trait>>

where A: 'async_trait + Aggregate, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Streams all events for an aggregate instance.

fn stream_all_events<'life0, 'async_trait, A>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ReplayStream, PersistenceError>> + Send + 'async_trait>>

where A: 'async_trait + Aggregate, Self: 'async_trait, 'life0: 'async_trait,

Streams all events for an aggregate type.