Struct uiuifree_actix_web_util::HttpResponseBuilder

pub struct HttpResponseBuilder { /* private fields */ }

An HTTP response builder.

This type can be used to construct an instance of Response through a builder-like pattern.

Implementations

impl HttpResponseBuilder

pub fn new(status: StatusCode) -> HttpResponseBuilder

Create response builder

pub fn status(&mut self, status: StatusCode) -> &mut HttpResponseBuilder

Set HTTP status code of this response.

pub fn insert_header(
    &mut self,
    header: impl TryIntoHeaderPair
) -> &mut HttpResponseBuilder

Insert a header, replacing any that were set with an equivalent field name.

use actix_web::{HttpResponse, http::header};

HttpResponse::Ok()
    .insert_header(header::ContentType(mime::APPLICATION_JSON))
    .insert_header(("X-TEST", "value"))
    .finish();

pub fn append_header(
    &mut self,
    header: impl TryIntoHeaderPair
) -> &mut HttpResponseBuilder

Append a header, keeping any that were set with an equivalent field name.

use actix_web::{HttpResponse, http::header};

HttpResponse::Ok()
    .append_header(header::ContentType(mime::APPLICATION_JSON))
    .append_header(("X-TEST", "value1"))
    .append_header(("X-TEST", "value2"))
    .finish();

pub fn reason(&mut self, reason: &'static str) -> &mut HttpResponseBuilder

Set the custom reason for the response.

pub fn keep_alive(&mut self) -> &mut HttpResponseBuilder

Set connection type to KeepAlive

pub fn upgrade<V>(&mut self, value: V) -> &mut HttpResponseBuilder where
    V: TryIntoHeaderValue, 

Set connection type to Upgrade

pub fn force_close(&mut self) -> &mut HttpResponseBuilder

Force close connection, even if it is marked as keep-alive

pub fn no_chunking(&mut self, len: u64) -> &mut HttpResponseBuilder

Disable chunked transfer encoding for HTTP/1.1 streaming responses.

pub fn content_type<V>(&mut self, value: V) -> &mut HttpResponseBuilder where
    V: TryIntoHeaderValue, 

Set response content type.

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

Add a cookie to the response.

To send a “removal” cookie, call .make_removal() on the given cookie. See HttpResponse::add_removal_cookie() to learn more.

Examples

Send a new cookie:

use actix_web::{HttpResponse, cookie::Cookie};

let res = HttpResponse::Ok()
    .cookie(
        Cookie::build("name", "value")
            .domain("www.rust-lang.org")
            .path("/")
            .secure(true)
            .http_only(true)
            .finish(),
    )
    .finish();

Send a removal cookie:

use actix_web::{HttpResponse, cookie::Cookie};

// the name, domain and path match the cookie created in the previous example
let mut cookie = Cookie::build("name", "value-does-not-matter")
    .domain("www.rust-lang.org")
    .path("/")
    .finish();
cookie.make_removal();

let res = HttpResponse::Ok()
    .cookie(cookie)
    .finish();

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

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

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

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

pub fn body<B>(&mut self, body: B) -> HttpResponse<BoxBody> where
    B: 'static + MessageBody, 

Set a body and build the HttpResponse.

Unlike message_body, errors are converted into error responses immediately.

HttpResponseBuilder can not be used after this call.

pub fn message_body<B>(&mut self, body: B) -> Result<HttpResponse<B>, Error>

Set a body and build the HttpResponse.

HttpResponseBuilder can not be used after this call.

pub fn streaming<S, E>(&mut self, stream: S) -> HttpResponse<BoxBody> where
    S: 'static + Stream<Item = Result<Bytes, E>>,
    E: 'static + Into<Box<dyn Error + 'static, Global>>, 

Set a streaming body and build the HttpResponse.

HttpResponseBuilder can not be used after this call.

pub fn json(&mut self, value: impl Serialize) -> HttpResponse<BoxBody>

Set a JSON body and build the HttpResponse.

HttpResponseBuilder can not be used after this call.

pub fn finish(&mut self) -> HttpResponse<BoxBody>

Set an empty body and build the HttpResponse.

HttpResponseBuilder can not be used after this call.

pub fn take(&mut self) -> HttpResponseBuilder

This method construct new HttpResponseBuilder

Trait Implementations

impl From<HttpResponseBuilder> for HttpResponse<BoxBody>

fn from(builder: HttpResponseBuilder) -> HttpResponse<BoxBody>

Converts to this type from the input type.

impl From<HttpResponseBuilder> for Response<BoxBody>

fn from(builder: HttpResponseBuilder) -> Response<BoxBody>

Converts to this type from the input type.

impl Future for HttpResponseBuilder

type Output = Result<HttpResponse<BoxBody>, Error>

The type of value produced on completion.

fn poll(
    self: Pin<&mut HttpResponseBuilder>,
    &mut Context<'_>
) -> Poll<<HttpResponseBuilder as Future>::Output>

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.

impl Responder for HttpResponseBuilder

type Body = BoxBody

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

Convert self to HttpResponse.

fn customize(self) -> CustomizeResponder<Self>

Wraps responder to allow alteration of its response.