Skip to main content

EventsBySlicesSourceProvider

Struct EventsBySlicesSourceProvider 

Source
pub struct EventsBySlicesSourceProvider { /* private fields */ }
Expand description

PostgreSQL timestamp-cursor provider over EventsBySlicesQuery.

The provider manifest durably includes the caller-supplied query identity, entity type, inclusive slice range, and range version. A cursor written for any different range or version therefore fails with ProjectionError::ProviderManifestMismatch instead of being silently reused. query_identity should be a stable, non-secret identifier for the PostgreSQL journal/database (for example, a deployment database id plus schema), so cursors are not accidentally moved across databases.

PostgreSQL resumes timestamp offsets inclusively. The provider stores every consumed (persistence_id, sequence_nr) at the exact boundary in DeduplicationBoundary. PostgreSQL’s projection offset store normalizes those identities into PJ4’s timestamp-boundary table; no second dedup row shape is introduced here.

Delivery guarantees cover only emitted rows. A live PostgreSQL slice query can permanently skip an event committed by a transaction open longer than the configured visibility lag.

Implementations§

Source§

impl EventsBySlicesSourceProvider

Source

pub fn new( query: Arc<dyn EventsBySlicesQuery>, query_identity: impl Into<String>, entity_type: impl Into<String>, range: SliceRange, version: u32, ) -> ProjectionResult<Self>

Creates an inert, restartable provider for one versioned slice range.

Source

pub fn query_identity(&self) -> &str

Returns the stable query/database identity included in the manifest.

Source

pub fn entity_type(&self) -> &str

Returns the queried persistence entity type.

Source

pub const fn range(&self) -> SliceRange

Returns the inclusive slice range owned by this provider.

Source

pub const fn version(&self) -> u32

Returns the explicit range version.

Source

pub fn projection_key(&self) -> &str

Returns the range-derived projection key, such as slices-256-511@v1.

Trait Implementations§

Source§

impl Clone for EventsBySlicesSourceProvider

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl SourceProvider<EventEnvelope> for EventsBySlicesSourceProvider

Source§

fn manifest(&self) -> &ProviderManifest

Returns the stable durable identity of this provider and cursor format.
Source§

fn validate_projection_id( &self, projection_id: &ProjectionId, ) -> ProjectionResult<()>

Validates that this provider may run under projection_id. Read more
Source§

fn source_from<'life0, 'life1, 'async_trait>( &'life0 self, cursor: Option<&'life1 ProjectionCursor>, mode: QueryMode, ) -> Pin<Box<dyn Future<Output = ProjectionResult<ProjectionSource<EventEnvelope>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Materializes a fresh source beginning at cursor. Read more
Source§

fn extract_cursor( &self, envelope: &EventEnvelope, ) -> ProjectionResult<ProjectionCursor>

Extracts the complete durable cursor after processing envelope. Read more
Source§

fn compare_positions( &self, left: &CursorPosition, right: &CursorPosition, ) -> ProjectionResult<Ordering>

Compares two opaque provider positions in source order. Read more
Source§

fn resume_allows( &self, cursor: &ProjectionCursor, envelope: &Envelope, ) -> ProjectionResult<bool>

Decides whether envelope is after the already-consumed resume cursor. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<S> IntoEventHandlerResult<S> for S

Source§

fn into_event_handler_result(self) -> Result<S, PersistenceError>

Converts this handler output into the runtime result.
Source§

impl<T> Message for T
where T: Any + Send + 'static,

Source§

fn from_boxed(m: BoxedMessage) -> Result<Self, BoxedDowncastErr>

Convert a BoxedMessage to this concrete type
Source§

fn box_message(self, pid: &ActorId) -> Result<BoxedMessage, BoxedDowncastErr>

Convert this message to a BoxedMessage
Source§

impl<T> OutputMessage for T
where T: Message + Clone,

Source§

impl<T> State for T
where T: Any + Send + 'static,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more