Crate roa_router

The router module of roa. This module provides an endpoint RouteEndpoint and a context extension RouterParam.

Example

use roa_router::{Router, RouterParam};
use roa_core::App;
use roa_core::http::StatusCode;
use roa_tcp::Listener;
use async_std::task::spawn;

#[tokio::test]
async fn gate() -> Result<(), Box<dyn std::error::Error>> {
    let mut router = Router::<()>::new();
    router
        .gate_fn(|_ctx, next| next)
        .get("/", |_ctx| async move {
            Ok(())
        });
    let (addr, server) = App::new(()).gate(router.routes("/route")?).run()?;
    spawn(server);
    let resp = reqwest::get(&format!("http://{}/route", addr)).await?;
    assert_eq!(StatusCode::OK, resp.status());

    let resp = reqwest::get(&format!("http://{}/endpoint", addr)).await?;
    assert_eq!(StatusCode::NOT_FOUND, resp.status());
    Ok(())
}

Structs

RouteEndpoint	A endpoint to handle request by uri path and http method.
Router	A builder of RouteEndpoint.

Enums

RouterError

Error occurring in building route endpoint.

Traits

RouterParam

A context extension. This extension must be used in downstream of middleware RouteEndpoint, otherwise you cannot get expected router parameter.