Struct State 

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

Extractor for shared application state.

Use this to access data that’s shared across all connections, such as:

• Database connection pools
• Configuration
• Caches
• Connection managers

Type Parameter

The generic parameter T should be wrapped in Arc since state is shared.

Examples

Accessing Connection Manager

use wsforge::prelude::*;
use std::sync::Arc;

async fn broadcast_handler(
    msg: Message,
    State(manager): State<Arc<ConnectionManager>>,
) -> Result<()> {
    manager.broadcast(msg);
    Ok(())
}

Custom State Type

use wsforge::prelude::*;
use std::sync::Arc;

struct AppConfig {
    max_message_size: usize,
    rate_limit: u32,
}

async fn handler(State(config): State<Arc<AppConfig>>) -> Result<String> {
    Ok(format!("Max message size: {}", config.max_message_size))
}

Tuple Fields

0: Arc<T>

Trait Implementations

impl<T: Send + Sync + 'static> FromMessage for State<T>

fn from_message<'life0, 'life1, 'life2, 'life3, 'async_trait>( _message: &'life0 Message, _conn: &'life1 Connection, state: &'life2 AppState, _extensions: &'life3 Extensions, ) -> Pin<Box<dyn Future<Output = Result<Self>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Extracts Self from the message and context.