Struct Claim 

pub struct Claim;

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

Examples

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

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

impl InboxTable for Callout {
    type Id = i64;
    type Table = InboxSpec<(Payload, own::Claim)>;
    const TABLE: Self::Table = InboxSpec::new("callouts", Column::new("id").generated())
        .group(Column::new("name"))
        .payload(Column::new("payload"))
        .own::<own::Claim>();

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

// The callouts of paying customers are claimed before the others.
impl Claim<Postgres> for Callout {
    async fn claim(
        conn: &mut PgConnection,
        queue: &str,
        limit: i64,
    ) -> Result<Vec<i64>, sqlx::Error> {
        sqlx::query_scalar(
            "SELECT c.id FROM callouts c JOIN customers u ON u.id = c.customer \
             WHERE c.name = $1 ORDER BY u.paying DESC, c.id LIMIT $2 FOR UPDATE OF c SKIP LOCKED",
        )
        .bind(queue)
        .bind(limit)
        .fetch_all(conn)
        .await
    }
}

Trait Implementations

impl Debug for Claim

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

Formats the value using the given formatter.

impl Declaration for Claim

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 = Set<Claim>

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 = Unset

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 Claim