Struct rocket::response::Stream
[−]
[src]
pub struct Stream<T: Read>(_, _);
Streams a response to a client from an arbitrary Read
er 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>
[src]
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>
[src]
impl<'r, T: Read + 'r> Responder<'r> for Stream<T>
[src]
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.