Struct AppState 

pub struct AppState<C: ConfigProvider> { /* private fields */ }

Thread-safe shared application state.

Generic over C: ConfigProvider so that any domain can use it with their own configuration type. The configuration is wrapped in an Arc for cheap cloning and thread-safe sharing.

Type Parameters

• C — The domain-specific configuration provider

Thread Safety

AppState is Clone, Send, and Sync. Cloning is cheap (Arc clone). Multiple request handlers can share the same state concurrently.

Implementations

impl<C: ConfigProvider> AppState<C>

pub fn new(config: C) -> Self

Create a new AppState wrapping the given configuration.

The configuration is moved into an Arc for shared ownership.

Arguments

• config — The domain-specific configuration

Example

let config = Config { base: PathBuf::from("/data") };
let state = AppState::new(config);

pub fn from_arc(config: Arc<C>) -> Self

Create AppState from an existing Arc-wrapped configuration.

Useful when the configuration is already shared elsewhere.

Arguments

• config — Arc-wrapped configuration

pub fn config(&self) -> &C

Get a reference to the configuration.

Example

let project = state.config().project_name();

pub fn config_arc(&self) -> Arc<C>

Get a cloneable handle to the configuration.

Returns an Arc<C> that can be passed to subsystems that need their own owned reference to the configuration.

Example

let config_arc = state.config_arc();
// Pass config_arc to another subsystem

pub fn project_name(&self) -> &str

Get the project name from the configuration.

Convenience method equivalent to state.config().project_name().

Trait Implementations

impl<C: ConfigProvider> Clone for AppState<C>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: Debug + ConfigProvider> Debug for AppState<C>

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

Formats the value using the given formatter.

impl<C: ConfigProvider> Send for AppState<C>

impl<C: ConfigProvider> Sync for AppState<C>