Struct Handler

pub struct Handler { /* private fields */ }

Handler

Matches requests by their method and url, and executes different handler functions for them.

Example

use http_srv::handler::{self,*};
use http::request::HttpRequest;
use http::HttpMethod;

let mut handler = Handler::new();
handler.get("/", |req: &mut HttpRequest| {
    req.respond_str("Hello world! :)")
});
handler.add_default(HttpMethod::GET, handler::cat_handler);
handler.post_interceptor(handler::log_stdout);

Implementations

impl Handler

pub fn new() -> Self

pub fn get(&mut self, url: impl Into<UrlMatcher>, f: impl RequestHandler)

Shortcut for add(HttpMethod::GET, …)

pub fn post(&mut self, url: impl Into<UrlMatcher>, f: impl RequestHandler)

Shortcut for add(HttpMethod::POST, …)

pub fn delete(&mut self, url: impl Into<UrlMatcher>, f: impl RequestHandler)

Shortcut for add(HttpMethod::DELETE, …)

pub fn head(&mut self, url: impl Into<UrlMatcher>, f: impl RequestHandler)

Shortcut for add(HttpMethod::HEAD, …)

pub fn add( &mut self, method: HttpMethod, url: impl Into<UrlMatcher>, f: impl RequestHandler, )

Adds a handler for a request type

• method: HTTP method to match
• url: URL for the handler
• f: Handler for the request

pub fn add_default(&mut self, method: HttpMethod, f: impl RequestHandler)

Adds a default handler for all requests of a certain type

• method: HTTP method to match
• f: Handler for the requests

pub fn pre_interceptor(&mut self, f: impl Interceptor)

Add a function to run before the request is processed

pub fn post_interceptor(&mut self, f: impl Interceptor)

Add a function to run after the request is processed

pub fn get_handler( &self, method: &HttpMethod, url: &str, ) -> Option<&dyn RequestHandler>

Get the handler for a certain method and url

pub fn handle(&self, req: &mut HttpRequest) -> Result<()>

Handles a request if it finds a RequestHandler for it. Else, it returns a 403 FORBIDDEN response

Trait Implementations

impl Default for Handler

fn default() -> Self

Default Handler

Pre Interceptors

• suffix_html
• Set Header: “Accept-Ranges: bytes”

Handler Functions

• GET: cat_handler

• POST: post_handler

• DELETE: delete_handler

• HEAD: head_handler

• GET “/”: root_handler

• HEAD “/”: root_handler

Post Interceptors

• log_stdout