use actix_http::error::InternalError; use actix_http::{dev::ResponseBuilder, http::StatusCode, Error, Response}; use bytes::{Bytes, BytesMut}; use futures::future::{err, ok, Either as EitherFuture, FutureResult}; use futures::{Future, IntoFuture, Poll}; use crate::request::HttpRequest; /// Trait implemented by types that can be converted to a http response. /// /// Types that implement this trait can be used as the return type of a handler. pub trait Responder { /// The associated error which can be returned. type Error: Into; /// The future response value. type Future: IntoFuture; /// Convert itself to `AsyncResult` or `Error`. fn respond_to(self, req: &HttpRequest) -> Self::Future; } impl Responder for Response { type Error = Error; type Future = FutureResult; #[inline] fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(self) } } impl Responder for Option where T: Responder, { type Error = T::Error; type Future = EitherFuture< ::Future, FutureResult, >; fn respond_to(self, req: &HttpRequest) -> Self::Future { match self { Some(t) => EitherFuture::A(t.respond_to(req).into_future()), None => EitherFuture::B(ok(Response::build(StatusCode::NOT_FOUND).finish())), } } } impl Responder for Result where T: Responder, E: Into, { type Error = Error; type Future = EitherFuture< ResponseFuture<::Future>, FutureResult, >; fn respond_to(self, req: &HttpRequest) -> Self::Future { match self { Ok(val) => { EitherFuture::A(ResponseFuture::new(val.respond_to(req).into_future())) } Err(e) => EitherFuture::B(err(e.into())), } } } impl Responder for ResponseBuilder { type Error = Error; type Future = FutureResult; #[inline] fn respond_to(mut self, _: &HttpRequest) -> Self::Future { ok(self.finish()) } } impl Responder for () { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK).finish()) } } impl Responder for &'static str { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK) .content_type("text/plain; charset=utf-8") .body(self)) } } impl Responder for &'static [u8] { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK) .content_type("application/octet-stream") .body(self)) } } impl Responder for String { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK) .content_type("text/plain; charset=utf-8") .body(self)) } } impl<'a> Responder for &'a String { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK) .content_type("text/plain; charset=utf-8") .body(self)) } } impl Responder for Bytes { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK) .content_type("application/octet-stream") .body(self)) } } impl Responder for BytesMut { type Error = Error; type Future = FutureResult; fn respond_to(self, _: &HttpRequest) -> Self::Future { ok(Response::build(StatusCode::OK) .content_type("application/octet-stream") .body(self)) } } /// Combines two different responder types into a single type /// /// ```rust /// # use futures::future::{ok, Future}; /// use actix_web::{Either, Error, HttpResponse}; /// /// type RegisterResult = /// Either>>; /// /// fn index() -> RegisterResult { /// if is_a_variant() { /// // <- choose left variant /// Either::A(HttpResponse::BadRequest().body("Bad data")) /// } else { /// Either::B( /// // <- Right variant /// Box::new(ok(HttpResponse::Ok() /// .content_type("text/html") /// .body("Hello!"))) /// ) /// } /// } /// # fn is_a_variant() -> bool { true } /// # fn main() {} /// ``` #[derive(Debug, PartialEq)] pub enum Either { /// First branch of the type A(A), /// Second branch of the type B(B), } impl Responder for Either where A: Responder, B: Responder, { type Error = Error; type Future = EitherResponder< ::Future, ::Future, >; fn respond_to(self, req: &HttpRequest) -> Self::Future { match self { Either::A(a) => EitherResponder::A(a.respond_to(req).into_future()), Either::B(b) => EitherResponder::B(b.respond_to(req).into_future()), } } } pub enum EitherResponder where A: Future, A::Error: Into, B: Future, B::Error: Into, { A(A), B(B), } impl Future for EitherResponder where A: Future, A::Error: Into, B: Future, B::Error: Into, { type Item = Response; type Error = Error; fn poll(&mut self) -> Poll { match self { EitherResponder::A(ref mut fut) => Ok(fut.poll().map_err(|e| e.into())?), EitherResponder::B(ref mut fut) => Ok(fut.poll().map_err(|e| e.into())?), } } } impl Responder for Box> where I: Responder + 'static, E: Into + 'static, { type Error = Error; type Future = Box>; #[inline] fn respond_to(self, req: &HttpRequest) -> Self::Future { let req = req.clone(); Box::new( self.map_err(|e| e.into()) .and_then(move |r| ResponseFuture(r.respond_to(&req).into_future())), ) } } impl Responder for InternalError where T: std::fmt::Debug + std::fmt::Display + 'static, { type Error = Error; type Future = Result; fn respond_to(self, _: &HttpRequest) -> Self::Future { let err: Error = self.into(); Ok(err.into()) } } pub struct ResponseFuture(T); impl ResponseFuture { pub fn new(fut: T) -> Self { ResponseFuture(fut) } } impl Future for ResponseFuture where T: Future, T::Error: Into, { type Item = Response; type Error = Error; fn poll(&mut self) -> Poll { Ok(self.0.poll().map_err(|e| e.into())?) } } #[cfg(test)] mod tests { use actix_service::Service; use bytes::{Bytes, BytesMut}; use super::*; use crate::dev::{Body, ResponseBody}; use crate::http::{header::CONTENT_TYPE, HeaderValue, StatusCode}; use crate::test::{block_on, init_service, TestRequest}; use crate::{error, web, App, HttpResponse}; #[test] fn test_option_responder() { let mut srv = init_service( App::new() .service(web::resource("/none").to(|| -> Option<&'static str> { None })) .service(web::resource("/some").to(|| Some("some"))), ); let req = TestRequest::with_uri("/none").to_request(); let resp = TestRequest::block_on(srv.call(req)).unwrap(); assert_eq!(resp.status(), StatusCode::NOT_FOUND); let req = TestRequest::with_uri("/some").to_request(); let resp = TestRequest::block_on(srv.call(req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); match resp.body() { ResponseBody::Body(Body::Bytes(ref b)) => { let bytes: Bytes = b.clone().into(); assert_eq!(bytes, Bytes::from_static(b"some")); } _ => panic!(), } } trait BodyTest { fn bin_ref(&self) -> &[u8]; fn body(&self) -> &Body; } impl BodyTest for ResponseBody { fn bin_ref(&self) -> &[u8] { match self { ResponseBody::Body(ref b) => match b { Body::Bytes(ref bin) => &bin, _ => panic!(), }, ResponseBody::Other(ref b) => match b { Body::Bytes(ref bin) => &bin, _ => panic!(), }, } } fn body(&self) -> &Body { match self { ResponseBody::Body(ref b) => b, ResponseBody::Other(ref b) => b, } } } #[test] fn test_responder() { let req = TestRequest::default().to_http_request(); let resp: HttpResponse = block_on(().respond_to(&req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); assert_eq!(*resp.body().body(), Body::Empty); let resp: HttpResponse = block_on("test".respond_to(&req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); assert_eq!(resp.body().bin_ref(), b"test"); assert_eq!( resp.headers().get(CONTENT_TYPE).unwrap(), HeaderValue::from_static("text/plain; charset=utf-8") ); let resp: HttpResponse = block_on(b"test".respond_to(&req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); assert_eq!(resp.body().bin_ref(), b"test"); assert_eq!( resp.headers().get(CONTENT_TYPE).unwrap(), HeaderValue::from_static("application/octet-stream") ); let resp: HttpResponse = block_on("test".to_string().respond_to(&req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); assert_eq!(resp.body().bin_ref(), b"test"); assert_eq!( resp.headers().get(CONTENT_TYPE).unwrap(), HeaderValue::from_static("text/plain; charset=utf-8") ); let resp: HttpResponse = block_on(Bytes::from_static(b"test").respond_to(&req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); assert_eq!(resp.body().bin_ref(), b"test"); assert_eq!( resp.headers().get(CONTENT_TYPE).unwrap(), HeaderValue::from_static("application/octet-stream") ); let resp: HttpResponse = block_on(BytesMut::from(b"test".as_ref()).respond_to(&req)).unwrap(); assert_eq!(resp.status(), StatusCode::OK); assert_eq!(resp.body().bin_ref(), b"test"); assert_eq!( resp.headers().get(CONTENT_TYPE).unwrap(), HeaderValue::from_static("application/octet-stream") ); let resp: HttpResponse = error::InternalError::new("err", StatusCode::BAD_REQUEST) .respond_to(&req) .unwrap(); assert_eq!(resp.status(), StatusCode::BAD_REQUEST); } }