Struct ScopedRouteMatcher 

pub struct ScopedRouteMatcher { /* private fields */ }

Scope-aware route matcher.

Maintains separate route matchers for each scope and provides scope-aware request matching following visibility rules.

Implementations

impl ScopedRouteMatcher

pub fn new() -> Self

Create a new empty scoped route matcher.

pub async fn from_flattened( config: &FlattenedConfig, ) -> Result<Self, RouteError>

Create a scoped route matcher from a flattened configuration.

pub async fn load_from_flattened( &self, config: &FlattenedConfig, ) -> Result<(), RouteError>

Load routes from a flattened configuration.

pub async fn set_default_route(&self, scope: Scope, route_id: impl Into<String>)

Set the default route for a specific scope.

pub async fn set_global_default(&self, route_id: impl Into<String>)

Set the global default route.

pub async fn match_request( &self, req: &RequestInfo<'_>, from_scope: &Scope, ) -> Option<ScopedRouteMatch>

Match a request within a specific scope.

Searches through the scope chain (most specific to least specific):

1. The exact scope (service or namespace)
2. Parent namespace (if in service scope)
3. Global scope

The first matching route wins (“most specific wins” rule).

pub async fn get_route(&self, qid: &QualifiedId) -> Option<Arc<RouteConfig>>

Get a route by its qualified ID.

pub async fn needs_headers(&self) -> bool

Check if any matcher needs headers for matching.

pub async fn needs_query_params(&self) -> bool

Check if any matcher needs query params for matching.

pub async fn clear_caches(&self)

Clear all route caches.

pub async fn scope_count(&self) -> usize

Get the number of scopes with routes.

pub async fn total_routes(&self) -> usize

Get the total number of routes across all scopes.

pub async fn scopes(&self) -> Vec<Scope>

Get all scopes that have routes.

Trait Implementations

impl Default for ScopedRouteMatcher

fn default() -> Self

Returns the “default value” for a type.