Struct actix_web::http::NormalizePath

pub struct NormalizePath { /* fields omitted */ }

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<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

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