Struct RouteInfo 

pub struct RouteInfo {
    pub index: usize,
    pub strip_prefix: Option<Arc<str>>,
    pub has_filters: bool,
    pub reads_body: bool,
    pub upgrade: Option<Arc<UpgradeConfig>>,
    pub compression: Option<Arc<CompressionConfig>>,
    /* private fields */
}

What crate::ConfigSnapshot::find_route hands the fast-path server: which route matched (index, used to dispatch its chain) plus the data needed to forward — the weighted backends (the server picks a group, then a healthy instance from it) and the optional prefix strip. Owned / Arc-shared so it survives a move into spawn_blocking.

Fields

index: usize

strip_prefix: Option<Arc<str>>

Arc<str> so building this per-request RouteInfo from the compiled route (find_route, called on every request) is an atomic refcount bump, not a heap allocation.

has_filters: bool

Whether this route has any filters (drives the header-side chain dispatch).

reads_body: bool

Whether any filter on this route reads the request body (exports on-request-body, ADR 000038). The fast path buffers the body ONLY when this is true; a route of header-only filters keeps the zero-copy streaming path (the real fix for the body-tax, docs/servey).

upgrade: Option<Arc<UpgradeConfig>>

This route’s Upgrade opt-in (ADR 000048), or None for deny-by-default. The fast path tunnels only when the client’s token is allowlisted here.

compression: Option<Arc<CompressionConfig>>

This route’s compression opt-in (ADR 000074), or None for never-transform. The fast path negotiates and compresses AFTER the response chain, on the streamed body filters never see.

Implementations

impl RouteInfo

pub fn pick_upstream(&self) -> Option<Arc<UpstreamGroup>>

Pick the upstream group to forward this request to from the route’s weighted traffic split (ADR 000034): the next backend in the split order that has an eligible instance (renormalize over healthy), or None when no backend is eligible (the fast path then fails closed 503, the same no-healthy fault as a single upstream). Lock-free.

pub fn rewrite_path<'a>(&self, path: &'a str) -> Cow<'a, str>

Apply this route’s host-native prefix strip to the path the fast-path server forwards to the upstream. The chain already ran against the original path; this only affects what the upstream sees. No rule (or a non-matching path) leaves the path unchanged — borrowed, so the common no-strip case allocates nothing.

pub fn check_rate_limit(&self, peer: IpAddr) -> RateLimitDecision

Consult this route’s native rate limiter (ADR 000033) for one request, keyed on the connection peer. Allow when the route has no limiter or a token was available; Limit { retry_after_ms } when the bucket is empty (the fast path fails closed with 429). Called BEFORE the filter chain so a flood is shed without spending WASM CPU.

Trait Implementations

impl Clone for RouteInfo

fn clone(&self) -> RouteInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RouteInfo

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

Formats the value using the given formatter.