Struct WithMiddleware 

pub struct WithMiddleware<E: Endpoint, M: Middleware> { /* private fields */ }

A wrapper that combines an endpoint with middleware.

WithMiddleware allows you to compose an endpoint with middleware to add cross-cutting concerns like logging, authentication, rate limiting, etc. The middleware is executed first and can decide whether to call the endpoint and how to process the response.

Type Parameters

• E - The endpoint type that implements Endpoint
• M - The middleware type that implements Middleware

Examples

use http_kit::{Request, Response, Result, Endpoint, Middleware, endpoint::WithMiddleware};

struct TimingMiddleware;
impl Middleware for TimingMiddleware {
    async fn handle(&self, request: &mut Request, next: impl Endpoint) -> Result<Response> {
        let start = std::time::Instant::now();
        let response = next.respond(request).await;
        let duration = start.elapsed();
        println!("Request took {:?}", duration);
        response
    }
}

struct HelloEndpoint;
impl Endpoint for HelloEndpoint {
    async fn respond(&self, _request: &mut Request) -> Result<Response> {
        Ok(Response::new(200, "Hello"))
    }
}

let timed_endpoint = WithMiddleware::new(HelloEndpoint, TimingMiddleware);

Implementations

impl<E: Endpoint, M: Middleware> WithMiddleware<E, M>

pub fn new(endpoint: E, middleware: M) -> Self

Creates a new endpoint that wraps the given endpoint with middleware.

When the resulting endpoint handles a request, the middleware will be executed first. The middleware can then decide whether to call the wrapped endpoint and how to process its response.

Arguments

• endpoint - The endpoint to wrap
• middleware - The middleware to apply

Examples

use http_kit::{Request, Response, Result, Endpoint, Middleware, endpoint::WithMiddleware};

struct AuthMiddleware { token: String }
impl Middleware for AuthMiddleware {
    async fn handle(&self, request: &mut Request, next: impl Endpoint) -> Result<Response> {
        if let Some(auth) = request.get_header(http::header::AUTHORIZATION) {
            if auth.as_bytes() == self.token.as_bytes() {
                return next.respond(request).await;
            }
        }
        Ok(Response::new(401, "Unauthorized"))
    }
}

struct SecretEndpoint;
impl Endpoint for SecretEndpoint {
    async fn respond(&self, _request: &mut Request) -> Result<Response> {
        Ok(Response::new(200, "Secret data"))
    }
}

let auth_middleware = AuthMiddleware { token: "secret".to_string() };
let protected_endpoint = WithMiddleware::new(SecretEndpoint, auth_middleware);

Trait Implementations

impl<E: Clone + Endpoint, M: Clone + Middleware> Clone for WithMiddleware<E, M>

fn clone(&self) -> WithMiddleware<E, M>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Debug + Endpoint, M: Debug + Middleware> Debug for WithMiddleware<E, M>

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

Formats the value using the given formatter.

impl<E: Default + Endpoint, M: Default + Middleware> Default for WithMiddleware<E, M>

fn default() -> WithMiddleware<E, M>

Returns the “default value” for a type.

impl<E: Endpoint, M: Middleware> Endpoint for WithMiddleware<E, M>

async fn respond(&mut self, request: &mut Request) -> Result<Response>

Processes an HTTP request and generates a response.

impl<E: Hash + Endpoint, M: Hash + Middleware> Hash for WithMiddleware<E, M>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<E: Ord + Endpoint, M: Ord + Middleware> Ord for WithMiddleware<E, M>

fn cmp(&self, other: &WithMiddleware<E, M>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<E: PartialEq + Endpoint, M: PartialEq + Middleware> PartialEq for WithMiddleware<E, M>

fn eq(&self, other: &WithMiddleware<E, M>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<E: PartialOrd + Endpoint, M: PartialOrd + Middleware> PartialOrd for WithMiddleware<E, M>

fn partial_cmp(&self, other: &WithMiddleware<E, M>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<E: Eq + Endpoint, M: Eq + Middleware> Eq for WithMiddleware<E, M>

impl<E: Endpoint, M: Middleware> StructuralPartialEq for WithMiddleware<E, M>