Struct rocket::response::status::Created[][src]

pub struct Created<R>(_, _, _);
Expand description

Sets the status of the response to 201 (Created).

Sets the Location header and optionally the ETag header in the response. The body of the response, which identifies the created resource, can be set via the builder methods Created::body() and Created::tagged_body(). While both builder methods set the responder, the Created::tagged_body() additionally computes a hash for the responder which is used as the value of the ETag header when responding.

Example

use rocket::response::status;

let response = status::Created::new("http://myservice.com/resource.json")
    .tagged_body("{ 'resource': 'Hello, world!' }");

Implementations

impl<'r, R> Created<R>[src]

pub fn new<L: Into<Cow<'static, str>>>(location: L) -> Self[src]

Constructs a Created response with a location and no body.

Example

use rocket::response::status;

#[get("/")]
fn create() -> status::Created<&'static str> {
    status::Created::new("http://myservice.com/resource.json")
}

let response = client.get("/").dispatch();

let loc = response.headers().get_one("Location");
assert_eq!(loc, Some("http://myservice.com/resource.json"));
assert!(response.body().is_none());

pub fn body(self, responder: R) -> Self[src]

Adds responder as the body of self.

Unlike tagged_body(), this method does not result in an ETag header being set in the response.

Example

use rocket::response::status;

#[get("/")]
fn create() -> status::Created<&'static str> {
    status::Created::new("http://myservice.com/resource.json")
        .body("{ 'resource': 'Hello, world!' }")
}

let response = client.get("/").dispatch();

let loc = response.headers().get_one("Location");
assert_eq!(loc, Some("http://myservice.com/resource.json"));

let etag = response.headers().get_one("ETag");
assert_eq!(etag, None);

let body = response.into_string();
assert_eq!(body.unwrap(), "{ 'resource': 'Hello, world!' }");

pub fn tagged_body(self, responder: R) -> Self where
    R: Hash
[src]

Adds responder as the body of self. Computes a hash of the responder to be used as the value of the ETag header.

Example

use rocket::response::status;

#[get("/")]
fn create() -> status::Created<&'static str> {
    status::Created::new("http://myservice.com/resource.json")
        .tagged_body("{ 'resource': 'Hello, world!' }")
}

let response = client.get("/").dispatch();

let loc = response.headers().get_one("Location");
assert_eq!(loc, Some("http://myservice.com/resource.json"));

let etag = response.headers().get_one("ETag");
assert_eq!(etag, Some(r#""13046220615156895040""#));

let body = response.into_string();
assert_eq!(body.unwrap(), "{ 'resource': 'Hello, world!' }");

Trait Implementations

impl<R: Clone> Clone for Created<R>[src]

fn clone(&self) -> Created<R>[src]

Returns a copy of the value. Read more

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl<R: Debug> Debug for Created<R>[src]

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

Formats the value using the given formatter. Read more

impl<R: PartialEq> PartialEq<Created<R>> for Created<R>[src]

fn eq(&self, other: &Created<R>) -> bool[src]

This method tests for self and other values to be equal, and is used by ==. Read more

fn ne(&self, other: &Created<R>) -> bool[src]

This method tests for !=.

impl<'r, 'o: 'r, R: Responder<'r, 'o>> Responder<'r, 'o> for Created<R>[src]

Sets the status code of the response to 201 Created. Sets the Location header to the parameter in the Created::new() constructor.

The optional responder, set via Created::body() or Created::tagged_body() finalizes the response if it exists. The wrapped responder should write the body of the response so that it contains information about the created resource. If no responder is provided, the response body will be empty.

In addition to setting the status code, Location header, and finalizing the response with the Responder, the ETag header is set conditionally if a hashable Responder is provided via Created::tagged_body(). The ETag header is set to a hash value of the responder.

fn respond_to(self, req: &'r Request<'_>) -> Result<'o>[src]

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

impl<R> StructuralPartialEq for Created<R>[src]

Auto Trait Implementations

impl<R> RefUnwindSafe for Created<R> where
    R: RefUnwindSafe

impl<R> Send for Created<R> where
    R: Send

impl<R> Sync for Created<R> where
    R: Sync

impl<R> Unpin for Created<R> where
    R: Unpin

impl<R> UnwindSafe for Created<R> where
    R: UnwindSafe

Blanket Implementations

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

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

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

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

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

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

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

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<T> Instrument for T[src]

fn instrument(self, span: Span) -> Instrumented<Self>[src]

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>[src]

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

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

pub fn into(self) -> U[src]

Performs the conversion.

impl<T> IntoCollection<T> for T

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

Converts self into a collection.

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

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T[src]

Creates owned data from borrowed data, usually by cloning. Read more

pub fn clone_into(&self, target: &mut T)[src]

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

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

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.

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

Performs the conversion.

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.

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

Performs the conversion.

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

pub fn vzip(self) -> V