Struct HttpResponse

pub struct HttpResponse<B = BoxBody> {
    res: Response<B>,
    error: Option<Error>,
}

An outgoing response.

Fields

res: Response<B>

error: Option<Error>

Implementations

impl HttpResponse

pub fn Continue() -> HttpResponseBuilder

pub fn SwitchingProtocols() -> HttpResponseBuilder

pub fn Processing() -> HttpResponseBuilder

pub fn Ok() -> HttpResponseBuilder

pub fn Created() -> HttpResponseBuilder

pub fn Accepted() -> HttpResponseBuilder

pub fn NonAuthoritativeInformation() -> HttpResponseBuilder

pub fn NoContent() -> HttpResponseBuilder

pub fn ResetContent() -> HttpResponseBuilder

pub fn PartialContent() -> HttpResponseBuilder

pub fn MultiStatus() -> HttpResponseBuilder

pub fn AlreadyReported() -> HttpResponseBuilder

pub fn ImUsed() -> HttpResponseBuilder

pub fn MultipleChoices() -> HttpResponseBuilder

pub fn MovedPermanently() -> HttpResponseBuilder

pub fn Found() -> HttpResponseBuilder

pub fn SeeOther() -> HttpResponseBuilder

pub fn NotModified() -> HttpResponseBuilder

pub fn UseProxy() -> HttpResponseBuilder

pub fn TemporaryRedirect() -> HttpResponseBuilder

pub fn PermanentRedirect() -> HttpResponseBuilder

pub fn BadRequest() -> HttpResponseBuilder

pub fn Unauthorized() -> HttpResponseBuilder

pub fn PaymentRequired() -> HttpResponseBuilder

pub fn Forbidden() -> HttpResponseBuilder

pub fn NotFound() -> HttpResponseBuilder

pub fn MethodNotAllowed() -> HttpResponseBuilder

pub fn NotAcceptable() -> HttpResponseBuilder

pub fn ProxyAuthenticationRequired() -> HttpResponseBuilder

pub fn RequestTimeout() -> HttpResponseBuilder

pub fn Conflict() -> HttpResponseBuilder

pub fn Gone() -> HttpResponseBuilder

pub fn LengthRequired() -> HttpResponseBuilder

pub fn PreconditionFailed() -> HttpResponseBuilder

pub fn PayloadTooLarge() -> HttpResponseBuilder

pub fn UriTooLong() -> HttpResponseBuilder

pub fn UnsupportedMediaType() -> HttpResponseBuilder

pub fn RangeNotSatisfiable() -> HttpResponseBuilder

pub fn ExpectationFailed() -> HttpResponseBuilder

pub fn ImATeapot() -> HttpResponseBuilder

pub fn MisdirectedRequest() -> HttpResponseBuilder

pub fn UnprocessableEntity() -> HttpResponseBuilder

pub fn Locked() -> HttpResponseBuilder

pub fn FailedDependency() -> HttpResponseBuilder

pub fn UpgradeRequired() -> HttpResponseBuilder

pub fn PreconditionRequired() -> HttpResponseBuilder

pub fn TooManyRequests() -> HttpResponseBuilder

pub fn RequestHeaderFieldsTooLarge() -> HttpResponseBuilder

pub fn UnavailableForLegalReasons() -> HttpResponseBuilder

pub fn InternalServerError() -> HttpResponseBuilder

pub fn NotImplemented() -> HttpResponseBuilder

pub fn BadGateway() -> HttpResponseBuilder

pub fn ServiceUnavailable() -> HttpResponseBuilder

pub fn GatewayTimeout() -> HttpResponseBuilder

pub fn VersionNotSupported() -> HttpResponseBuilder

pub fn VariantAlsoNegotiates() -> HttpResponseBuilder

pub fn InsufficientStorage() -> HttpResponseBuilder

pub fn LoopDetected() -> HttpResponseBuilder

pub fn NotExtended() -> HttpResponseBuilder

pub fn NetworkAuthenticationRequired() -> HttpResponseBuilder

impl HttpResponse

pub fn new(status: StatusCode) -> HttpResponse

Constructs a response.

pub fn build(status: StatusCode) -> HttpResponseBuilder

Constructs a response builder with specific HTTP status.

pub fn from_error(error: impl Into<Error>) -> HttpResponse

Create an error response.

impl<B> HttpResponse<B>

pub fn with_body(status: StatusCode, body: B) -> HttpResponse<B>

Constructs a response with body

pub fn head(&self) -> &ResponseHead

