Struct SessionStore 

pub struct SessionStore { /* private fields */ }

Thread-safe session store with automatic expiry cleanup.

Implementations

impl SessionStore

pub fn new(session_timeout: Duration, max_sessions: usize) -> Self

pub fn with_max_lifetime(self, lifetime: Duration) -> Self

Set an absolute session lifetime. Sessions older than this duration are expired regardless of activity. Returns self for chaining.

pub fn get_or_create(&self, client_session_id: Option<&str>) -> String

Get or create a session. Returns the session ID.

If client_session_id is provided and the session exists, it’s reused. Otherwise a new session is created. Session IDs are always server-generated to prevent session fixation attacks.

pub fn get(&self, session_id: &str) -> Option<Ref<'_, String, SessionState>>

Get an immutable reference to a session.

pub fn get_mut( &self, session_id: &str, ) -> Option<RefMut<'_, String, SessionState>>

Get a mutable reference to a session.

pub fn evict_expired(&self)

Remove expired sessions.

pub fn len(&self) -> usize

Current number of active sessions.

pub fn is_empty(&self) -> bool

Whether there are any active sessions.

pub fn remove(&self, session_id: &str) -> bool

Delete a specific session (e.g., on client disconnect via DELETE).