use std::rc::Rc; use std::cell::RefCell; use std::marker::PhantomData; use actix::Actor; use http::{header, Version}; use futures::Stream; use task::{Task, DrainFut, IoContext}; use body::Binary; use error::{Error, ExpectError, Result}; use context::HttpContext; use httprequest::HttpRequest; use httpresponse::HttpResponse; #[doc(hidden)] #[derive(Debug)] pub enum Frame { Message(HttpResponse), Payload(Option), Drain(Rc>), } impl Frame { pub fn eof() -> Frame { Frame::Payload(None) } } /// Trait defines object that could be regestered as resource route #[allow(unused_variables)] pub trait RouteHandler: 'static { /// Handle request fn handle(&self, req: HttpRequest, task: &mut Task); /// Set route prefix fn set_prefix(&mut self, prefix: String) {} } /// Actors with ability to handle http requests. #[allow(unused_variables)] pub trait Route: Actor { /// Shared state. State is shared with all routes within same application /// and could be accessed with `HttpRequest::state()` method. type State; /// Handle `EXPECT` header. By default respones with `HTTP/1.1 100 Continue` fn expect(req: &mut HttpRequest, ctx: &mut Self::Context) -> Result<()> where Self: Actor> { // handle expect header only for HTTP/1.1 if req.version() == Version::HTTP_11 { if let Some(expect) = req.headers().get(header::EXPECT) { if let Ok(expect) = expect.to_str() { if expect.to_lowercase() == "100-continue" { ctx.write("HTTP/1.1 100 Continue\r\n\r\n"); Ok(()) } else { Err(ExpectError::UnknownExpect.into()) } } else { Err(ExpectError::Encoding.into()) } } else { Ok(()) } } else { Ok(()) } } /// Handle incoming request. Route actor can return /// result immediately with `Reply::reply`. /// Actor itself can be returned with `Reply::stream` for handling streaming /// request/response or websocket connection. /// In that case `HttpContext::start` and `HttpContext::write` has to be used /// for writing response. fn request(req: HttpRequest, ctx: Self::Context) -> Result; /// This method creates `RouteFactory` for this actor. fn factory() -> RouteFactory { RouteFactory(PhantomData) } } /// This is used for routes registration within `Resource` pub struct RouteFactory, S>(PhantomData); impl RouteHandler for RouteFactory where A: Actor> + Route, S: 'static { fn handle(&self, mut req: HttpRequest, task: &mut Task) { let mut ctx = HttpContext::new(req.clone_state()); // handle EXPECT header if req.headers().contains_key(header::EXPECT) { if let Err(resp) = A::expect(&mut req, &mut ctx) { task.reply(resp) } } match A::request(req, ctx) { Ok(reply) => reply.into(task), Err(err) => task.reply(err), } } } /// Fn() route handler pub(crate) struct FnHandler where F: Fn(HttpRequest) -> R + 'static, R: Into, S: 'static, { f: Box, s: PhantomData, } impl FnHandler where F: Fn(HttpRequest) -> R + 'static, R: Into + 'static, S: 'static, { pub fn new(f: F) -> Self { FnHandler{f: Box::new(f), s: PhantomData} } } impl RouteHandler for FnHandler where F: Fn(HttpRequest) -> R + 'static, R: Into + 'static, S: 'static, { fn handle(&self, req: HttpRequest, task: &mut Task) { task.reply((self.f)(req).into()) } } /// Async route handler pub(crate) struct StreamHandler where F: Fn(HttpRequest) -> R + 'static, R: Stream + 'static, S: 'static, { f: Box, s: PhantomData, } impl StreamHandler where F: Fn(HttpRequest) -> R + 'static, R: Stream + 'static, S: 'static, { pub fn new(f: F) -> Self { StreamHandler{f: Box::new(f), s: PhantomData} } } impl RouteHandler for StreamHandler where F: Fn(HttpRequest) -> R + 'static, R: Stream + 'static, S: 'static, { fn handle(&self, req: HttpRequest, task: &mut Task) { task.stream((self.f)(req)) } } enum ReplyItem { Message(HttpResponse), Actor(Box>), Stream(Box>), } /// Represents response process. pub struct Reply(ReplyItem); impl Reply { /// Create actor response pub(crate) fn async(ctx: C) -> Result { Ok(Reply(ReplyItem::Actor(Box::new(ctx)))) } /// Create async response pub fn stream(stream: S) -> Result where S: Stream + 'static { Ok(Reply(ReplyItem::Stream(Box::new(stream)))) } /// Send response pub fn reply>(response: R) -> Result { Ok(Reply(ReplyItem::Message(response.into()))) } pub fn into(self, task: &mut Task) { match self.0 { ReplyItem::Message(msg) => { task.reply(msg) }, ReplyItem::Actor(ctx) => { task.context(ctx) } ReplyItem::Stream(stream) => { task.stream(stream) } } } } impl From for Reply where T: Into { fn from(item: T) -> Self { Reply(ReplyItem::Message(item.into())) } }