Struct afire::extension::Trace

pub struct Trace { /* private fields */ }

Adds support for the HTTP TRACE method. It echos the request (Status line + Headers) back to the client as the response body. The Cookie header is excluded by default because it could contain sensitive information. Read more about it in RFC-9110.

Implementations

impl Trace

pub fn new() -> Self

Create a new instance of the middleware. Note: The Cookie header is excluded by default because it could contain sensitive information. If you want to include it, use the include method.

pub fn exclude(self, header: HeaderType) -> Self

Adds a header to the list of headers to exclude from the response.

pub fn exclude_all(self, headers: &[HeaderType]) -> Self

Adds a list of headers to the list of headers to exclude from the response.

pub fn include(self, header: HeaderType) -> Self

Removes a header from the list of headers to exclude from the response. Likely to be used with for allowing the Cookie header to be sent, as it is excluded by default.

Trait Implementations

impl Default for Trace

fn default() -> Self

Returns the “default value” for a type.

impl Middleware for Trace

fn pre(&self, req: &mut Request) -> MiddleResult

Middleware to run Before Routes

fn pre_raw(&self, req: &mut Result<Request>) -> MiddleResult

Middleware to run before routes. Because this is the raw version of Middleware::pre, it is passed a Result. The default implementation calls Middleware::pre if the Result is Ok.

fn post_raw( &self, req: Result<Rc<Request>>, res: &mut Result<Response> ) -> MiddleResult

Middleware to run after routes. Because this is the raw version of Middleware::post, it is passed a Result. The default implementation calls Middleware::post if the Result is Ok.

fn post(&self, _req: &Request, _res: &mut Response) -> MiddleResult

Middleware to run After Routes

fn end_raw(&self, req: &Result<Request>, res: &Result<Response>)

Middleware to run after the response has been handled. Because this is the raw version of Middleware::end, it is passed a Result. The default implementation calls Middleware::end if the Result is Ok.

fn end(&self, _req: &Request, _res: &Response)

Middleware ot run after the response has been handled

fn attach<State>(self, server: &mut Server<State>)where Self: 'static + Send + Sync + Sized, State: 'static + Send + Sync,

Attach Middleware to a Server. If you want to get a reference to the server’s state in your middleware state, you should override this method.