Struct Depot 

pub struct Depot { /* private fields */ }

Store temp data for current request.

A Depot created when server process a request from client. It will dropped when all process for this request done.

Example

We set current_user value in function set_user , and then use this value in the following middlewares and handlers.

use salvo_core::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() {
    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;
}

Implementations

impl Depot

pub fn new() -> Depot

Creates an empty Depot.

The depot is initially created with a capacity of 0, so it will not allocate until it is first inserted into.

pub fn inner(&self) -> &HashMap<String, Box<dyn Any + Send + Sync>>

Get reference to depot inner map.

pub fn with_capacity(capacity: usize) -> Depot

Creates an empty Depot with the specified capacity.

The depot will be able to hold at least capacity elements without reallocating. If capacity is 0, the depot will not allocate.

pub fn capacity(&self) -> usize

Returns the number of elements the depot can hold without reallocating.

pub fn inject<V>(&mut self, value: V) -> &mut Depot

where V: Any + Send + Sync,

Inject a value into the depot.

pub fn obtain<T>(&self) -> Result<&T, Option<&Box<dyn Any + Send + Sync>>>

where T: Any + Send + Sync,

Obtain a reference to a value previous inject to the depot.

Returns Err(None) if value is not present in depot. Returns Err(Some(Box<dyn Any + Send + Sync>)) if value is present in depot but downcasting failed.

pub fn obtain_mut<T>( &mut self, ) -> Result<&mut T, Option<&mut Box<dyn Any + Send + Sync>>>

where T: Any + Send + Sync,

Obtain a mutable reference to a value previous inject to the depot.

Returns Err(None) if value is not present in depot. Returns Err(Some(Box<dyn Any + Send + Sync>)) if value is present in depot but downcasting failed.

pub fn insert<K, V>(&mut self, key: K, value: V) -> &mut Depot

where K: Into<String>, V: Any + Send + Sync,

Inserts a key-value pair into the depot.

pub fn contains_key(&self, key: &str) -> bool

Check is there a value stored in depot with this key.

pub fn contains<T>(&self) -> bool

where T: Any + Send + Sync,

Check is there a value is injected to the depot.

Note: This is only check injected value.

pub fn get<V>( &self, key: &str, ) -> Result<&V, Option<&Box<dyn Any + Send + Sync>>>

where V: Any + Send + Sync,

Immutably borrows value from depot.

Returns Err(None) if value is not present in depot. Returns Err(Some(Box<dyn Any + Send + Sync>)) if value is present in depot but downcasting failed.

pub fn get_mut<V>( &mut self, key: &str, ) -> Result<&mut V, Option<&mut Box<dyn Any + Send + Sync>>>

where V: Any + Send + Sync,

Mutably borrows value from depot.

Returns Err(None) if value is not present in depot. Returns Err(Some(Box<dyn Any + Send + Sync>)) if value is present in depot but downcasting failed.

pub fn remove<V>( &mut self, key: &str, ) -> Result<V, Option<Box<dyn Any + Send + Sync>>>

where V: Any + Send + Sync,

Remove value from depot and returning the value at the key if the key was previously in the depot.

pub fn delete(&mut self, key: &str) -> bool

Delete the key from depot, if the key is not present, return false.

pub fn scrape<T>(&mut self) -> Result<T, Option<Box<dyn Any + Send + Sync>>>

where T: Any + Send + Sync,

Remove value from depot and returning the value if the type was previously in the depot.

Trait Implementations

impl BasicAuthDepotExt for Depot

fn basic_auth_username(&self) -> Option<&str>

Returns the authenticated username if authentication was successful.

impl CsrfDepotExt for Depot

fn csrf_token(&self) -> Option<&str>

Get csrf token reference from depot.

impl Debug for Depot

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

Formats the value using the given formatter.

impl Default for Depot

fn default() -> Depot

Returns the “default value” for a type.

impl FlashDepotExt for Depot

fn incoming_flash(&mut self) -> Option<&Flash>

Get incoming flash.

fn outgoing_flash(&self) -> &Flash

Get outgoing flash.

fn outgoing_flash_mut(&mut self) -> &mut Flash

Get mutable outgoing flash.

impl JwtAuthDepotExt for Depot

fn jwt_auth_token(&self) -> Option<&str>

Gets the JWT token string from the depot.

fn jwt_auth_data<C>(&self) -> Option<&TokenData<C>>

where C: DeserializeOwned + Send + Sync + 'static,

Gets the decoded JWT claims data from the depot.

fn jwt_auth_state(&self) -> JwtAuthState

Gets the current JWT authentication state from the depot.

fn jwt_auth_error(&self) -> Option<&Error>

Gets the JWT error if authentication failed.

impl RequestIdDepotExt for Depot

fn csrf_token(&self) -> Option<&str>

Get request id reference from depot.

impl SessionDepotExt for Depot

fn set_session(&mut self, session: Session) -> &mut Depot

Sets session

fn take_session(&mut self) -> Option<Session>

Take session

fn session(&self) -> Option<&Session>

Get session reference

fn session_mut(&mut self) -> Option<&mut Session>

Get session mutable reference