Struct LocalResponse

pub struct LocalResponse<'c> { /* private fields */ }

A blocking response from a dispatched LocalRequest.

This LocalResponse implements io::Read. As such, if into_string() and into_bytes() do not suffice, the response’s body can be read directly:

use std::io::{self, Read};

use rocket::local::blocking::Client;
use rocket::http::Status;

#[get("/")]
fn hello_world() -> &'static str {
    "Hello, world!"
}

#[launch]
fn rocket() -> _ {
    rocket::build().mount("/", routes![hello_world])
}

// Dispatch a `GET /` request.
let client = Client::tracked(rocket()).expect("valid rocket");
let mut response = client.get("/").dispatch();

// Check metadata validity.
assert_eq!(response.status(), Status::Ok);
assert_eq!(response.body().preset_size(), Some(13));

// Read 10 bytes of the body. Note: in reality, we'd use `into_string()`.
let mut buffer = [0; 10];
response.read(&mut buffer)?;
assert_eq!(buffer, "Hello, wor".as_bytes());

For more, see the top-level documentation.

Implementations

impl LocalResponse<'_>

pub fn status(&self) -> Status

Returns the HTTP status of self.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let status = response.status();

pub fn content_type(&self) -> Option<ContentType>

Returns the Content-Type, if a valid one is set, of self.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let content_type = response.content_type();

pub fn headers(&self) -> &HeaderMap<'_>

Returns the HTTP headers of self.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let headers = response.headers();

pub fn cookies(&self) -> &CookieJar<'_>

Return a cookie jar containing the HTTP cookies in the response.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let string = response.cookies();

pub fn body(&self) -> &Body<'_>

Returns the response body, if there is one, of self.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let body = response.body();

pub fn into_string(self) -> Option<String>

Consumes self and reads the entirety of its body into a string.

If reading fails, the body contains invalid UTF-8 characters, or the body is unset in the response, returns None. Otherwise, returns Some. The string may be empty if the body is empty.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let string = response.into_string();

pub fn into_bytes(self) -> Option<Vec<u8>>

Consumes self and reads the entirety of its body into a Vec of bytes.

If reading fails or the body is unset in the response, returns None. Otherwise, returns Some. The returned vector may be empty if the body is empty.

Example

use rocket::local::blocking::LocalResponse;

let response: LocalResponse = response;
let bytes = response.into_bytes();

pub fn into_json<T>(self) -> Option<T>

where T: Send + DeserializeOwned + 'static,

Available on crate feature json only.

Consumes self and deserializes its body as JSON without buffering in memory.

If deserialization fails or the body is unset in the response, returns None. Otherwise, returns Some.

Example

use rocket::local::blocking::LocalResponse;
use rocket::serde::Deserialize;

#[derive(Deserialize)]
struct Task {
    id: usize,
    complete: bool,
    text: String,
}

let response: LocalResponse = response;
let task = response.into_json::<Task>();

pub fn into_msgpack<T>(self) -> Option<T>

where T: Send + DeserializeOwned + 'static,

Available on crate feature msgpack only.

Consumes self and deserializes its body as MessagePack without buffering in memory.

If deserialization fails or the body is unset in the response, returns None. Otherwise, returns Some.

Example

use rocket::local::blocking::LocalResponse;
use rocket::serde::Deserialize;

#[derive(Deserialize)]
struct Task {
    id: usize,
    complete: bool,
    text: String,
}

let response: LocalResponse = response;
let task = response.into_msgpack::<Task>();

Trait Implementations

impl Debug for LocalResponse<'_>

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

Formats the value using the given formatter.

impl Read for LocalResponse<'_>

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

fn is_read_vectored(&self) -> bool

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

Determines if this Reader has an efficient read_vectored implementation.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>

Reads all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Reads all bytes until EOF in this source, appending them to buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Reads the exact number of bytes required to fill buf.

fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>

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

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>

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

Reads the exact number of bytes required to fill cursor.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adaptor for this instance of Read.

fn bytes(self) -> Bytes<Self>

where Self: Sized,

Transforms this Read instance to an Iterator over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R>

where R: Read, Self: Sized,

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

where Self: Sized,

Creates an adapter which will read at most limit bytes from it.