#Depot

Depot è una struttura utilizzata per memorizzare dati temporanei relativi a una singola richiesta. I middleware possono inserire dati elaborati nel Depot, rendendoli disponibili per le successive fasi di elaborazione.

Quando un server riceve una richiesta dal browser client, crea un'istanza di Depot. Questa istanza viene distrutta dopo che tutti i middleware e gli Handler hanno completato l'elaborazione della richiesta.

Ad esempio, possiamo impostare current_user in un middleware di autenticazione, per poi leggere le informazioni dell'utente corrente nei middleware successivi o negli Handler.

#Concetti chiave

Depot viene utilizzato per memorizzare e condividere dati durante l'elaborazione di una richiesta. Implementa un contenitore di dati type-safe con due modalità principali:

1. Archiviazione chiave-valore: accesso ai valori tramite chiavi stringa con metodi insert/get
2. Iniezione per tipo: accesso ai valori basato sul tipo con metodi inject/obtain

Come mostrato negli esempi, Depot è particolarmente utile per passare dati tra middleware e handler. I middleware possono impostare valori (come informazioni utente o stato di autenticazione) nel Depot, che gli handler successivi possono recuperare senza dover ripetere calcoli o query. Il design di Depot garantisce coerenza e accessibilità dei dati durante l'intera catena di elaborazione della richiesta, rendendolo uno strumento essenziale per costruire applicazioni web complesse.

use salvo::prelude::*;

#[handler]
async fn set_user(depot: &mut Depot) {
    depot.insert("user", "client");
}
#[handler]
async fn hello(depot: &mut Depot) -> String {
    format!(
        "Hello {}",
        depot.get::<&str>("user").copied().unwrap_or_default()
    )
}

#[tokio::main]
async fn main() {
    tracing_subscriber::fmt().init();

    let router = Router::new().hoop(set_user).goal(hello);

    let acceptor = TcpListener::new("0.0.0.0:5800").bind().await;
    Server::new(acceptor).serve(router).await;
}

#Inserire e recuperare dati coninsert eget

Come mostrato sopra, è possibile inserire coppie key-value nel Depot usando insert. Per questo tipo di valori, si utilizza direttamente get per il recupero.

depot.insert("a", "b");
assert_eq!(depot.get::<&str>("a").copied().unwrap(), "b")

Se la chiave non esiste, o esiste ma il tipo non corrisponde, viene restituito None.

#Inserire e recuperare dati coninject eobtain

In alcuni casi, esistono dati che non richiedono una chiave specifica, essendo unici per il loro tipo. Per questi si può usare inject per l'inserimento e obtain per il recupero, senza bisogno di specificare una chiave.

depot.inject(Config::new());
depot.obtain::<Config>();

#Panoramica dei metodi della struttura Depot