Struct PathRouter 

pub struct PathRouter<T> { /* private fields */ }

A typed prefix router for URI paths.

Routes are compiled as PathPattern prefix matchers and looked up directly against PathRef, so matching does not require callers to lower-case, trim, split, or allocate string lookup keys on the request path.

Implementations

impl<T> PathRouter<T>

pub fn new() -> Self

Create an empty path router.

pub fn is_empty(&self) -> bool

Returns true when no routes are registered.

pub fn len(&self) -> usize

Number of registered routes.

pub fn insert_prefix( &mut self, pattern: impl IntoUriComponent, value: T, ) -> Option<T>

Insert a prefix route using default PathMatchOptions.

If pattern ends in a whole-segment catch-all ({*} / {*name}), the catch-all is treated as “the nested target owns the remainder” and is not counted as part of the matched prefix.

pub fn insert_prefix_with_opts( &mut self, pattern: impl IntoUriComponent, opts: PathMatchOptions, value: T, ) -> Option<T>

Insert a prefix route using explicit PathMatchOptions.

Re-inserting an equivalent compiled pattern replaces the stored value.

pub fn match_prefix<'a, 'p>( &'a self, path: PathRef<'p>, ) -> Option<PathRouteMatch<'a, 'p, T>>

Match path against the most specific registered prefix.

pub fn match_exact<'a, 'p>( &'a self, path: PathRef<'p>, ) -> Option<PathRouteMatch<'a, 'p, T>>

Match path against the most specific registered route only when the route covers the complete path.

Trait Implementations

impl<T: Clone> Clone for PathRouter<T>

fn clone(&self) -> PathRouter<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for PathRouter<T>

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

Formats the value using the given formatter.

impl<T> Default for PathRouter<T>

fn default() -> Self

Returns the “default value” for a type.

impl<Input, T> Service<Input> for PathRouter<T>

where Input: ExtensionsRef + PathInputExt + Send + 'static, T: Service<Input>,

type Output = <T as Service<Input>>::Output

The type of the output returned by the service.

type Error = PathRouterError<<T as Service<Input>>::Error>

The type of error returned by the service.

async fn serve(&self, input: Input) -> Result<Self::Output, Self::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.