Struct State 

pub struct State<T>(pub Arc<T>);

Extracts a shared handle to application state of type T.

The state must have been registered with AppBuilder::state; if no value of type T was registered, extraction fails with 500 Internal Server Error. State<T> derefs to T, so the inner value can be used directly.

use churust_core::{Churust, State, TestClient};
#[derive(Clone)]
struct Config { greeting: &'static str }

let app = Churust::server()
    .state(Config { greeting: "hi" })
    .routing(|r| {
        r.get("/", |cfg: State<Config>| async move { cfg.greeting });
    })
    .build();
let res = TestClient::new(app).get("/").send().await;
assert_eq!(res.text(), "hi");

Tuple Fields

0: Arc<T>

The shared handle to the registered state value.

Trait Implementations

impl<T: Clone> Clone for State<T>

fn clone(&self) -> State<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for State<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> Deref for State<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T> FromCallParts for State<T>

where T: Send + Sync + 'static,

fn from_call_parts<'life0, 'async_trait>( call: &'life0 mut Call, ) -> Pin<Box<dyn Future<Output = Result<Self>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Build Self from a mutable borrow of the call, or return an Error (which the handler renders as the response).