Struct actix_web::http::NormalizePath

[+] Show declaration

pub struct NormalizePath { /* fields omitted */ }

[−] Expand description

Path normalization helper

By normalizing it means:

• Add a trailing slash to the path.
• Remove a trailing slash from the path.
• Double slashes are replaced by one.

The handler returns as soon as it finds a path that resolves correctly. The order if all enable is 1) merge, 3) both merge and append and 3) append. If the path resolves with at least one of those conditions, it will redirect to the new path.

If append is true append slash when needed. If a resource is defined with trailing slash and the request comes without it, it will append it automatically.

If merge is true, merge multiple consecutive slashes in the path into one.

This handler designed to be use as a handler for application's default resource.

use actix_web::http::NormalizePath;

fn main() {
    let app = App::new()
        .resource("/test/", |r| r.f(index))
        .default_resource(|r| r.h(NormalizePath::default()))
        .finish();
}

In this example /test, /test/// will be redirected to /test/ url.

Methods

impl NormalizePath

[−]

pub fn new(append: bool, merge: bool, redirect: StatusCode) -> NormalizePath

[−]

Create new NormalizePath instance

Trait Implementations

impl Default for NormalizePath

[+]

fn default() -> NormalizePath

[−]

Create default NormalizePath instance, append is set to true, merge is set to true and redirect is set to StatusCode::MOVED_PERMANENTLY

impl<S> Handler<S> for NormalizePath

[+]

type Result = HttpResponse

The type of value that handler will return.

fn handle(&self, req: &HttpRequest<S>) -> Self::Result

[−]

Handle request