use std::cell::RefCell; use std::marker::PhantomData; use std::rc::Rc; use actix_http::body::{Body, MessageBody}; use actix_http::{Extensions, PayloadStream, Request, Response}; use actix_router::{Path, ResourceDef, ResourceInfo, Router, Url}; use actix_service::boxed::{self, BoxedNewService, BoxedService}; use actix_service::{ AndThenNewService, ApplyNewService, IntoNewService, IntoNewTransform, NewService, NewTransform, Service, }; use futures::future::{ok, Either, FutureResult}; use futures::{Async, Future, IntoFuture, Poll}; use crate::resource::Resource; use crate::service::{ServiceRequest, ServiceResponse}; use crate::state::{State, StateFactory, StateFactoryResult}; type HttpService

= BoxedService, ServiceResponse, ()>; type HttpNewService

= BoxedNewService<(), ServiceRequest

, ServiceResponse, (), ()>; type BoxedResponse = Box>; pub trait HttpServiceFactory { type Factory: NewService; fn rdef(&self) -> &ResourceDef; fn create(self) -> Self::Factory; } /// Application builder - structure that follows the builder pattern /// for building application instances. pub struct App where T: NewService, Response = ServiceRequest

>, { chain: T, extensions: Extensions, state: Vec>, _t: PhantomData<(P,)>, } impl App { /// Create application builder with empty state. Application can /// be configured with a builder-like pattern. pub fn new() -> Self { App { chain: AppChain, extensions: Extensions::new(), state: Vec::new(), _t: PhantomData, } } } impl App where P: 'static, T: NewService< Request = ServiceRequest, Response = ServiceRequest

, Error = (), InitError = (), >, { /// Set application state. Applicatin state could be accessed /// by using `State` extractor where `T` is state type. /// /// **Note**: http server accepts an application factory rather than /// an application instance. Http server constructs an application /// instance for each thread, thus application state must be constructed /// multiple times. If you want to share state between different /// threads, a shared object should be used, e.g. `Arc`. Application /// state does not need to be `Send` or `Sync`. /// /// ```rust /// use std::cell::Cell; /// use actix_web::{web, State, App}; /// /// struct MyState { /// counter: Cell, /// } /// /// fn index(state: State) { /// state.counter.set(state.counter.get() + 1); /// } /// /// fn main() { /// let app = App::new() /// .state(MyState{ counter: Cell::new(0) }) /// .resource( /// "/index.html", /// |r| r.route(web::get().to(index))); /// } /// ``` pub fn state(mut self, state: S) -> Self { self.state.push(Box::new(State::new(state))); self } /// Set application state factory. This function is /// similar to `.state()` but it accepts state factory. State get /// constructed asynchronously during application initialization. pub fn state_factory(mut self, state: F) -> Self where F: Fn() -> Out + 'static, Out: IntoFuture + 'static, Out::Error: std::fmt::Debug, { self.state.push(Box::new(State::new(state))); self } /// Configure resource for a specific path. /// /// Resources may have variable path segments. For example, a /// resource with the path `/a/{name}/c` would match all incoming /// requests with paths such as `/a/b/c`, `/a/1/c`, or `/a/etc/c`. /// /// A variable segment is specified in the form `{identifier}`, /// where the identifier can be used later in a request handler to /// access the matched value for that segment. This is done by /// looking up the identifier in the `Params` object returned by /// `HttpRequest.match_info()` method. /// /// By default, each segment matches the regular expression `[^{}/]+`. /// /// You can also specify a custom regex in the form `{identifier:regex}`: /// /// For instance, to route `GET`-requests on any route matching /// `/users/{userid}/{friend}` and store `userid` and `friend` in /// the exposed `Params` object: /// /// ```rust /// # extern crate actix_web; /// use actix_web::{web, http, App, HttpResponse}; /// /// fn main() { /// let app = App::new().resource("/users/{userid}/{friend}", |r| { /// r.route(web::get().to(|| HttpResponse::Ok())) /// .route(web::head().to(|| HttpResponse::MethodNotAllowed())) /// }); /// } /// ``` pub fn resource(self, path: &str, f: F) -> AppRouter> where F: FnOnce(Resource

) -> Resource, U: NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), > + 'static, { let rdef = ResourceDef::new(path); let resource = f(Resource::new()); let default = resource.get_default(); let fref = Rc::new(RefCell::new(None)); AppRouter { chain: self.chain, services: vec![(rdef, boxed::new_service(resource.into_new_service()))], default: None, defaults: vec![default], endpoint: AppEntry::new(fref.clone()), factory_ref: fref, extensions: self.extensions, state: self.state, _t: PhantomData, } } /// Register a middleware. pub fn middleware( self, mw: F, ) -> AppRouter< T, P, B, impl NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), >, > where M: NewTransform< AppRouting

, Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), >, F: IntoNewTransform>, { let fref = Rc::new(RefCell::new(None)); let endpoint = ApplyNewService::new(mw, AppEntry::new(fref.clone())); AppRouter { endpoint, chain: self.chain, state: self.state, services: Vec::new(), default: None, defaults: Vec::new(), factory_ref: fref, extensions: self.extensions, _t: PhantomData, } } /// Register a request modifier. It can modify any request parameters /// including payload stream. pub fn chain( self, chain: C, ) -> App< P1, impl NewService< Request = ServiceRequest, Response = ServiceRequest, Error = (), InitError = (), >, > where C: NewService< (), Request = ServiceRequest

, Response = ServiceRequest, Error = (), InitError = (), >, F: IntoNewService, { let chain = self.chain.and_then(chain.into_new_service()); App { chain, state: self.state, extensions: self.extensions, _t: PhantomData, } } } /// Application router builder - Structure that follows the builder pattern /// for building application instances. pub struct AppRouter { chain: C, services: Vec<(ResourceDef, HttpNewService

)>, default: Option>>, defaults: Vec>>>>>, endpoint: T, factory_ref: Rc>>>, extensions: Extensions, state: Vec>, _t: PhantomData<(P, B)>, } impl AppRouter where P: 'static, B: MessageBody, T: NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), >, { /// Configure resource for a specific path. /// /// Resources may have variable path segments. For example, a /// resource with the path `/a/{name}/c` would match all incoming /// requests with paths such as `/a/b/c`, `/a/1/c`, or `/a/etc/c`. /// /// A variable segment is specified in the form `{identifier}`, /// where the identifier can be used later in a request handler to /// access the matched value for that segment. This is done by /// looking up the identifier in the `Params` object returned by /// `HttpRequest.match_info()` method. /// /// By default, each segment matches the regular expression `[^{}/]+`. /// /// You can also specify a custom regex in the form `{identifier:regex}`: /// /// For instance, to route `GET`-requests on any route matching /// `/users/{userid}/{friend}` and store `userid` and `friend` in /// the exposed `Params` object: /// /// ```rust /// use actix_web::{web, http, App, HttpResponse}; /// /// fn main() { /// let app = App::new() /// .resource("/users/{userid}/{friend}", |r| { /// r.route(web::to(|| HttpResponse::Ok())) /// }) /// .resource("/index.html", |r| { /// r.route(web::head().to(|| HttpResponse::MethodNotAllowed())) /// }); /// } /// ``` pub fn resource(mut self, path: &str, f: F) -> Self where F: FnOnce(Resource

) -> Resource, U: NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), > + 'static, { let rdef = ResourceDef::new(path); let resource = f(Resource::new()); self.defaults.push(resource.get_default()); self.services .push((rdef, boxed::new_service(resource.into_new_service()))); self } /// Default resource to be used if no matching route could be found. /// /// Default resource works with resources only and does not work with /// custom services. pub fn default_resource(mut self, f: F) -> Self where F: FnOnce(Resource

) -> R, R: IntoNewService, U: NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), > + 'static, { // create and configure default resource self.default = Some(Rc::new(boxed::new_service( f(Resource::new()).into_new_service().map_init_err(|_| ()), ))); self } /// Register resource handler service. pub fn service(mut self, rdef: R, factory: F) -> Self where R: Into, F: IntoNewService, U: NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), > + 'static, { self.services.push(( rdef.into(), boxed::new_service(factory.into_new_service().map_init_err(|_| ())), )); self } /// Register a middleware. pub fn middleware( self, mw: F, ) -> AppRouter< C, P, B1, impl NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), >, > where M: NewTransform< T::Service, Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), >, B1: MessageBody, F: IntoNewTransform, { let endpoint = ApplyNewService::new(mw, self.endpoint); AppRouter { endpoint, chain: self.chain, state: self.state, services: self.services, default: self.default, defaults: self.defaults, factory_ref: self.factory_ref, extensions: self.extensions, _t: PhantomData, } } /// Register an external resource. /// /// External resources are useful for URL generation purposes only /// and are never considered for matching at request time. Calls to /// `HttpRequest::url_for()` will work as expected. /// /// ```rust,ignore /// # extern crate actix_web; /// use actix_web::{App, HttpRequest, HttpResponse, Result}; /// /// fn index(req: &HttpRequest) -> Result { /// let url = req.url_for("youtube", &["oHg5SJYRHA0"])?; /// assert_eq!(url.as_str(), "https://youtube.com/watch/oHg5SJYRHA0"); /// Ok(HttpResponse::Ok().into()) /// } /// /// fn main() { /// let app = App::new() /// .resource("/index.html", |r| r.get().f(index)) /// .external_resource("youtube", "https://youtube.com/watch/{video_id}") /// .finish(); /// } /// ``` pub fn external_resource(self, _name: N, _url: U) -> Self where N: AsRef, U: AsRef, { // self.parts // .as_mut() // .expect("Use after finish") // .router // .register_external(name.as_ref(), ResourceDef::external(url.as_ref())); self } } impl IntoNewService, T, ()>> for AppRouter where T: NewService< Request = ServiceRequest

