Struct DeadLetter 

pub struct DeadLetter;

The service’s own DeadLetter: set by InboxSpec::own.

Examples

use ruststream_sqlx::dialect::Column;
use ruststream_sqlx::spec::{Payload, own};
use ruststream_sqlx::{DeadLetter, InboxSpec, InboxTable};
use sqlx::{PgConnection, Postgres};

#[derive(sqlx::FromRow)]
pub struct Charge {
    id: i64,
    payload: Vec<u8>,
}

impl InboxTable for Charge {
    type Id = i64;
    type Table = InboxSpec<(Payload, own::DeadLetter)>;
    const TABLE: Self::Table = InboxSpec::new("charges", Column::new("id").generated())
        .payload(Column::new("payload"))
        .own::<own::DeadLetter>();

    fn id(&self) -> &i64 {
        &self.id
    }
}

// Every queue of the service parks its spent rows in one `dead_letters` table.
impl DeadLetter<Postgres> for Charge {
    async fn dead_letter(
        conn: &mut PgConnection,
        id: &i64,
        destination: &str,
    ) -> Result<(), sqlx::Error> {
        sqlx::query(
            "WITH dead AS (DELETE FROM charges WHERE id = $1 RETURNING payload) \
             INSERT INTO dead_letters (source, destination, payload) \
             SELECT 'charges', $2, payload FROM dead",
        )
        .bind(id)
        .bind(destination)
        .execute(conn)
        .await?;
        Ok(())
    }
}

Trait Implementations

impl Debug for DeadLetter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Declaration for DeadLetter

type Form = Unset

The form: Lease or Advisory; unset for the row lock form.

type Message = Unset

The message mode: Payload; unset for row mode.

type Key = Unset

The partition key: Key.

type Attempt = Unset

The attempt count: Attempt.

type Headers = Unset

The delivery’s headers: Headers or HeaderFields.

type RetryAfter = Unset

The time a retried row is due: RetryAfter.

type ProcessedAt = Unset

The time a row was processed: ProcessedAt.

type Clock = Unset

The clock: Clock; unset for SystemClock.

type Opening = Unset

What the table’s transactions open at: Opens; unset for the database’s default.

type Fifo = Unset

Groups kept in order: Fifo.

type OwnClaim = Unset

The service’s own claim: own::Claim.

type OwnFetch = Unset

The service’s own fetch: own::Fetch.

type OwnAck = Unset

The service’s own ack: own::Ack.

type OwnRetry = Unset

The service’s own retry: own::Retry.

type OwnRetryAfter = Unset

The service’s own delayed retry: own::RetryAfter.

type OwnDiscard = Unset

The service’s own discard: own::Discard.

type OwnDeadLetter = Set<DeadLetter>

The service’s own dead letter: own::DeadLetter.

type OwnExtend = Unset

The service’s own lease extension: own::Extend.

type OwnLock = Unset

The service’s own lock: own::Lock.

type OwnUnlock = Unset

The service’s own unlock: own::Unlock.

impl OwnEvent for DeadLetter