Struct Router 

pub struct Router { /* private fields */ }

Router struct, contains routes and the methods needed to route requests to them.

Implementations

impl Router

pub fn new() -> Self

Returns a new Router struct.

pub fn route<F, Fut>(&mut self, method: Method, path: &str, handler: F)

where F: Fn(Request) -> Fut + Send + Sync + 'static, Fut: Future<Output = Response> + Send + 'static,

Appends a new route to a router struct. Requires a method, path and handler function. Feature: can take route parameters: /:id, <- id would be the parameter, accessible in Request.params.

Example:

use zep::{Router, Method, Request, Response};

async fn handler(req: Request) -> Response {
    if let Some(name) = req.params.get("name") {
        Response::ok(format!("Hello {}!", &name))
    } else {
        Response::ok("Hello World!")
    }
}

let mut router = Router::new();
router.route(Method::GET, "/:name", handler);

pub fn middleware<F, Fut>(&mut self, f: F)

where F: Fn(Request, Handler) -> Fut + Send + Sync + 'static, Fut: Future<Output = Response> + Send + 'static,

Appends a middleware to the latest route. Requires a function with the following signature: async fn middleware(Request, Handler) -> Response

Example:

use zep::{Router, Method, Request, Response, Handler};

async fn handler(_req: Request) -> Response {
    Response::ok("Hello World!")
}

async fn middleware(req: Request, handler: Handler) -> Response {
    //do stuff
    return handler(req).await;
}

let mut router = Router::new();
router.route(Method::GET, "/", handler);
router.middleware(middleware);
//middleware is now applied to the `GET /` route.

Trait Implementations

impl Clone for Router

fn clone(&self) -> Router

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Router

fn default() -> Self

Returns the “default value” for a type.