#Depot

Depot es una estructura utilizada para almacenar datos temporales involucrados en una solicitud. Los middlewares pueden colocar los datos temporales que procesan en el Depot para que los utilicen programas posteriores.

Cuando un servidor recibe una solicitud de un navegador cliente, crea una instancia de Depot. Esta instancia se destruirá después de que todos los middlewares y Handler hayan procesado la solicitud.

Por ejemplo, podemos establecer current_user en el middleware de inicio de sesión, y luego leer la información del usuario actual en middlewares posteriores o en el Handler.

#Comprensión rápida

Depot se utiliza para almacenar y compartir datos durante el procesamiento de solicitudes. Implementa un contenedor de datos seguro en tipos, compatible con dos modos principales de uso:

1. Almacenamiento clave-valor: accede a valores asociados con claves de cadena mediante los métodos insert/get
2. Inyección de tipos: almacena y obtiene valores basados en tipos mediante los métodos inject/obtain

Como se muestra en el ejemplo, Depot es especialmente útil para pasar datos entre middlewares y manejadores. Los middlewares pueden establecer valores en Depot (como información de usuario, estado de autenticación), y los manejadores posteriores pueden obtener estos valores sin necesidad de repetir cálculos o consultas. El diseño de Depot garantiza la consistencia y accesibilidad de los datos durante toda la cadena de procesamiento de solicitudes, siendo una herramienta central para construir aplicaciones web complejas.

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;
}

#Configurar y obtener datos medianteinsert yget

Como se mostró anteriormente, se puede insertar key y value en Depot mediante insert. Para este tipo de valores, se obtienen directamente con get.

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

Si no existe esta key, o si la key existe pero el tipo no coincide, devuelve None.

#Configurar y obtener datos medianteinject yobtain

A veces, existen datos que no requieren una key específica, donde solo existe una instancia única para ese tipo. Se puede usar inject para insertar datos y luego obtain para obtenerlos. No es necesario proporcionar una key.

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

#Resumen de métodos de la estructura Depot