Skip to main content

RewriteLayer

Struct RewriteLayer 

Source
pub struct RewriteLayer { /* private fields */ }
Expand description

Composable request/response rewriting middleware.

Clones the incoming Request, applies request rules, dispatches to the next handler, then applies response rules on the returned Response.

All builder methods take self by value and return Self for chaining.

Implementations§

Source§

impl RewriteLayer

Source

pub fn new() -> Self

Source

pub fn request_header_set(self, name: &str, value: &str) -> Self

Add or replace a request header (case-insensitive name match).

Source

pub fn request_header_remove(self, name: &str) -> Self

Remove a request header (case-insensitive).

Source

pub fn request_uri_set(self, uri: &str) -> Self

Replace the entire request URI.

Source

pub fn request_uri_strip_prefix(self, prefix: &str) -> Self

Strip a path prefix from the request URI. No-op if the prefix is absent. Normalizes to "/" if stripping leaves an empty path.

Source

pub fn request_uri_add_prefix(self, prefix: &str) -> Self

Prepend a prefix to the request URI.

Source

pub fn response_header_set(self, name: &str, value: &str) -> Self

Add or replace a response header (case-insensitive name match).

Source

pub fn response_header_remove(self, name: &str) -> Self

Remove a response header (case-insensitive).

Source

pub fn response_status(self, code: i16, reason: &str) -> Self

Override the response status code and reason phrase.

Source

pub fn response_body_replace(self, from: &str, to: &str) -> Self

Byte-level find-and-replace across all response body content ranges.

Trait Implementations§

Source§

impl Middleware for RewriteLayer

Source§

fn handle( &self, request: &Request, connection: &ConnectionInfo, next: &dyn Application, ) -> Result<Response, String>

Source§

fn runs_inline(&self, _request: &Request, _connection: &ConnectionInfo) -> bool

true when this layer’s own work for request never blocks (in-memory state, atomics, short mutexes) — see Application::runs_inline. A WithMiddleware stack runs inline only if every layer and the inner application agree. Default false.
Source§

fn is_passthrough( &self, _request: &Request, _connection: &ConnectionInfo, ) -> bool

true when handle would do nothing for request but call next (e.g. a rate limit that isn’t configured). A WithMiddleware stack offers the inner application’s execute_async only if every layer passes the request through. Default false.
Source§

fn accepts_streamed_body( &self, _request: &Request, _connection: &ConnectionInfo, ) -> bool

true when this layer never reads request.body, so the inner application may receive it as a stream (Application::streams_body). A layer that inspects the body (CSRF tokens in a form, request signatures, rewriting) must keep the default false: it would see an empty body.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more