Returns a reference to response head.

pub fn head_mut(&mut self) -> &mut ResponseHead

Returns a mutable reference to response head.

pub fn error(&self) -> Option<&Error>

The source error for this response

pub fn status(&self) -> StatusCode

Get the response status code

pub fn status_mut(&mut self) -> &mut StatusCode

Set the StatusCode for this response

pub fn headers(&self) -> &HeaderMap

Get the headers from the response

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

Get a mutable reference to the headers

pub fn cookies(&self) -> CookieIter<'_>

Get an iterator for the cookies set by this response.

pub fn add_cookie(&mut self, cookie: &Cookie<'_>) -> Result<(), Error>

Add a cookie to this response.

Errors

Returns an error if the cookie results in a malformed Set-Cookie header.

pub fn add_removal_cookie(&mut self, cookie: &Cookie<'_>) -> Result<(), Error>

Add a “removal” cookie to the response that matches attributes of given cookie.

This will cause browsers/clients to remove stored cookies with this name.

The Set-Cookie header added to the response will have:

• name matching given cookie;
• domain matching given cookie;
• path matching given cookie;
• an empty value;
• a max-age of 0;
• an expiration date far in the past.

If the cookie you’re trying to remove has an explicit path or domain set, those attributes will need to be included in the cookie passed in here.

Errors

Returns an error if the given name results in a malformed Set-Cookie header.

pub fn del_cookie(&mut self, name: &str) -> usize

Remove all cookies with the given name from this response.

Returns the number of cookies removed.

This method can not cause a browser/client to delete any of its stored cookies. Its only purpose is to delete cookies that were added to this response using add_cookie and add_removal_cookie. Use add_removal_cookie to send a “removal” cookie.

pub fn upgrade(&self) -> bool

Connection upgrade status

pub fn keep_alive(&self) -> bool

Keep-alive status for this connection

pub fn extensions(&self) -> Ref<'_, Extensions>

Returns reference to the response-local data/extensions container.

pub fn extensions_mut(&mut self) -> RefMut<'_, Extensions>

Returns reference to the response-local data/extensions container.

pub fn body(&self) -> &B

Returns a reference to this response’s body.

pub fn set_body<B2>(self, body: B2) -> HttpResponse<B2>

Sets new body.

pub fn into_parts(self) -> (HttpResponse<()>, B)

Returns split head and body.

Implementation Notes

Due to internal performance optimizations, the first element of the returned tuple is an HttpResponse as well but only contains the head of the response this was called on.

pub fn drop_body(self) -> HttpResponse<()>

Drops body and returns new response.

pub fn map_body<F, B2>(self, f: F) -> HttpResponse<B2>

where F: FnOnce(&mut ResponseHead, B) -> B2,

Map the current body type to another using a closure, returning a new response.

Closure receives the response head and the current body type.

pub fn map_into_left_body<R>(self) -> HttpResponse<EitherBody<B, R>>

Map the current body type B to EitherBody::Left(B).

Useful for middleware which can generate their own responses.

pub fn map_into_right_body<L>(self) -> HttpResponse<EitherBody<L, B>>

Map the current body type B to EitherBody::Right(B).

Useful for middleware which can generate their own responses.

pub fn map_into_boxed_body(self) -> HttpResponse

where B: MessageBody + 'static,

Map the current body to a type-erased BoxBody.

pub fn into_body(self) -> B

Returns the response body, dropping all other parts.

Trait Implementations

impl<B> Debug for HttpResponse<B>

where B: MessageBody,

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

Formats the value using the given formatter.

impl From<Error> for HttpResponse

fn from(err: Error) -> HttpResponse

Converts to this type from the input type.

impl From<HttpResponseBuilder> for HttpResponse

fn from(builder: HttpResponseBuilder) -> HttpResponse

Converts to this type from the input type.

impl<B> From<Response<B>> for HttpResponse<B>

fn from(res: Response<B>) -> HttpResponse<B>

Converts to this type from the input type.

impl<B> From<ServiceResponse<B>> for HttpResponse<B>

fn from(res: ServiceResponse<B>) -> HttpResponse<B>

Converts to this type from the input type.

impl<B> Responder for HttpResponse<B>

where B: MessageBody + 'static,

type Body = B

fn respond_to( self, _: &HttpRequest, ) -> HttpResponse<<HttpResponse<B> as Responder>::Body>

Convert self to HttpResponse.

fn customize(self) -> CustomizeResponder<Self>

where Self: Sized,

Wraps responder to allow alteration of its response.