Struct RequestContext 

pub struct RequestContext { /* private fields */ }

The one and only context passed to every handler.

Carries a full W3C distributed-tracing context:

• trace_id (16 bytes) – preserved across the entire distributed call chain.
• span_id (8 bytes) – this server hop’s span; becomes parent-id downstream.
• parent_span_id – the upstream caller’s span (all-zeros = root span).

Use traceparent to generate the header for outgoing calls.

Implementations

impl RequestContext

pub fn method(&self) -> &Method

pub fn path(&self) -> &str

pub fn query_string(&self) -> Option<&str>

pub fn body(&self) -> &Bytes

pub fn trace_id(&self) -> [u8; 16]

pub fn span_id(&self) -> [u8; 8]

This server hop’s span ID (64-bit, unique per request).

pub fn parent_span_id(&self) -> Option<[u8; 8]>

The incoming caller’s span ID, or None for root (origin) spans.

pub fn claims(&self) -> Option<&Claims>

pub fn session(&self) -> Option<&Arc<Session>>

The server-side session loaded for this request, if any.

Some only when SessionManager is provided in the DI container and the session-ID cookie was present, valid, and found in the store.

pub fn tenant(&self) -> Option<&TenantConfig>

The tenant resolved for this request, if any.

Some only when a TenantRegistry is provided in the DI container and the configured strategy (header / subdomain) matched a known tenant (or a fallback tenant is configured). Enforce presence + JWT-claim consistency with web::tenant::TENANT.check(&ctx)?.

pub fn header(&self, key: &str) -> Option<&str>

pub fn param(&self, name: &str) -> Option<&str>

pub fn inject<T: Send + Sync + 'static>(&self) -> &'static T

Resolve a singleton service. O(1), no locks, no allocation. Panics if T was not provided into the DI container.

pub fn try_inject<T: Send + Sync + 'static>(&self) -> Option<&'static T>

Non-panicking variant of Self::inject. Returns None when T is not in the DI container. Used by optional guards and middleware.

pub fn route(&self) -> &'static str

Matched route pattern (e.g. /users/:id). Use this — not path() — as a metrics/trace label to prevent high-cardinality from path parameters.

pub fn route_spec(&self) -> Option<&'static RouteSpec>

Static route metadata for the matched route, if any.

pub fn traceparent(&self) -> String

Generate the W3C traceparent header value suitable for forwarding to downstream HTTP services. Uses this hop’s span_id as the parent-id field so the downstream span correctly chains to this one.

Format: 00-{trace_id_hex}-{span_id_hex}-01

pub fn trace_id_hex(&self) -> String

The trace ID as a lowercase hex string — for log/audit correlation. Replaces app-level calls to lean_telemetry::hex_encode(&ctx.trace_id()).

pub fn extensions(&self) -> &Extensions

Per-request typed storage (request-scoped “DI”). Values live for this request only; the frozen process-wide container is untouched.

pub fn extensions_mut(&mut self) -> &mut Extensions

Mutable access to per-request typed storage. Typical flow: an interceptor inserts a value, the handler reads it via extensions.

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.