Struct typed_session::SessionStore

pub struct SessionStore<SessionData, SessionStoreConnection, CookieGenerator = DefaultSessionCookieGenerator> { /* private fields */ }

An async session store.

This is the “front-end” interface of the session store.

SessionData is the data associated with a session. SessionStoreConnection is the connection to the backend session store. CookieGenerator is the type used to generate random session cookies.

Implementations

impl<SessionData, SessionStoreConnection, CookieGenerator> SessionStore<SessionData, SessionStoreConnection, CookieGenerator>

pub fn into_inner(self) -> SessionStoreConnection

Consume the SessionStore and return the wrapped SessionStoreConnection.

impl<SessionData, SessionStoreConnection> SessionStore<SessionData, SessionStoreConnection, DefaultSessionCookieGenerator>

pub fn new( implementation: SessionStoreConnection, expiry_strategy: SessionRenewalStrategy ) -> Self

Create a new session store with the given implementation, cookie generator and session renewal strategy.

impl<SessionData, SessionStoreConnection, CookieGenerator> SessionStore<SessionData, SessionStoreConnection, CookieGenerator>

pub fn new_with_cookie_generator( implementation: SessionStoreConnection, cookie_generator: CookieGenerator, session_renewal_strategy: SessionRenewalStrategy ) -> Self

Create a new session store with the given implementation, cookie generator and session renewal strategy.

pub fn session_renewal_strategy(&self) -> &SessionRenewalStrategy

A reference to the session renewal strategy of this session store.

pub fn session_renewal_strategy_mut(&mut self) -> &mut SessionRenewalStrategy

A mutable reference to the session renewal strategy of this session store.

impl<SessionData: Debug, SessionStoreConnection: SessionStoreConnector<SessionData>, CookieGenerator: SessionCookieGenerator> SessionStore<SessionData, SessionStoreConnection, CookieGenerator>

pub async fn store_session( &self, session: Session<SessionData> ) -> Result<SessionCookieCommand>

Store a session in the storage backend. If the session is marked for deletion, this method deletes the session.

If the session cookie requires to be updated, because the session data or expiry changed, then a SessionCookieCommand is returned.

pub async fn clear_store(&self) -> Result

Empties the entire store, deleting all sessions.

impl<SessionData: Debug, SessionStoreConnection: SessionStoreConnector<SessionData>, CookieGenerator> SessionStore<SessionData, SessionStoreConnection, CookieGenerator>

pub async fn load_session( &self, cookie_value: impl AsRef<str> ) -> Result<Option<Session<SessionData>>>

Get a session from the storage backend.

The cookie_value is the value of a cookie identifying the session.

The return value is Ok(Some(_)) if there is a session identified by the given cookie that is not expired, or Ok(None) if there is no such session that is not expired.

Trait Implementations

impl<SessionData, SessionStoreConnection: Clone, CookieGenerator: Clone> Clone for SessionStore<SessionData, SessionStoreConnection, CookieGenerator>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<SessionData: Debug, SessionStoreConnection: Debug, CookieGenerator: Debug> Debug for SessionStore<SessionData, SessionStoreConnection, CookieGenerator>

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

Formats the value using the given formatter.