Struct JetStreamContext 

pub struct JetStreamContext { /* private fields */ }

Native JetStream per-delivery metadata, built once per delivery from the broker message.

Read its fields by the compile-time keys (for example keys::STREAM_SEQUENCE). On a core (non-JetStream) delivery there is no such metadata, so the context is empty and every key reads None; the same handler therefore works on both kinds of subscription.

The context owns its fields (it copies them out of the delivery), so it does not borrow the message: numbers are a stack copy and the stream/consumer names are cloned once per delivery.

Examples

use ruststream::runtime::Context;
use ruststream_nats::context::{JetStreamContext, keys};

// The context a handler reads through; the runtime supplies it per delivery.
fn read(ctx: &Context<'_, JetStreamContext>) -> Option<u64> {
    ctx.context(keys::STREAM_SEQUENCE)
}

Trait Implementations

impl BuildContext<NatsMessage> for JetStreamContext

fn build(msg: &NatsMessage) -> Self

Builds the context value by reading fields out of msg.

impl Clone for JetStreamContext

fn clone(&self) -> JetStreamContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JetStreamContext

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

Formats the value using the given formatter.

impl Default for JetStreamContext

fn default() -> JetStreamContext

Returns the “default value” for a type.

impl Eq for JetStreamContext

impl Field<JetStreamContext> for StreamSequence

type Value<'a> = Option<u64>

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

fn get(self, cx: &JetStreamContext) -> Option<u64>

Reads this key’s field out of src.

impl Field<JetStreamContext> for ConsumerSequence

type Value<'a> = Option<u64>

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

fn get(self, cx: &JetStreamContext) -> Option<u64>

Reads this key’s field out of src.

impl Field<JetStreamContext> for Delivered

type Value<'a> = Option<i64>

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

fn get(self, cx: &JetStreamContext) -> Option<i64>

Reads this key’s field out of src.

impl Field<JetStreamContext> for Pending

type Value<'a> = Option<u64>

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

fn get(self, cx: &JetStreamContext) -> Option<u64>

Reads this key’s field out of src.

impl Field<JetStreamContext> for Stream

type Value<'a> = Option<&'a str>

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

fn get(self, cx: &JetStreamContext) -> Option<&str>

Reads this key’s field out of src.

impl Field<JetStreamContext> for Consumer

type Value<'a> = Option<&'a str>

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

fn get(self, cx: &JetStreamContext) -> Option<&str>

Reads this key’s field out of src.

impl PartialEq for JetStreamContext

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for JetStreamContext