shio 0.3.0

Shio is a fast, simple, and asynchronous micro web-framework for Rust.
Documentation 
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

use std::ops::Deref;

use tokio_core::reactor::Handle;
use unsafe_any::UnsafeAny;

use util::typemap::TypeMap;
use request::Request;
use state::{FromState, State};
use Data;
pub use state::Key;

/// `Context` represents the context of the current HTTP request.
///
/// A `Context` consists of:
///     - The current HTTP [`Request`].
///     - Shared and per-request [`State`].
///     - A [`Handle`] referencing the event loop in which this request is being
///       handled.
///
/// [`Handle`]: https://docs.rs/tokio-core/0.1/tokio_core/reactor/struct.Handle.html
/// [`Request`]: ../request/struct.Request.html
/// [`State`]: ../struct.State.html
pub struct Context {
    state: State,
    handle: Handle,
    request: Request,
    body: Data,
}

impl Context {
    pub(crate) fn new(handle: Handle, request: Request, state: State, body: Data) -> Self {
        Self {
            handle,
            request,
            state,
            body,
        }
    }

    /// Return a reference to a handle to the event loop this `Context` is associated with.
    #[inline]
    pub fn handle(&self) -> &Handle {
        &self.handle
    }

    /// Take the request body.
    pub fn data(self) -> Data {
        self.body
    }

    /// Puts a value into the request state.
    pub fn put<K: Key>(&mut self, value: K::Value) {
        self.state.put::<K>(value);
    }

    /// Gets a value from the request state.
    ///
    /// With the `nightly` feature enabled, this will fallback to checking the shared
    /// state.
    ///
    /// # Panics
    ///
    /// If there is no value in the request state of the given type.
    pub fn get<T: FromState>(&self) -> &T::Value {
        self.state.get::<T>()
    }

    /// Gets a value from the request state.
    pub fn try_get<T: FromState>(&self) -> Option<&T::Value> {
        self.state.try_get::<T>()
    }

    /// Gets a reference to the shared state.
    pub fn shared(&self) -> &TypeMap<UnsafeAny + Send + Sync> {
        self.state.shared()
    }

    /// Deconstruct current context
    pub fn deconstruct(self) -> (Handle, State, Request, Data) {
        (self.handle, self.state, self.request, self.body)
    }
}

impl Deref for Context {
    type Target = Request;

    fn deref(&self) -> &Self::Target {
        &self.request
    }
}