miko 0.9.0

A web framework for Rust
Documentation
#![allow(non_snake_case)]
use crate::extractor::from_request::{FRFut, FRPFut, FromRequest, FromRequestParts};
use crate::http::response::into_response::IntoResponse;
use hyper::http::request::Parts;
use std::convert::Infallible;
use std::marker::PhantomData;
use std::pin::Pin;
use std::sync::Arc;
use std::task::{Context, Poll};
use tower::Service;
use tower::util::BoxCloneService;

pub use miko_core::{Req, Resp, RespBody};
/// 通用处理器接口(由框架自动为函数实现)
pub trait Handler: Send + Sync + 'static {
    fn call(&self, req: Req) -> Pin<Box<dyn Future<Output = Resp> + Send>>;
}

impl<F, Fut, Res> Handler for F
where
    F: Fn(Req) -> Fut + Send + Sync + 'static,
    Fut: Future<Output = Res> + Send + 'static,
    Res: IntoResponse,
{
    fn call(&self, req: Req) -> Pin<Box<dyn Future<Output = Resp> + Send>> {
        let fut = self(req);
        Box::pin(async move { fut.await.into_response() })
    }
}

macro_rules! impl_fn_once_tuple {
  ($($name:ident),+) => {
      impl<F, R, $($name,)+> FnOnceTuple<($($name,)+)> for F
      where
          F: FnOnce($($name),+) -> R,
      {
          type Output = R;
          fn call(self, ($($name,)+): ($($name,)+)) -> R {
              self($($name),+)
          }
      }
  };
}
/// 用于以元组方式调用 FnOnce 的辅助 trait(支持多提取器参数的 handler)
pub trait FnOnceTuple<Args> {
    type Output;
    fn call(self, args: Args) -> Self::Output;
}

impl<F, R> FnOnceTuple<()> for F
where
    F: FnOnce() -> R,
{
    type Output = R;
    fn call(self, (): ()) -> R {
        self()
    }
}

impl<F, A> FnOnceTuple<A> for Arc<F>
where
    F: FnOnceTuple<A> + Clone,
{
    type Output = <F as FnOnceTuple<A>>::Output;

    fn call(self, args: A) -> Self::Output {
        let f: F = (*self).clone();
        f.call(args)
    }
}

macro_rules! impl_fn_once_tuple_all {
    () => {
        impl_fn_once_tuple!(A);
        impl_fn_once_tuple!(A, B);
        impl_fn_once_tuple!(A, B, C);
        impl_fn_once_tuple!(A, B, C, D);
        impl_fn_once_tuple!(A, B, C, D, E);
        impl_fn_once_tuple!(A, B, C, D, E, AA);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J, K);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J, K, L);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J, K, L, M);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J, K, L, M, N);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J, K, L, M, N, O);
        impl_fn_once_tuple!(A, B, C, D, E, AA, G, H, I, J, K, L, M, N, O, P);
    };
}

impl_fn_once_tuple_all!();

/// 框架内部用于绑定 handler 与提取器、状态的类型
pub struct TypedHandler<F, A, S, M> {
    pub f: F,
    pub state: Arc<S>,
    _marker: PhantomData<fn(A, M)>,
}
impl<F, A, S, M> TypedHandler<F, A, S, M> {
    /// 创建一个绑定了状态的 TypedHandler
    pub fn new(f: F, state: Arc<S>) -> Self {
        Self {
            f,
            state,
            _marker: PhantomData,
        }
    }
}

impl<F, A, S, Fut, R, M> Handler for TypedHandler<F, A, S, M>
where
    F: FnOnceTuple<A, Output = Fut> + Clone + Send + Sync + 'static,
    A: FromRequest<S, M> + Send + 'static,
    Fut: Future<Output = R> + Send + 'static,
    R: IntoResponse,
    S: Send + Sync + 'static,
    M: Send + Sync + 'static,
{
    fn call(&self, req: Req) -> Pin<Box<dyn Future<Output = Resp> + Send>> {
        let f = self.f.clone();
        let state = self.state.clone();
        Box::pin(async move {
            let args = A::from_request(req, state.clone()).await;
            match args {
                Ok(args) => {
                    let resp = f.call(args).await;
                    resp.into_response()
                }
                Err(app_error) => app_error.into_response(),
            }
        })
    }
}

impl<S> FromRequestParts<S> for ()
where
    S: Send + Sync + 'static,
{
    fn from_request_parts(_req: &mut Parts, _state: Arc<S>) -> FRFut<Self> {
        Box::pin(async move { Ok(()) })
    }
}

