Struct SqliteEventRepository

pub struct SqliteEventRepository { /* private fields */ }

An event repository relying on a SQLite database for persistence.

Implementations

impl SqliteEventRepository

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

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

use sqlx::{Pool, Sqlite};
use sqlite_es::SqliteEventRepository;

fn configure_repo(pool: Pool<Sqlite>) -> SqliteEventRepository {
    SqliteEventRepository::new(pool)
}

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

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

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

use sqlx::{Pool, Sqlite};
use sqlite_es::SqliteEventRepository;

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

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

Configures a SqliteEventRepository 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, Sqlite};
use sqlite_es::SqliteEventRepository;

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

Trait Implementations

impl PersistedEventRepository for SqliteEventRepository

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.