[−][src]Struct actix_web::dev::HttpResponseBuilder

pub struct HttpResponseBuilder { /* fields omitted */ }

An HTTP response builder

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

Methods

impl ResponseBuilder[src]

ⓘImportant traits for ResponseBuilder
pub fn new(status: StatusCode) -> ResponseBuilder[src]

Create response builder

ⓘImportant traits for ResponseBuilder
pub fn status(&mut self, status: StatusCode) -> &mut ResponseBuilder[src]

Set HTTP status code of this response.

ⓘImportant traits for ResponseBuilder
pub fn header<K, V>(&mut self, key: K, value: V) -> &mut ResponseBuilder where
    V: IntoHeaderValue,
    HeaderName: TryFrom<K>,
    <HeaderName as TryFrom<K>>::Error: Into<Error>, [src]

Append a header to existing headers.

use actix_http::{http, Request, Response};

fn index(req: Request) -> Response {
    Response::Ok()
        .header("X-TEST", "value")
        .header(http::header::CONTENT_TYPE, "application/json")
        .finish()
}
fn main() {}

ⓘImportant traits for ResponseBuilder
pub fn set_header<K, V>(&mut self, key: K, value: V) -> &mut ResponseBuilder where
    V: IntoHeaderValue,
    HeaderName: TryFrom<K>,
    <HeaderName as TryFrom<K>>::Error: Into<Error>, [src]

Set a header.

use actix_http::{http, Request, Response};

fn index(req: Request) -> Response {
    Response::Ok()
        .set_header("X-TEST", "value")
        .set_header(http::header::CONTENT_TYPE, "application/json")
        .finish()
}
fn main() {}

ⓘImportant traits for ResponseBuilder
pub fn reason(&mut self, reason: &'static str) -> &mut ResponseBuilder[src]

Set the custom reason for the response.

ⓘImportant traits for ResponseBuilder
pub fn keep_alive(&mut self) -> &mut ResponseBuilder[src]

Set connection type to KeepAlive

ⓘImportant traits for ResponseBuilder
pub fn upgrade<V>(&mut self, value: V) -> &mut ResponseBuilder where
    V: IntoHeaderValue, [src]

Set connection type to Upgrade

ⓘImportant traits for ResponseBuilder
pub fn force_close(&mut self) -> &mut ResponseBuilder[src]

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

ⓘImportant traits for ResponseBuilder
pub fn no_chunking(&mut self) -> &mut ResponseBuilder[src]

Disable chunked transfer encoding for HTTP/1.1 streaming responses.

ⓘImportant traits for ResponseBuilder
pub fn content_type<V>(&mut self, value: V) -> &mut ResponseBuilder where
    HeaderValue: TryFrom<V>,
    <HeaderValue as TryFrom<V>>::Error: Into<Error>, [src]

Set response content type

ⓘImportant traits for ResponseBuilder
pub fn content_length(&mut self, len: u64) -> &mut ResponseBuilder[src]

Set content length

ⓘImportant traits for ResponseBuilder
pub fn cookie(&mut self, cookie: Cookie<'c>) -> &mut ResponseBuilder[src]

Set a cookie

use actix_http::{http, Request, Response};

fn index(req: Request) -> Response {
    Response::Ok()
        .cookie(
            http::Cookie::build("name", "value")
                .domain("www.rust-lang.org")
                .path("/")
                .secure(true)
                .http_only(true)
                .finish(),
        )
        .finish()
}

Remove cookie

use actix_http::{http, Request, Response, HttpMessage};

fn index(req: Request) -> Response {
    let mut builder = Response::Ok();

    if let Some(ref cookie) = req.cookie("name") {
        builder.del_cookie(cookie);
    }

    builder.finish()
}

ⓘImportant traits for ResponseBuilder
pub fn if_true<F>(&mut self, value: bool, f: F) -> &mut ResponseBuilder where
    F: FnOnce(&mut ResponseBuilder), [src]

This method calls provided closure with builder reference if value is true.

ⓘImportant traits for ResponseBuilder
pub fn if_some<T, F>(&mut self, value: Option<T>, f: F) -> &mut ResponseBuilder where
    F: FnOnce(T, &mut ResponseBuilder), [src]

This method calls provided closure with builder reference if value is Some.

pub fn extensions(&self) -> Ref<Extensions>[src]

Responses extensions

pub fn extensions_mut(&mut self) -> RefMut<Extensions>[src]

Mutable reference to a the response's extensions

ⓘImportant traits for Response<Body>
pub fn body<B>(&mut self, body: B) -> Response<Body> where
    B: Into<Body>, [src]

Set a body and generate Response.

ResponseBuilder can not be used after this call.

ⓘImportant traits for Response<Body>
pub fn message_body<B>(&mut self, body: B) -> Response<B>[src]

Set a body and generate Response.

ResponseBuilder can not be used after this call.

ⓘImportant traits for Response<Body>
pub fn streaming<S, E>(&mut self, stream: S) -> Response<Body> where
    E: Into<Error> + 'static,
    S: Stream<Item = Result<Bytes, E>> + 'static, [src]

Set a streaming body and generate Response.

ResponseBuilder can not be used after this call.

ⓘImportant traits for Response<Body>
pub fn json<T>(&mut self, value: T) -> Response<Body> where
    T: Serialize, [src]

Set a json body and generate Response

ResponseBuilder can not be used after this call.

ⓘImportant traits for Response<Body>
pub fn json2<T>(&mut self, value: &T) -> Response<Body> where
    T: Serialize, [src]

Set a json body and generate Response

ResponseBuilder can not be used after this call.

ⓘImportant traits for Response<Body>
pub fn finish(&mut self) -> Response<Body>[src]

Set an empty body and generate Response

ResponseBuilder can not be used after this call.

ⓘImportant traits for ResponseBuilder
pub fn take(&mut self) -> ResponseBuilder[src]

This method construct new ResponseBuilder

Trait Implementations

impl Debug for ResponseBuilder[src]

impl Future for ResponseBuilder[src]

type Output = Result<Response<Body>, Error>

The type of value produced on completion.

impl<B> From<Response<B>> for ResponseBuilder[src]

Convert Response to a ResponseBuilder. Body get dropped.

impl From<ResponseBuilder> for Response<Body>[src]

impl<'a> From<&'a ResponseHead> for ResponseBuilder[src]

Convert ResponseHead to a ResponseBuilder

impl BodyEncoding for ResponseBuilder[src]

impl Responder for ResponseBuilder[src]

type Error = Error

The associated error which can be returned.

type Future = Ready<Result<Response, Error>>

The future response value.

Auto Trait Implementations

Blanket Implementations

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, [src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, [src]

type Error = !

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, [src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized, [src]

impl<T> BorrowMut<T> for T where
    T: ?Sized, [src]

impl<T> Any for T where
    T: 'static + ?Sized, [src]

impl<T> FutureExt for T where
    T: Future + ?Sized, [src]

impl<F, T, E> TryFuture for F where
    F: Future<Output = Result<T, E>> + ?Sized, [src]

type Ok = T

The type of successful values yielded by this future

type Error = E

The type of failures yielded by this future

impl<Fut> TryFutureExt for Fut where
    Fut: TryFuture + ?Sized, [src]

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,