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

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

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

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

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

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 for T
[src]

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

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

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

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

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

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

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

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

impl<T> Typeable for T where
    T: Any

Get the TypeId of this object.

impl<T> IntoCollection for T

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