Struct rocket::response::Flash

source ·
pub struct Flash<R> { /* private fields */ }
Expand description

Sets a “flash” cookie that will be removed when it is accessed. The analogous request type is FlashMessage.

This type makes it easy to send messages across requests. It is typically used for “status” messages after redirects. For instance, if a user attempts to visit a page he/she does not have access to, you may want to redirect the user to a safe place and show a message indicating what happened on the redirected page. The message should only persist for a single request. This can be accomplished with this type.

§Usage

Each Flash message consists of a name and some msg contents. A generic constructor (new) can be used to construct a message with any name, while the warning, success, and error constructors create messages with the corresponding names.

Messages can be retrieved on the request side via the FlashMessage type and the name and msg methods.

§Response

The Responder implementation for Flash sets the message cookie and then uses the passed in responder res to complete the response. In other words, it simply sets a cookie and delegates the rest of the response handling to the wrapped responder.

§Example

The following complete Rocket application illustrates the use of a Flash message on both the request and response sides.

use rocket::response::{Flash, Redirect};
use rocket::request::FlashMessage;
use rocket::http::RawStr;

#[post("/login/<name>")]
fn login(name: &RawStr) -> Result<&'static str, Flash<Redirect>> {
    if name == "special_user" {
        Ok("Hello, special user!")
    } else {
        Err(Flash::error(Redirect::to("/"), "Invalid username."))
    }
}

#[get("/")]
fn index(flash: Option<FlashMessage>) -> String {
    flash.map(|msg| format!("{}: {}", msg.name(), msg.msg()))
         .unwrap_or_else(|| "Welcome!".to_string())
}

fn main() {
    rocket::ignite().mount("/", routes![login, index]).launch();
}

On the response side (in login), a Flash error message is set if some fictional authentication failed, and the user is redirected to "/". On the request side (in index), the handler emits the flash message if there is one and otherwise emits a standard welcome message. Note that if the user were to refresh the index page after viewing a flash message, the user would receive the standard welcome message.

Implementations§

source§

impl<'r, R: Responder<'r>> Flash<R>

source

pub fn new<N: AsRef<str>, M: AsRef<str>>(res: R, name: N, msg: M) -> Flash<R>

Constructs a new Flash message with the given name, msg, and underlying responder.

§Examples

Construct a “suggestion” message with contents “Try this out!” that redirects to “/”.

use rocket::response::{Redirect, Flash};

let msg = Flash::new(Redirect::to("/"), "suggestion", "Try this out!");
source

pub fn success<S: AsRef<str>>(responder: R, msg: S) -> Flash<R>

Constructs a “success” Flash message with the given responder and msg.

§Examples

Construct a “success” message with contents “It worked!” that redirects to “/”.

use rocket::response::{Redirect, Flash};

let msg = Flash::success(Redirect::to("/"), "It worked!");
source

pub fn warning<S: AsRef<str>>(responder: R, msg: S) -> Flash<R>

Constructs a “warning” Flash message with the given responder and msg.

§Examples

Construct a “warning” message with contents “Watch out!” that redirects to “/”.

use rocket::response::{Redirect, Flash};

let msg = Flash::warning(Redirect::to("/"), "Watch out!");
source

pub fn error<S: AsRef<str>>(responder: R, msg: S) -> Flash<R>

Constructs an “error” Flash message with the given responder and msg.

§Examples

Construct an “error” message with contents “Whoops!” that redirects to “/”.

use rocket::response::{Redirect, Flash};

let msg = Flash::error(Redirect::to("/"), "Whoops!");
source§

impl<'a, 'r> Flash<&'a Request<'r>>

source

pub fn name(&self) -> &str

Returns the name of this message.

source

pub fn msg(&self) -> &str

Returns the msg contents of this message.

Trait Implementations§

source§

impl<R: Debug> Debug for Flash<R>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'a, 'r> FromRequest<'a, 'r> for Flash<&'a Request<'r>>

Retrieves a flash message from a flash cookie. If there is no flash cookie, or if the flash cookie is malformed, an empty Err is returned.

The suggested use is through an Option and the FlashMessage type alias in request: Option<FlashMessage>.

§

type Error = ()

The associated error to be returned if derivation fails.
source§

fn from_request(req: &'a Request<'r>) -> Outcome<Self, Self::Error>

Derives an instance of Self from the incoming request metadata. Read more
source§

impl<'r, R: Responder<'r>> Responder<'r> for Flash<R>

Sets the message cookie and then uses the wrapped responder to complete the response. In other words, simply sets a cookie and delegates the rest of the response handling to the wrapped responder. As a result, the Outcome of the response is the Outcome of the wrapped Responder.

source§

fn respond_to(self, req: &Request<'_>) -> Result<Response<'r>, Status>

Returns Ok if a Response could be generated successfully. Otherwise, returns an Err with a failing Status. Read more

Auto Trait Implementations§

§

impl<R> !Freeze for Flash<R>

§

impl<R> RefUnwindSafe for Flash<R>
where R: RefUnwindSafe,

§

impl<R> Send for Flash<R>
where R: Send,

§

impl<R> Sync for Flash<R>
where R: Sync,

§

impl<R> Unpin for Flash<R>
where R: Unpin,

§

impl<R> UnwindSafe for Flash<R>
where R: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn as_result(self) -> Result<T, ParseErr<I>>

source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> IntoCollection<T> for T

§

fn into_collection<A>(self) -> SmallVec<A>
where A: Array<Item = T>,

Converts self into a collection.
§

fn mapped<U, F, A>(self, f: F) -> SmallVec<A>
where F: FnMut(T) -> U, A: Array<Item = U>,

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

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

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> Typeable for T
where T: Any,

source§

fn get_type(&self) -> TypeId

Get the TypeId of this object.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V