Struct State 

pub struct State<S>(/* private fields */);

Shared application state passed to every request handler.

Wraps an Arc<S> for zero-allocation sharing across handlers. Handlers receive a clone of this wrapper (not a clone of S), which only increments the refcount. Dereferences transparently to &S.

Implementations

impl<S> State<S>

pub fn new(state: S) -> Self

Create a new state from a value, wrapping it in an Arc.

pub fn from_arc(state: Arc<S>) -> Self

Create a state from an existing Arc.

Useful for sharing state between the app and background tasks without allocating a second Arc.

pub fn inner(&self) -> S

where S: Clone,

Extract a clone of the inner value.

Only available if S implements Clone. This is generally not needed in request handlers (dereference to &S instead); it’s useful for copying state into spawned background tasks.

Trait Implementations

impl<S: Clone> Clone for State<S>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S> Deref for State<S>

type Target = S

The resulting type after dereferencing.

fn deref(&self) -> &S

Dereferences the value.