Struct Response 

pub struct Response { /* private fields */ }

Represents an HTTP response message.

Implementations

impl Response

pub fn new(status: StatusCode) -> Self

Create a new response with the provided status code and canonical reason.

pub fn builder(status: StatusCode) -> ResponseBuilder

Construct a builder for the response.

pub fn version(&self) -> HttpVersion

Return the HTTP version of the response.

pub fn status(&self) -> StatusCode

Return the status code.

pub fn reason_phrase(&self) -> &str

Access the reason phrase used for the status line.

pub fn headers(&self) -> &Headers

Borrow header map immutably.

pub fn headers_mut(&mut self) -> &mut Headers

Borrow header map mutably.

pub fn body(&self) -> &ResponseBody

Borrow the body representation.

pub fn set_status(&mut self, status: StatusCode)

Override the status code.

pub fn take_body(&mut self) -> ResponseBody

Remove and return the body, leaving an empty placeholder behind.

pub fn set_body(&mut self, body: ResponseBody)

Replace the body with the provided representation.

pub fn set_body_bytes(&mut self, bytes: impl Into<Bytes>)

Convenience helper for replacing the body with fully buffered bytes.

pub fn set_body_static(&mut self, bytes: &'static [u8])

Replace the body with a static byte slice without copying.

pub fn set_body_text_static(&mut self, text: &'static str)

Replace the body with a static UTF-8 string without copying.

pub fn strip_body_for_head(&mut self)

Prepare the response for a HEAD reply by stripping the body while preserving the advertised payload length when known.

pub fn trailers(&self) -> Option<&Headers>

Borrow the trailers if present.

pub fn set_trailers(&mut self, trailers: Headers)

Replace the trailers with the provided header set.

pub fn take_trailers(&mut self) -> Option<Headers>

Remove any trailers from the response and return them.

pub fn body_mut(&mut self) -> &mut ResponseBody

Borrow the body mutably.

pub fn set_version(&mut self, version: HttpVersion)

Override the HTTP version.

pub fn set_reason(&mut self, reason: impl Into<String>)

Override the reason phrase.

Trait Implementations

impl Debug for Response

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

Formats the value using the given formatter.