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

/// The `State` trait, should be replace with trait alias.
/// The `App::state` will be cloned when a request inbounds.
///
/// `State` is designed to share data or handler between middlewares.
///
/// ### Example
/// ```rust
/// use roa_core::{App, Context, Next, Result};
/// use roa_core::http::StatusCode;
///
/// #[derive(Clone)]
/// struct State {
///     id: u64,
/// }
///
/// let app = App::state(State { id: 0 }).gate(gate).end(end);
/// async fn gate(ctx: &mut Context<State>, next: Next<'_>) -> Result {
///     ctx.id = 1;
///     next.await
/// }
///
/// async fn end(ctx: &mut Context<State>) -> Result {
///     let id = ctx.id;
///     assert_eq!(1, id);
///     Ok(())
/// }
/// ```
pub trait State: 'static + Clone + Send + Sync + Sized {}

impl<T: 'static + Clone + Send + Sync + Sized> State for T {}