Enum RedirectBehavior

pub enum RedirectBehavior {
    Redirect301,
    Redirect307,
    Redirect308,
    UseHandler,
}

Sets the behavior when the router redirects the request to the canonical version of the requested URL using redirect_trailing_slash or redirect_clean. The default behavior is to return a 301 status, redirecting the browser to the version of the URL that matches the given pattern.

On a POST request, most browsers that receive a 301 will submit a GET request to the redirected URL, meaning that any data will likely be lost. If you want to handle and avoid this behavior, you may use TEMPORARY_REDIRECT (307), which causes most browsers to resubmit the request using the original method and request body.

Since 307 is supposed to be a temporary redirect, the new 308 status code has been proposed, which is treated the same, except it indicates correctly that the redirection is permanent. The big caveat here is that the RFC is relatively recent, and older browsers will not know what to do with it. Therefore its use is not recommended unless you really know what you’re doing.

Variants

Redirect301

Redirect307

Redirect308

UseHandler

Trait Implementations

impl Clone for RedirectBehavior

fn clone(&self) -> RedirectBehavior

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RedirectBehavior

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for RedirectBehavior

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for RedirectBehavior

fn eq(&self, other: &RedirectBehavior) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for RedirectBehavior

impl Eq for RedirectBehavior

impl StructuralPartialEq for RedirectBehavior