Enum NatsMessage 

pub enum NatsMessage {
    Core(Box<CoreMessage>),
    JetStream(Box<JetStreamMessage>),
}

A NATS delivery. Two flavours: core NATS (no ack) and JetStream (real ack/nack/redelivery).

Both variants are boxed to keep the enum compact; the wrapped async_nats messages are large.

Variants

Core(Box<CoreMessage>)

A core NATS subject delivery. Acknowledgement is not supported.

JetStream(Box<JetStreamMessage>)

A JetStream pull-consumer delivery with full ack support.

Trait Implementations

impl Debug for NatsMessage

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

Formats the value using the given formatter.

impl IncomingMessage for NatsMessage

fn payload(&self) -> &[u8]

Returns the raw payload of the message.

fn headers(&self) -> &Headers

Returns the headers attached to the message.

async fn ack(self) -> Result<(), AckError>

Acknowledges successful processing. Consumes the message handle.

async fn nack(self, requeue: bool) -> Result<(), AckError>

Negatively acknowledges the message. When requeue is true the broker should redeliver according to its own retry policy; when false it should drop or dead-letter the message.

fn extensions(&self) -> Extensions

Contributes per-delivery typed data to the handler’s Context, built fresh for this one delivery.

fn partition_key(&self) -> Option<&[u8]>

Returns the routing key the broker partitioned this message by, or None when the message carries no key.

fn supports_nack_after(&self) -> bool

Reports whether this transport can honor nack_after natively.

fn nack_after( self, delay: Duration, ) -> impl Future<Output = Result<(), AckError>> + Send

where Self: Sized,

Negatively acknowledges the message, asking the broker to redeliver it no sooner than delay from now.

impl Partitioned for NatsMessage

Partitioned lets the workers(N, by_key) runtime feature assign a dispatch lane based on a well-known message header. NATS has no native partition concept, so the key travels as the PARTITION_KEY_HEADER header value and the sender is responsible for setting it.

fn partition_key(&self) -> Option<&[u8]>

Returns the partition key for this item, or None if the broker should pick a partition.