use crate::router::HttpSvc;
pub use __extract_kind::{PartsTag, ReqTag};

mod __extract_kind {
    pub enum PartsTag {}
    pub enum ReqTag {}
}

macro_rules! impl_from_request_parts_tuple {
    ($($name:ident),+) => {
        impl<S, $($name,)+> FromRequestParts<S> for ($($name,)+)
        where
            S: Send + Sync + 'static,
            $( $name: FromRequestParts<S> + Send + 'static, )+
        {
            fn from_request_parts<'a>(parts: &'a mut Parts, state: Arc<S>) -> FRPFut<'a, Self> {
                Box::pin(async move {
                    Ok((
                        $(
                            $name::from_request_parts(parts, state.clone()).await?,
                        )+
                    ))
                })
            }
        }
    };
}

macro_rules! impl_from_request_tuple {
    ($($name:ident),+; $last:ident) => {
        impl<S, $($name,)+ $last> FromRequest<S> for ($($name,)+ $last,)
        where
            S: Send + Sync + 'static,
            $( $name: FromRequestParts<S> + Send + 'static, )+
            $last: FromRequest<S> + Send + 'static,
        {
            fn from_request(req: Req, state: Arc<S>) -> FRFut<Self> {
                Box::pin(async move {
                    let (mut parts, body) = req.into_parts();
                    $(
                        let $name = $name::from_request_parts(&mut parts, state.clone()).await?;
                    )+
                    let req = Req::from_parts(parts, body);
                    let $last = $last::from_request(req, state).await?;
                    Ok(($($name,)+ $last,))
                })
            }
        }
    };
}

impl<S, A> FromRequest<S> for (A,)
where
    S: Send + Sync + 'static,
    A: FromRequest<S> + Send + 'static,
{
    fn from_request(req: Req, state: Arc<S>) -> FRFut<Self> {
        Box::pin(async move {
            let (parts, body) = req.into_parts();
            let req = Req::from_parts(parts, body);
            let a = A::from_request(req, state).await?;
            Ok((a,))
        })
    }
}

macro_rules! impl_from_request_tuple_all {
    () => {
        impl_from_request_parts_tuple!(A);
        impl_from_request_parts_tuple!(A, B);
        impl_from_request_parts_tuple!(A, B, C);
        impl_from_request_parts_tuple!(A, B, C, D);
        impl_from_request_parts_tuple!(A, B, C, D, E);
        impl_from_request_parts_tuple!(A, B, C, D, E, F);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J, K);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J, K, L);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M, N);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M, N, O);
        impl_from_request_parts_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P);

        impl_from_request_tuple!(A; B);
        impl_from_request_tuple!(A, B; C);
        impl_from_request_tuple!(A, B, C; D);
        impl_from_request_tuple!(A, B, C, D; E);
        impl_from_request_tuple!(A, B, C, D, E; F);
        impl_from_request_tuple!(A, B, C, D, E, F; G);
        impl_from_request_tuple!(A, B, C, D, E, F, G; H);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H; I);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I; J);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J; K);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J, K; L);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J, K, L; M);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M; N);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M, N; O);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M, N, O; P);
        impl_from_request_tuple!(A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P; Q);
    };
}

impl_from_request_tuple_all!();

/// 动态处理器对象
pub type DynHandler = Arc<dyn Handler + Send + Sync>;

/// 将一个 DynHandler 包装为 Tower Service 的小型适配器
#[derive(Clone)]
pub struct HandlerSvc {
    inner: DynHandler,
}
impl HandlerSvc {
    pub fn new(inner: DynHandler) -> Self {
        Self { inner }
    }
}

impl Service<Req> for HandlerSvc {
    type Response = Resp;
    type Error = Infallible;
    type Future = Pin<Box<dyn Future<Output = Result<Self::Response, Self::Error>> + Send>>;
    fn poll_ready(&mut self, _cx: &mut Context<'_>) -> Poll<Result<(), Self::Error>> {
        Poll::Ready(Ok(()))
    }
    fn call(&mut self, req: Req) -> Self::Future {
        let h = self.inner.clone();
        Box::pin(async move { Ok(h.call(req).await) })
    }
}
/// 将 Handler 转换为可克隆的 Tower Service
pub fn handler_to_svc(h: DynHandler) -> HttpSvc<Req> {
    let svc = HandlerSvc::new(h);
    let standardized = tower::ServiceBuilder::new()
        .map_err(Into::into)
        .service(svc);
    BoxCloneService::new(standardized)
}