Struct Redirect

pub struct Redirect { /* private fields */ }

Response that redirects the request to another location.

Example

use salvo_core::prelude::*;

#[handler]
async fn hello(res: &mut Response) {
    res.render(Redirect::found("https://www.rust-lang.org/"))
}

Implementations

impl Redirect

pub fn other(uri: impl TryInto<Uri>) -> Redirect

Create a new Redirect that uses a 303 See Other status code.

This redirect instructs the client to change the method to GET for the subsequent request to the given uri, which is useful after successful form submission, file upload or when you generally don’t want the redirected-to page to observe the original request method and body (if non-empty).

Panics

If uri isn’t a valid Uri.

pub fn temporary(uri: impl TryInto<Uri>) -> Redirect

Create a new Redirect that uses a 307 Temporary Redirect status code.

Panics

If uri isn’t a valid Uri.

pub fn permanent(uri: impl TryInto<Uri>) -> Redirect

Create a new Redirect that uses a 308 Permanent Redirect status code.

Panics

If uri isn’t a valid Uri.

pub fn found(uri: impl TryInto<Uri>) -> Redirect

Create a new Redirect that uses a 302 Found status code.

This is the same as Redirect::temporary, except the status code is older and thus supported by some legacy applications that doesn’t understand the newer one, but some of those applications wrongly apply Redirect::other (303 See Other) semantics for this status code. It should be avoided where possible.

Panics

If uri isn’t a valid Uri.

pub fn with_status_code( status_code: StatusCode, uri: impl TryInto<Uri>, ) -> Result<Redirect, Error>

Create a new Redirect that uses a status code.

Trait Implementations

impl Clone for Redirect

fn clone(&self) -> Redirect

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Redirect

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

Formats the value using the given formatter.

impl Scribe for Redirect

fn render(self, res: &mut Response)

Render data to Response.