Rocket/examples/manual_routes/src/main.rs

extern crate rocket;

#[cfg(test)]
mod tests;

use std::env;

use rocket::{Request, Handler, Route, Data, Catcher, try_outcome};
use rocket::http::{Status, RawStr};
use rocket::response::{self, Responder, status::Custom};
use rocket::handler::{Outcome, HandlerFuture};
use rocket::outcome::IntoOutcome;
use rocket::http::Method::*;
use rocket::futures::future::BoxFuture;
use rocket::tokio::fs::File;

fn forward<'r>(_req: &'r Request, data: Data) -> HandlerFuture<'r> {
    Box::pin(async move { Outcome::forward(data) })
}

fn hi<'r>(req: &'r Request, _: Data) -> HandlerFuture<'r> {
    Box::pin(async move { Outcome::from(req, "Hello!").await })
}

fn name<'a>(req: &'a Request, _: Data) -> HandlerFuture<'a> {
    Box::pin(async move {
        let param = req.get_param::<&'a RawStr>(0)
            .and_then(|res| res.ok())
            .unwrap_or("unnamed".into());

        Outcome::from(req, param.as_str()).await
    })
}

fn echo_url<'r>(req: &'r Request, _: Data) -> HandlerFuture<'r> {
    Box::pin(async move {
        let param_outcome = req.get_param::<&RawStr>(1)
            .and_then(|res| res.ok())
            .into_outcome(Status::BadRequest);
        let param = try_outcome!(param_outcome);
        Outcome::try_from(req, RawStr::from_str(param).url_decode()).await
    })
}

fn upload<'r>(req: &'r Request, data: Data) -> HandlerFuture<'r> {
    Box::pin(async move {
        if !req.content_type().map_or(false, |ct| ct.is_plain()) {
            println!("    => Content-Type of upload must be text/plain. Ignoring.");
            return Outcome::failure(Status::BadRequest);
        }

        let file = File::create(env::temp_dir().join("upload.txt")).await;
        if let Ok(file) = file {
            if let Ok(n) = data.stream_to(file).await {
                return Outcome::from(req, format!("OK: {} bytes uploaded.", n)).await;
            }

            println!("    => Failed copying.");
            Outcome::failure(Status::InternalServerError)
        } else {
            println!("    => Couldn't open file: {:?}", file.unwrap_err());
            Outcome::failure(Status::InternalServerError)
        }
    })
}

fn get_upload<'r>(req: &'r Request, _: Data) -> HandlerFuture<'r> {
    Outcome::from(req, std::fs::File::open(env::temp_dir().join("upload.txt")).ok())
}

fn not_found_handler<'r>(req: &'r Request) -> BoxFuture<'r, response::Result<'r>> {
    let res = Custom(Status::NotFound, format!("Couldn't find: {}", req.uri()));
    res.respond_to(req)
}

#[derive(Clone)]
struct CustomHandler {
    data: &'static str
}

impl CustomHandler {
    fn new(data: &'static str) -> Vec<Route> {
        vec![Route::new(Get, "/<id>", Self { data })]
    }
}

impl Handler for CustomHandler {
    fn handle<'r>(&self, req: &'r Request, data: Data) -> HandlerFuture<'r> {
        let self_data = self.data;
        Box::pin(async move {
            let id_outcome = req.get_param::<&RawStr>(0)
                .and_then(|res| res.ok())
                .or_forward(data);

            let id = try_outcome!(id_outcome);
            Outcome::from(req, format!("{} - {}", self_data, id)).await
        })
    }
}

fn rocket() -> rocket::Rocket {
    let always_forward = Route::ranked(1, Get, "/", forward);
    let hello = Route::ranked(2, Get, "/", hi);

    let echo = Route::new(Get, "/echo/<str>", echo_url);
    let name = Route::new(Get, "/<name>", name);
    let post_upload = Route::new(Post, "/", upload);
    let get_upload = Route::new(Get, "/", get_upload);

    let not_found_catcher = Catcher::new(404, not_found_handler);

    rocket::ignite()
        .mount("/", vec![always_forward, hello, echo])
        .mount("/upload", vec![get_upload, post_upload])
        .mount("/hello", vec![name.clone()])
        .mount("/hi", vec![name])
        .mount("/custom", CustomHandler::new("some data here"))
        .register(vec![not_found_catcher])
}

#[rocket::main]
async fn main() {
    let _ = rocket().launch().await;
}