Struct rocket::response::Stream

pub struct Stream<T: Read>(_, _);

Streams a response to a client from an arbitrary Reader type.

The client is sent a "chunked" response, where the chunk size is at most 4KiB. This means that at most 4KiB are stored in memory while the response is being sent. This type should be used when sending responses that are arbitrarily large in size, such as when streaming from a local socket.

Methods

impl<T: Read> Stream<T>

fn from(reader: T) -> Stream<T>

Create a new stream from the given reader.

Example

Stream a response from whatever is in stdin. Note: you probably shouldn't do this.

use std::io;
use rocket::response::Stream;

let response = Stream::from(io::stdin());

fn chunked(reader: T, chunk_size: u64) -> Stream<T>

Create a new stream from the given reader and sets the chunk size for each streamed chunk to chunk_size bytes.

Example

Stream a response from whatever is in stdin with a chunk size of 10 bytes. Note: you probably shouldn't do this.

use std::io;
use rocket::response::Stream;

let response = Stream::chunked(io::stdin(), 10);

Trait Implementations

impl<T: Read + Debug> Debug for Stream<T>

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

Formats the value using the given formatter.

impl<'r, T: Read + 'r> Responder<'r> for Stream<T>

Sends a response to the client using the "Chunked" transfer encoding. The maximum chunk size is 4KiB.

Failure

If reading from the input stream fails at any point during the response, the response is abandoned, and the response ends abruptly. An error is printed to the console with an indication of what went wrong.

fn respond(self) -> Result<Response<'r>, Status>

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