Struct ConfigSnapshot 

pub struct ConfigSnapshot { /* private fields */ }

A configuration pinned for one request transaction. Obtain via crate::Control::snapshot; run on_request then (later) on_response against the same snapshot so a reload cannot desync the two halves.

The snapshot also carries the request’s RequestTrace (ADR 000009): both halves run under one trace context, so the request-side and response-side filter spans belong to the same trace. The host emits those spans to its sink as the chain runs.

Clone is cheap (an Arc clone + the trace ids) and yields the same pinned config and trace — the fast-path server clones one snapshot to run the request and response halves on separate spawn_blocking tasks while keeping them in one transaction (ADR 000013).

Implementations

impl ConfigSnapshot

pub fn on_request(&self, request: HttpRequest) -> ChainOutcome

Drive a request through the default [chain] (the chain-only convenience). The fast-path server uses ConfigSnapshot::find_route + ConfigSnapshot::dispatch_request.

pub fn on_response( &self, request: &HttpRequest, response: HttpResponse, ) -> ResponseOutcome

Drive a response back through the default [chain] in reverse. request is the as-forwarded request snapshot every response hook sees (ADR 000073).

pub fn find_route(&self, request: &HttpRequest) -> Option<RouteInfo>

Match a request to a route by its [route.match] dimensions — host, path prefix, method, headers, query (ADR 000013 / 000034) — or None when no route matches (the server responds 404). The most specific match wins (see [route::select]). Pure config lookup — cheap and non-blocking, so it runs on the async thread; only the returned route’s chain dispatch is blocking work. Reads only borrowed request fields, so matching is allocation-free.

pub fn dispatch_request( &self, route: usize, request: HttpRequest, ) -> ChainOutcome

Drive a request through a matched route’s chain (request side). route is the index from ConfigSnapshot::find_route on this same snapshot. Returns forward-or-respond just like on_request. Out-of-range (a stale index from another snapshot) responds with a fail-closed 404 rather than panicking (data-plane no-panic, bp-rust).

pub fn dispatch_request_body( &self, route: usize, body: Vec<u8>, ) -> RequestBodyOutcome

Drive a buffered request body through a matched route’s on-request-body chain (ADR 000025). Same route index as the request side, on the same snapshot. The server calls this only for a route with filters and a non-empty body; a stale index forwards the body unchanged.

pub fn dispatch_response( &self, route: usize, request: &HttpRequest, response: HttpResponse, ) -> ResponseOutcome

Drive a response back through a matched route’s chain in reverse. Same route index as the request side, on the same (cloned) snapshot, so both halves run one route’s chain. request is the as-forwarded request snapshot (ADR 000073). A stale index forwards the response unchanged (fail-soft, same as the other dispatch_*).

pub fn config_version(&self) -> &str

The config version (manifest content hash) this transaction is pinned to.

pub fn traceparent(&self) -> String

The W3C traceparent for this transaction — pass downstream so the upstream request continues the same trace (ADR 000009 propagation).

Trait Implementations

impl Clone for ConfigSnapshot

fn clone(&self) -> ConfigSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.