Struct SeekHandle 

pub struct SeekHandle;

The key reading the subscription’s PulsarSeeker out of PulsarContext (and out of PulsarBatchContext on the batch path): the reposition handle every delivery of the subscription shares.

One seek covers every topic and every partition of the subscription’s consumer.

Examples

use ruststream_pulsar::SeekHandle;
use ruststream_pulsar::prelude::*;

/// Skips forward past a region the producer marked poisoned.
#[subscriber(PulsarSubscription::new("jobs", "workers"))]
async fn work(job: &Job, Ctx(seeker): Ctx<SeekHandle>) -> HandlerOutcome {
    if let Some(resume_at) = job.poisoned_until
        && seeker.seek(PulsarPosition::timestamp(resume_at)).await.is_err()
    {
        return HandlerOutcome::retry();
    }
    HandlerOutcome::ack()
}

Trait Implementations

impl Clone for SeekHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContextField for SeekHandle

type Context = PulsarContext

The per-delivery context type this key reads from.

type Value = PulsarSeeker

The owned value the key yields.

fn read(self, src: &PulsarContext) -> PulsarSeeker

Reads this key’s field out of src. Named apart from Field::get so a key implementing both traits stays unambiguous to call.

impl Copy for SeekHandle

impl Debug for SeekHandle

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

Formats the value using the given formatter.

impl Default for SeekHandle

fn default() -> Self

Returns the “default value” for a type.

impl Eq for SeekHandle

impl Field<PulsarBatchContext> for SeekHandle

type Value<'a> = &'a PulsarSeeker

The value read through this key, borrowed from the source for 'a.

fn get(self, src: &PulsarBatchContext) -> &PulsarSeeker

Reads this key’s field out of src.

impl Field<PulsarContext> for SeekHandle

type Value<'a> = &'a PulsarSeeker

The value read through this key, borrowed from the source for 'a.

fn get(self, src: &PulsarContext) -> &PulsarSeeker

Reads this key’s field out of src.

impl Hash for SeekHandle

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SeekHandle

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SeekHandle