Skip to main content

NotificationRegistryTransaction

Struct NotificationRegistryTransaction 

Source
pub struct NotificationRegistryTransaction { /* private fields */ }

Implementations§

Source§

impl NotificationRegistryTransaction

Source

pub fn listener_metadata_after( &self, after: Option<NotificationListenerKey>, ) -> StorageBackendResult<Option<NotificationListenerMetadata>>

Read one fixed-width row after the exclusive key in primary-key order. The statement finishes before return, so deleting that row and resuming cannot invalidate an active scan. Channel JSON is not selected or decoded. The original transaction’s cancellation still applies.

Source

pub fn listener( &self, key: NotificationListenerKey, max_channels: Option<usize>, ) -> StorageBackendResult<Option<NotificationListenerRow>>

Load only the named listener. A supplied channel limit bounds encoded JSON before copying and decoded element count before constructing excess elements. None preserves explicit legacy session materialization.

Source§

impl NotificationRegistryTransaction

Source

pub fn prepare_publication( &mut self, process_id: i32, pending: &[PendingNotification], listener: Option<&NotificationListenerRow>, control: &StorageReadControl, ) -> StorageBackendResult<NotificationPublication>

Prepare the original evaluated batch and final subscription under registry admission. The caller stages the returned immutable record in its main transaction before committing either resource.

Source

pub fn apply_publication( &mut self, publication: NotificationPublicationView<'_>, control: &StorageReadControl, ) -> StorageBackendResult<()>

Append exactly the authoritative committed intent, or recognize its already committed acknowledgement. A savepoint prevents failed decoding, cancellation or memory admission from leaving half a publication in this registry transaction.

Source§

impl NotificationRegistryTransaction

Source

pub fn suspend_publication( &mut self, publication: &NotificationPublication, owner: [u8; 16], ) -> StorageBackendResult<()>

Roll back the private queue append and persist only its reservation. The sender keeps the matching publication and liveness lease until its authoritative main outcome is resolved.

Source

pub fn resume_publication( &mut self, publication: &NotificationPublication, owner: [u8; 16], control: &StorageReadControl, ) -> StorageBackendResult<bool>

Return true when an independent recovery already applied this original main commit. Later publications may have advanced the single acknowledgement since then.

Source§

impl NotificationRegistryTransaction

Source

pub fn visit_entries_from( &self, from_sequence: u64, max_entries: NonZeroUsize, control: &StorageReadControl, visit: &mut dyn FnMut(NotificationQueueEntryRef<'_>) -> StorageBackendResult<ControlFlow<()>>, ) -> StorageBackendResult<NotificationQueueScan>

Visit at most max_entries ordered rows without materializing their strings or a result vector. The consumer must admit any copies under its own queue limits before retaining them. Existing SQLite connection/cache memory remains owned by the registry.

Continue accepts the current row and advances the returned resume boundary; Break declines it and stops without advancing past it. visited includes a declined row. This method never changes a listener cursor or commits a transaction. Consumer errors and cancellation stop the scan; an error grants no cursor advancement.

Source§

impl NotificationRegistryTransaction

Source

pub const fn pending_acknowledgement(&self) -> Option<[u8; 32]>

Source

pub fn allocate_backend_process_id(&self) -> Result<i32, StorageBackendError>

Source

pub fn queue_state(&self) -> Result<NotificationQueueState, StorageBackendError>

Source

pub fn save_queue_state( &self, state: NotificationQueueState, ) -> Result<(), StorageBackendError>

Source

pub fn append_entries( &self, entries: &[NotificationQueueEntry], ) -> Result<(), StorageBackendError>

Source

pub fn entries_from( &self, from_sequence: u64, ) -> Result<Vec<NotificationQueueEntry>, StorageBackendError>

Source

pub fn delete_entries_before( &self, sequence: u64, ) -> Result<(), StorageBackendError>

Source

pub fn listeners( &self, ) -> Result<Vec<NotificationListenerRow>, StorageBackendError>

Source

pub fn save_listener( &self, listener: &NotificationListenerRow, ) -> Result<(), StorageBackendError>

Source

pub fn drop_listener( &self, owner_id: [u8; 16], session_id: u64, ) -> Result<(), StorageBackendError>

Source

pub fn commit(self) -> Result<(), StorageBackendError>

Complete an already authoritative publication even if its original query was cancelled.

Source

pub fn commit_with_control( self, control: &StorageReadControl, ) -> StorageBackendResult<()>

Commit a cancellable registration or consumption attempt. An interrupted native wait drops and rolls back the uncommitted attempt.

Trait Implementations§

Source§

impl Drop for NotificationRegistryTransaction

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. 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> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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<T> Same for T

Source§

type Output = T

Should always be Self
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.