Struct SeekHandle 

pub struct SeekHandle;

The key reading the subscription’s KinesisSeeker out of either context.

The handle is the subscription’s own, minted when it opened, so a stream-wide position moves every shard it owns and a captured one moves the shard it names.

Examples

use ruststream::prelude::*;
use ruststream::{Seeker, subscriber};
use ruststream_kinesis::{KinesisPosition, KinesisStream, SeekHandle};

/// Rewinds the whole subscription when the producer asks for a replay.
#[subscriber(KinesisStream::new("jobs"))]
async fn work(job: &Job, Ctx(seeker): Ctx<SeekHandle>) -> HandlerOutcome {
    if job.replay_from_horizon && seeker.seek(KinesisPosition::horizon()).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 = KinesisContext

The per-delivery context type this key reads from.

type Value = KinesisSeeker

The owned value the key yields.

fn read(self, src: &KinesisContext) -> KinesisSeeker

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<KinesisBatchContext> for SeekHandle

type Value<'a> = &'a KinesisSeeker

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

fn get(self, src: &KinesisBatchContext) -> &KinesisSeeker

Reads this key’s field out of src.

impl Field<KinesisContext> for SeekHandle

type Value<'a> = &'a KinesisSeeker

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

fn get(self, src: &KinesisContext) -> &KinesisSeeker

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