Struct HttpResponse 

pub struct HttpResponse { /* private fields */ }

HTTP Response builder providing Laravel-like response creation

Implementations

impl HttpResponse

pub fn new() -> Self

Create an empty 200 OK response.

pub fn text(body: impl Into<String>) -> Self

Create a response with a string body

pub fn json(body: Value) -> Self

Create a JSON response from a serde_json::Value

pub fn bytes(body: impl Into<Bytes>) -> Self

Create a response with raw binary data.

No default Content-Type is set; the caller must add one via .header().

pub fn download(body: impl Into<Bytes>, filename: &str) -> Self

Create a file download response with Content-Disposition header.

Auto-detects Content-Type from the filename extension using mime_guess. Falls back to application/octet-stream for unknown extensions. The filename is sanitized against header injection (control characters and quote marks are stripped).

pub fn set_body(self, body: impl Into<String>) -> Self

Set the response body

pub fn status(self, status: u16) -> Self

Set the HTTP status code

pub fn status_code(&self) -> u16

Get the current HTTP status code

pub fn body(&self) -> &str

Get the response body as a string slice.

Returns an empty string for non-UTF-8 bodies (e.g. binary data). Use body_bytes() to access raw binary data.

pub fn body_bytes(&self) -> &Bytes

Get the response body as raw bytes.

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Set a response header, replacing any existing header with the same name.

The name match is case-insensitive (ASCII). Use append_header for legitimately multi-value headers such as Set-Cookie, Vary, or Link.

pub fn append_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Append a response header without removing any existing entry with the same name.

Intended for headers that legitimately carry multiple values on separate lines, such as Set-Cookie (RFC 6265 §4.1), Vary, and Link. For single-value headers like Content-Type or Location, use header instead.

pub fn headers(&self) -> &[(String, String)]

Get the response headers as a borrowed slice.

Returns all header entries in insertion order. Multi-value headers (e.g. Set-Cookie) appear as multiple entries with the same name.

pub fn cookie(self, cookie: Cookie) -> Self

Add a Set-Cookie header to the response

Example

use crate::{Cookie, HttpResponse};

let response = HttpResponse::text("OK")
    .cookie(Cookie::new("session", "abc123"))
    .cookie(Cookie::new("user_id", "42"));

pub fn ok(self) -> Response

Wrap this response in Ok() for use as Response type

pub fn into_hyper(self) -> Response<Full<Bytes>>

Convert to hyper response

Trait Implementations

impl Debug for HttpResponse

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

Formats the value using the given formatter.

impl Default for HttpResponse

fn default() -> Self

Returns the “default value” for a type.

impl From<AppError> for HttpResponse

Auto-convert AppError to HttpResponse

This enables using the ? operator in controller handlers with AppError.

fn from(err: AppError) -> HttpResponse

Converts to this type from the input type.

impl From<AuthorizationError> for HttpResponse

fn from(err: AuthorizationError) -> HttpResponse

Converts to this type from the input type.

impl From<FrameworkError> for HttpResponse

Auto-convert FrameworkError to HttpResponse

This enables using the ? operator in controller handlers to propagate framework errors as appropriate HTTP responses.

When a hint is available (via FrameworkError::hint()), the JSON response includes a "hint" field with actionable guidance for the developer.

fn from(err: FrameworkError) -> HttpResponse

Converts to this type from the input type.

impl From<ParamError> for HttpResponse

fn from(err: ParamError) -> HttpResponse

Converts to this type from the input type.