1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
use error;
use response::{Context, Serializer};
use util::BufStream;

use bytes::Buf;
use http;

/// Types that can be returned from resources as responses to HTTP requests.
///
/// Implementations of `Response` are responsible for encoding the value using
/// the appropriate content type. The content type may be specific to the type
/// in question, for example `serde_json::Value` implies a content type of
/// `application/json`.
///
/// Alternatively, the provided `context` may be used to encode the response in
/// most suitable content-type based on the request context. The content-type is
/// picked using the following factors:
///
/// * The HTTP request's `Accept` header value (not yet implemented).
/// * Any content type specified by the resource using annotations.
/// * Serialization formats that the application made available to the resource.
///
/// Implementations of `Response` are able to asynchronously stream the response
/// body if needed. This is done by setting the HTTP response body to a
/// `BufStream` type that supports streaming.
pub trait Response {
    /// Data chunk type.
    type Buf: Buf;

    /// The HTTP response body type.
    type Body: BufStream<Item = Self::Buf, Error = ::Error>;

    /// Convert the value into a response future
    fn into_http<S: Serializer>(self, context: &Context<S>) -> Result<http::Response<Self::Body>, ::Error>;
}

impl<T> Response for http::Response<T>
where T: BufStream,
{
    type Buf = T::Item;
    type Body = error::Map<T>;

    fn into_http<S: Serializer>(self, _: &Context<S>) -> Result<http::Response<Self::Body>, ::Error> {
        Ok(self.map(error::Map::new))
    }
}

impl<R, E> Response for Result<R, E>
where R: Response,
      E: Into<::Error>,
{
    type Buf = R::Buf;
    type Body = R::Body;

    fn into_http<S: Serializer>(self, context: &Context<S>) -> Result<http::Response<Self::Body>, ::Error> {
        self.map_err(|err| err.into()).and_then(|resp| resp.into_http(context))
    }
}