[][src]Struct rocket::response::Redirect

pub struct Redirect(_, _);

An empty redirect response to a given URL.

This type simplifies returning a redirect response to the client.

Usage

All constructors accept a generic type of T: TryInto<Uri<'static>>. Among the candidate types are:

Any non-'static strings must first be allocated using .to_string() or similar before being passed to a Redirect constructor. When redirecting to a route, always use uri! to construct a valid Origin:

use rocket::response::Redirect;

#[get("/hello/<name>/<age>")]
fn hello(name: String, age: u8) -> String {
    format!("Hello, {} year old named {}!", age, name)
}

#[get("/hi/<name>/<age>")]
fn hi(name: String, age: u8) -> Redirect {
    Redirect::to(uri!(hello: name, age))
}

Methods

impl Redirect[src]

pub fn to<U: TryInto<Uri<'static>>>(uri: U) -> Redirect[src]

Construct a temporary "see other" (303) redirect response. This is the typical response when redirecting a user to another page. This type of redirect indicates that the client should look elsewhere, but always via a GET request, for a given resource.

Examples

use rocket::response::Redirect;

let redirect = Redirect::to("/other_url");
let redirect = Redirect::to(format!("https://google.com/{}", query));

pub fn temporary<U: TryInto<Uri<'static>>>(uri: U) -> Redirect[src]

Construct a "temporary" (307) redirect response. This response instructs the client to reissue the current request to a different URL, maintaining the contents of the request identically. This means that, for example, a POST request will be resent, contents included, to the requested URL.

Examples

use rocket::response::Redirect;

let redirect = Redirect::temporary("/other_url");
let redirect = Redirect::temporary(format!("https://google.com/{}", query));

pub fn permanent<U: TryInto<Uri<'static>>>(uri: U) -> Redirect[src]

Construct a "permanent" (308) redirect response. This redirect must only be used for permanent redirects as it is cached by clients. This response instructs the client to reissue requests for the current URL to a different URL, now and in the future, maintaining the contents of the request identically. This means that, for example, a POST request will be resent, contents included, to the requested URL.

Examples

use rocket::response::Redirect;

let redirect = Redirect::permanent("/other_url");
let redirect = Redirect::permanent(format!("https://google.com/{}", query));

pub fn found<U: TryInto<Uri<'static>>>(uri: U) -> Redirect[src]

Construct a temporary "found" (302) redirect response. This response instructs the client to reissue the current request to a different URL, ideally maintaining the contents of the request identically. Unfortunately, different clients may respond differently to this type of redirect, so 303 or 307 redirects, which disambiguate, are preferred.

Examples

use rocket::response::Redirect;

let redirect = Redirect::found("/other_url");
let redirect = Redirect::found(format!("https://google.com/{}", query));

pub fn moved<U: TryInto<Uri<'static>>>(uri: U) -> Redirect[src]

Construct a permanent "moved" (301) redirect response. This response should only be used for permanent redirects as it can be cached by browsers. Because different clients may respond differently to this type of redirect, a 308 redirect, which disambiguates, is preferred.

Examples

use rocket::response::Redirect;

let redirect = Redirect::moved("/other_url");
let redirect = Redirect::moved(format!("https://google.com/{}", query));

Trait Implementations

impl<'a> Responder<'a> for Redirect[src]

Constructs a response with the appropriate status code and the given URL in the Location header field. The body of the response is empty. If the URI value used to create the Responder is an invalid URI, an error of Status::InternalServerError is returned.

impl Debug for Redirect[src]

Auto Trait Implementations

impl Send for Redirect

impl Sync for Redirect

Blanket Implementations

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Typeable for T where
    T: Any

fn get_type(&self) -> TypeId

Get the TypeId of this object.

impl<T> IntoCollection<T> for T

impl<T, I> AsResult<T, I> for T where
    I: Input,