, Response = ServiceResponse, Error = (), InitError = (), >, C: NewService< Request = ServiceRequest, Response = ServiceRequest

, Error = (), InitError = (), >, { fn into_new_service(self) -> AndThenNewService, T, ()> { // update resource default service if self.default.is_some() { for default in &self.defaults { if default.borrow_mut().is_none() { *default.borrow_mut() = self.default.clone(); } } } // set factory *self.factory_ref.borrow_mut() = Some(AppRoutingFactory { services: Rc::new(self.services), }); AppInit { chain: self.chain, state: self.state, extensions: Rc::new(RefCell::new(Rc::new(self.extensions))), } .and_then(self.endpoint) } } pub struct AppRoutingFactory

{ services: Rc)>>, } impl NewService for AppRoutingFactory

{ type Request = ServiceRequest

; type Response = ServiceResponse; type Error = (); type InitError = (); type Service = AppRouting

; type Future = AppRoutingFactoryResponse

; fn new_service(&self, _: &()) -> Self::Future { AppRoutingFactoryResponse { fut: self .services .iter() .map(|(path, service)| { CreateAppRoutingItem::Future( Some(path.clone()), service.new_service(&()), ) }) .collect(), } } } type HttpServiceFut

= Box, Error = ()>>; /// Create app service #[doc(hidden)] pub struct AppRoutingFactoryResponse

{ fut: Vec>, } enum CreateAppRoutingItem

{ Future(Option, HttpServiceFut

), Service(ResourceDef, HttpService

), } impl

Future for AppRoutingFactoryResponse

{ type Item = AppRouting

; type Error = (); fn poll(&mut self) -> Poll { let mut done = true; // poll http services for item in &mut self.fut { let res = match item { CreateAppRoutingItem::Future(ref mut path, ref mut fut) => { match fut.poll()? { Async::Ready(service) => Some((path.take().unwrap(), service)), Async::NotReady => { done = false; None } } } CreateAppRoutingItem::Service(_, _) => continue, }; if let Some((path, service)) = res { *item = CreateAppRoutingItem::Service(path, service); } } if done { let router = self .fut .drain(..) .fold(Router::build(), |mut router, item| { match item { CreateAppRoutingItem::Service(path, service) => { router.rdef(path, service) } CreateAppRoutingItem::Future(_, _) => unreachable!(), } router }); Ok(Async::Ready(AppRouting { router: router.finish(), ready: None, })) } else { Ok(Async::NotReady) } } } pub struct AppRouting

{ router: Router>, ready: Option<(ServiceRequest

, ResourceInfo)>, } impl

Service for AppRouting

{ type Request = ServiceRequest

; type Response = ServiceResponse; type Error = (); type Future = Either>; fn poll_ready(&mut self) -> Poll<(), Self::Error> { if self.ready.is_none() { Ok(Async::Ready(())) } else { Ok(Async::NotReady) } } fn call(&mut self, mut req: ServiceRequest

) -> Self::Future { if let Some((srv, _info)) = self.router.recognize_mut(req.match_info_mut()) { Either::A(srv.call(req)) } else { let req = req.into_request(); Either::B(ok(ServiceResponse::new(req, Response::NotFound().finish()))) } } } #[doc(hidden)] /// Wrapper service for routing pub struct AppEntry

{ factory: Rc>>>, } impl

AppEntry

{ fn new(factory: Rc>>>) -> Self { AppEntry { factory } } } impl NewService for AppEntry

{ type Request = ServiceRequest

; type Response = ServiceResponse; type Error = (); type InitError = (); type Service = AppRouting

; type Future = AppRoutingFactoryResponse

; fn new_service(&self, _: &()) -> Self::Future { self.factory.borrow_mut().as_mut().unwrap().new_service(&()) } } #[doc(hidden)] pub struct AppChain; impl NewService<()> for AppChain { type Request = ServiceRequest; type Response = ServiceRequest; type Error = (); type InitError = (); type Service = AppChain; type Future = FutureResult; fn new_service(&self, _: &()) -> Self::Future { ok(AppChain) } } impl Service for AppChain { type Request = ServiceRequest; type Response = ServiceRequest; type Error = (); type Future = FutureResult; #[inline] fn poll_ready(&mut self) -> Poll<(), Self::Error> { Ok(Async::Ready(())) } #[inline] fn call(&mut self, req: Self::Request) -> Self::Future { ok(req) } } /// Service factory to convert `Request` to a `ServiceRequest`. /// It also executes state factories. pub struct AppInit where C: NewService, Response = ServiceRequest

>, { chain: C, state: Vec>, extensions: Rc>>, } impl NewService for AppInit where C: NewService< Request = ServiceRequest, Response = ServiceRequest

, InitError = (), >, { type Request = Request; type Response = ServiceRequest

; type Error = C::Error; type InitError = C::InitError; type Service = AppInitService; type Future = AppInitResult; fn new_service(&self, _: &()) -> Self::Future { AppInitResult { chain: self.chain.new_service(&()), state: self.state.iter().map(|s| s.construct()).collect(), extensions: self.extensions.clone(), } } } #[doc(hidden)] pub struct AppInitResult where C: NewService< Request = ServiceRequest, Response = ServiceRequest

, InitError = (), >, { chain: C::Future, state: Vec>, extensions: Rc>>, } impl Future for AppInitResult where C: NewService< Request = ServiceRequest, Response = ServiceRequest

, InitError = (), >, { type Item = AppInitService; type Error = C::InitError; fn poll(&mut self) -> Poll { if let Some(extensions) = Rc::get_mut(&mut *self.extensions.borrow_mut()) { let mut idx = 0; while idx < self.state.len() { if let Async::Ready(_) = self.state[idx].poll_result(extensions)? { self.state.remove(idx); } else { idx += 1; } } if !self.state.is_empty() { return Ok(Async::NotReady); } } else { log::warn!("Multiple copies of app extensions exists"); } let chain = futures::try_ready!(self.chain.poll()); Ok(Async::Ready(AppInitService { chain, extensions: self.extensions.borrow().clone(), })) } } /// Service to convert `Request` to a `ServiceRequest` pub struct AppInitService where C: Service, Response = ServiceRequest

>, { chain: C, extensions: Rc, } impl Service for AppInitService where C: Service, Response = ServiceRequest

>, { type Request = Request; type Response = ServiceRequest

; type Error = C::Error; type Future = C::Future; fn poll_ready(&mut self) -> Poll<(), Self::Error> { self.chain.poll_ready() } fn call(&mut self, req: Request) -> Self::Future { let req = ServiceRequest::new( Path::new(Url::new(req.uri().clone())), req, self.extensions.clone(), ); self.chain.call(req) } }