Struct PathRouter 

pub struct PathRouter { /* private fields */ }

A path-based http request router

A Handler that matches the URL of each incoming request against a list of registered patterns and calls the matching handler, if one exists. If no matching path is found, the handler returns a 404 Not Found.

Implementations

impl PathRouter

pub fn new() -> Self

Creates a new path router instance

pub fn register<H>(&mut self, path: &str, handler: H)

where H: Handler + 'static,

Registers a handler that is invoked on incoming requests path.

Paths support basic segment matching. Matched path values are included in the request object

Path Matching Syntax

Matching an exact path

This will only match requests where the path is “/a/b”. This is not a prefix match.

use claro::{handler::PathRouter, Request, Response};

PathRouter::new().register("/a/b", |_: &mut Request, _: &mut Response| {});

Matching a segment within a path

This will match requests like /a/b/c and /a/blahwhatever/c.

use claro::{handler::PathRouter, Request, Response};

PathRouter::new().register("/a/{next}/c", |_: &mut Request, _: &mut Response| {});

Prefix matching

This will match requests like /a/whatever and /a/blah/blah/blah

use claro::{handler::PathRouter, Request, Response};

PathRouter::new().register("/a/{*rest}", |_: &mut Request, _: &mut Response| {});

Trait Implementations

impl Default for PathRouter

fn default() -> PathRouter

Returns the “default value” for a type.

impl Handler for PathRouter

fn serve(&self, req: &mut Request<'_>, res: &mut Response<'_>)

Respond to an incoming HTTP request