#Depot

Depot é uma estrutura utilizada para armazenar dados temporários envolvidos no processamento de uma requisição. Middlewares podem inserir seus dados processados no Depot, tornando-os disponíveis para processamento posterior.

Quando um servidor recebe uma requisição do navegador do cliente, ele cria uma instância de Depot. Esta instância é destruída após todos os middlewares e Handlers concluírem o processamento da requisição.

Por exemplo, podemos definir current_user em um middleware de autenticação, e então ler as informações do usuário atual em middlewares subsequentes ou no Handler.

#Visão Rápida

Depot é utilizado para armazenar e compartilhar dados durante o processamento de requisições. Ele implementa um container de dados type-safe, suportando dois padrões principais de uso:

1. Armazenamento chave-valor: Acessa valores associados a chaves string através dos métodos insert/get
2. Injeção por tipo: Armazena e recupera valores baseados no tipo através dos métodos inject/obtain

Como mostrado nos exemplos, Depot é particularmente útil para passar dados entre middlewares e handlers. Middlewares podem definir valores (como informações de usuário, estado de autenticação) no Depot, que podem ser acessados por handlers subsequentes sem necessidade de recálculo ou consulta. O design do Depot garante consistência e acessibilidade dos dados durante toda a cadeia de processamento da requisição, sendo uma ferramenta essencial para construir aplicações web complexas.

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

#Definindo e obtendo dados cominsert eget

Como mostrado acima, você pode inserir pares chave-valor no Depot usando insert. Para este tipo de valor, basta usar get para recuperá-lo.

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

Se a chave não existir, ou se existir mas o tipo não corresponder, será retornado None.

#Definindo e obtendo dados cominject eobtain

Algumas vezes, existem valores que não requerem uma chave específica, sendo únicos por tipo. Você pode usar inject para inserir esses dados e obtain para recuperá-los, sem necessidade de especificar uma chave.

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

#Visão Geral dos Métodos da Estrutura Depot