Struct Router 

pub struct Router { /* private fields */ }

Path-based request router.

Wraps matchit::Router to map URL path patterns to RouteHandler implementations. Supports matchit path syntax: /exact, /prefix/{param}, /{*catch_all}.

Exact paths are matched before parameterized/catch-all patterns, so registering /.well-known/openid-configuration alongside /{*path} will always route OIDC discovery before the catch-all.

Implementations

impl Router

pub fn new() -> Self

pub fn route(self, path: &str, handler: impl RouteHandler + 'static) -> Self

Register a handler for a path pattern.

Supports matchit syntax: /exact, /prefix/{param}, /{*catch_all}. Panics if the path conflicts with an already-registered route.

pub async fn dispatch(&self, req: &RequestInfo<'_>) -> Option<HandlerAction>

Try to match a path and invoke the matched handler.

On match, the handler receives a RequestInfo with populated Params extracted from the path pattern.

Returns Some(action) if a route matched and the handler produced an action. Returns None if no route matched or the handler declined (returned None).

Trait Implementations

impl Default for Router

fn default() -> Self

Returns the “default value” for a type.