Skip to main content

MiddlewareStackExt

Trait MiddlewareStackExt 

Source
pub trait MiddlewareStackExt {
    // Required methods
    fn insert_before(
        &mut self,
        name: &str,
        middleware: Box<dyn MiddlewareLayer>,
    ) -> &mut Self;
    fn insert_after(
        &mut self,
        name: &str,
        middleware: Box<dyn MiddlewareLayer>,
    ) -> &mut Self;
    fn replace(
        &mut self,
        name: &str,
        middleware: Box<dyn MiddlewareLayer>,
    ) -> &mut Self;
    fn delete(&mut self, name: &str) -> &mut Self;
}
Expand description

Ergonomic, Rails-style edits to a middleware stack.

Operates on a Vec<Box<dyn MiddlewareLayer>>, for use inside crate::app::Hooks::middlewares when you want to tweak the default stack (from default_middleware_stack) rather than rebuild it.

Middlewares are matched by MiddlewareLayer::name. Positions are relative to the stack Vec. Note the application order: the stack is applied in Vec order and each middleware wraps the router, so a middleware later in the Vec runs earlier in request processing (tower is LIFO).

If no middleware matches name, the operation logs a warning; insert_before / insert_after still append the new middleware (so it is not silently dropped), while replace / delete leave the stack unchanged.

Required Methods§

Source

fn insert_before( &mut self, name: &str, middleware: Box<dyn MiddlewareLayer>, ) -> &mut Self

Insert middleware immediately before the first middleware named name.

Source

fn insert_after( &mut self, name: &str, middleware: Box<dyn MiddlewareLayer>, ) -> &mut Self

Insert middleware immediately after the first middleware named name.

Source

fn replace( &mut self, name: &str, middleware: Box<dyn MiddlewareLayer>, ) -> &mut Self

Replace the first middleware named name with middleware.

Source

fn delete(&mut self, name: &str) -> &mut Self

Remove the first middleware named name.

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types§

Source§

impl MiddlewareStackExt for Vec<Box<dyn MiddlewareLayer>>

Source§

fn insert_before( &mut self, name: &str, middleware: Box<dyn MiddlewareLayer>, ) -> &mut Self

Source§

fn insert_after( &mut self, name: &str, middleware: Box<dyn MiddlewareLayer>, ) -> &mut Self

Source§

fn replace( &mut self, name: &str, middleware: Box<dyn MiddlewareLayer>, ) -> &mut Self

Source§

fn delete(&mut self, name: &str) -> &mut Self

Implementors§