Struct MysqlEventRepository

pub struct MysqlEventRepository { /* private fields */ }

An event repository relying on a MySql database for persistence.

Implementations

impl MysqlEventRepository

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

Creates a new MysqlEventRepository from the provided database connection used for backing a MysqlSnapshotStore. This uses the default tables ‘events’ and ‘snapshots’.

use sqlx::{MySql, Pool};
use mysql_es::MysqlEventRepository;

fn configure_repo(pool: Pool<MySql>) -> MysqlEventRepository {
    MysqlEventRepository::new(pool)
}

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

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

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

use sqlx::{MySql, Pool};
use mysql_es::MysqlEventRepository;

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

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

Configures a MysqlEventRepository 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::{MySql, Pool};
use mysql_es::MysqlEventRepository;

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

Trait Implementations

impl PersistedEventRepository for MysqlEventRepository

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.