Struct HandlerContext 

pub struct HandlerContext {
    pub message_id: MessageId,
    pub correlation_id: CorrelationId,
    pub cancellation: CancellationToken,
    pub span: Span,
}

Contextual information injected into every handler invocation.

The context carries the identifiers of the in-flight message, a CancellationToken for cooperative cancellation, and the active tracing::Span for distributed tracing propagation.

Fields

message_id: MessageId

Unique identifier of this specific message instance.

correlation_id: CorrelationId

Identifier linking all messages in the same causal chain.

cancellation: CancellationToken

Token that is cancelled when the dispatch is aborted or timed out.

span: Span

Active tracing span at the time of dispatch.

Implementations

impl HandlerContext

pub fn new(message_id: MessageId, correlation_id: CorrelationId) -> Self

Creates a new context for the given message identifiers.

The CancellationToken is fresh (not yet cancelled) and the span is captured from the current tracing context.

pub fn with_span(self, span: Span) -> Self

Overrides the tracing span. Useful when the caller manages span lifecycle explicitly.

pub fn with_cancellation(self, token: CancellationToken) -> Self

Overrides the cancellation token. Use this to share a parent token with the dispatch so that cancelling the parent propagates here.

pub fn is_cancelled(&self) -> bool

Returns true if the cancellation token has been cancelled.

Trait Implementations

impl Clone for HandlerContext

fn clone(&self) -> HandlerContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandlerContext

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

Formats the value using the given formatter.