Struct Response 

pub struct Response<B = EmptyBody> {
    pub metadata: ResponseMetadata,
    pub body: B,
}

Fields

metadata: ResponseMetadata

body: B

Implementations

impl<B> Response<B>

pub fn new(status: Status, body: B) -> Self

pub fn from_parts(metadata: ResponseMetadata, body: B) -> Self

pub fn into_parts(self) -> (ResponseMetadata, B)

pub fn map_body<T>(self, map: impl FnOnce(B) -> T) -> Response<T>

Move the body through map without cloning or rebuilding the metadata.

pub fn with_body<T>(self, body: T) -> Response<T>

Replace and drop the previous body. This does not drain it or establish asynchronous exchange cleanup; an I/O driver retains that responsibility.

impl Response<EmptyBody>

pub fn empty(status: Status) -> Self

impl<B: ReadableBody> Response<B>

pub fn length(&self) -> Option<u64>

The length of the data this response sends: the body’s own length when it knows one, because the body is what is sent, and otherwise the declaration ResponseMetadata::declared_length keeps. A response without data, to HEAD or with 204 or 304, is instead described by content_length, and a tunnel has no length.

pub async fn read( &mut self, cancellation: &Cancellation, ) -> Result<BodyFrame<B::Data>, B::Error>

Read an owned body frame. Received fields stay in the frame; the caller can forward them or explicitly append them with HttpHeaders::append_trailers.

Methods from Deref<Target = ResponseMetadata>

pub fn declared_length(&self, body: Option<u64>) -> Option<u64>

The declared content_length, unless a body of the given known length contradicts it, as after replacing the body. A codec sending this response’s data uses it; a response without data, to HEAD or with 204 or 304, is described by content_length itself, so every protocol resolves the same length.

Trait Implementations

impl<B: Clone> Clone for Response<B>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B: Debug> Debug for Response<B>

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

Formats the value using the given formatter.

impl<B> Deref for Response<B>

type Target = ResponseMetadata

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<B> DerefMut for Response<B>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.