Struct Context 

pub struct Context { /* private fields */ }

Implementations

impl Context

pub fn new() -> Self

pub fn insert<T: Send + Sync + 'static>(&mut self, value: T) -> Option<T>

Examples found in repository

examples/homepage.rs (line 16)

async fn request_id(mut req: Request, next: Next) -> Result<Response, Error> {
    let id = REQUEST_COUNTER.fetch_add(1, Ordering::Relaxed);
    req.ctx_mut().insert(RequestId(id));
    let mut resp = resolve(next.run(req).await);
    if let Ok(header) = format!("req-{id}").parse() {
        resp.headers_mut().insert("x-request-id", header);
    }
    Ok(resp)
}

pub fn get<T: Send + Sync + 'static>(&self) -> Option<&T>

Examples found in repository

examples/homepage.rs (line 27)

async fn logger(req: Request, next: Next) -> Result<Response, Error> {
    let method = req.method().clone();
    let path = req.uri().path().to_owned();
    let id = req.ctx().get::<RequestId>().map(|r| r.0);
    let user = rustio_core::auth::identity(req.ctx()).map(|i| i.email.clone());
    let started = Instant::now();
    let result = next.run(req).await;
    let status = match &result {
        Ok(resp) => resp.status().as_u16(),
        Err(err) => err.status(),
    };
    let id_display = id.map(|i| format!("req-{i}")).unwrap_or_else(|| "-".into());
    let user_display = user.unwrap_or_else(|| "-".into());
    eprintln!(
        "[{:>3}] {:>4} {} id={} user={} ({:?})",
        status,
        method,
        path,
        id_display,
        user_display,
        started.elapsed()
    );
    result
}

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let addr: SocketAddr = ([127, 0, 0, 1], 3000).into();
    let db = Db::memory().await.expect("db connect");
    auth::ensure_core_tables(&db)
        .await
        .expect("create auth tables");
    auth::user::create(&db, "admin@example.com", "admin", "admin")
        .await
        .expect("seed admin user");

    let router = with_defaults(Router::new())
        .get("/whoami", |req, _params| async move {
            let id = req
                .ctx()
                .get::<RequestId>()
                .map(|r| r.0.to_string())
                .unwrap_or_else(|| "unknown".into());
            Ok::<Response, Error>(text(format!("your request id is req-{id}\n")))
        })
        .get("/me", |req, _params| async move {
            let id = require_auth(req.ctx())?;
            Ok::<Response, Error>(text(format!("hello {}\n", id.email)))
        })
        .get("/admin-only", |req, _params| async move {
            let id = require_admin(req.ctx())?;
            Ok::<Response, Error>(text(format!("hello admin {}\n", id.email)))
        })
        .get("/crash", |_req, _params| async {
            Err::<Response, Error>(Error::Internal("simulated failure".into()))
        })
        .get("/unauth", |_req, _params| async {
            Err::<Response, Error>(Error::Unauthorized)
        })
        .wrap(request_id)
        .wrap(authenticate(db))
        .wrap(logger);
    Server::bind(addr).serve_router(router).await
}

pub fn get_mut<T: Send + Sync + 'static>(&mut self) -> Option<&mut T>

pub fn remove<T: Send + Sync + 'static>(&mut self) -> Option<T>

pub fn contains<T: 'static>(&self) -> bool

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Trait Implementations

impl Debug for Context

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

Formats the value using the given formatter.

impl Default for Context

fn default() -> Self

Returns the “default value” for a type.