Struct FileSessionStore 

pub struct FileSessionStore { /* private fields */ }

A tower_sessions::SessionStore backed by plain files on disk, one per session - see this module’s own doc comment for when this is used instead of AnySessionStore. Each session’s Record is JSON-encoded (the same [encode]/[decode] helpers AnySessionStore itself uses) into a file named after Id’s own rendering.

Implementations

impl FileSessionStore

pub fn new(dir: impl Into<PathBuf>) -> Self

Public so larust_testing::TestClient::acting_as can build one directly over the same directory the router’s own session layer uses, matching AnySessionStore::new’s identical role for the database-backed store.

Trait Implementations

impl Clone for FileSessionStore

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileSessionStore

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

Formats the value using the given formatter.

impl ExpiredDeletion for FileSessionStore

fn delete_expired<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

A method for deleting expired sessions from the store.

impl SessionStore for FileSessionStore

fn create<'life0, 'life1, 'async_trait>( &'life0 self, record: &'life1 mut Record, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

A real “fail if it already exists” create (not save’s upsert), the file-store equivalent of AnySessionStore::create’s real INSERT - see that method’s own doc comment for why detecting a genuine Id collision, rather than silently overwriting the other session, is the whole reason create exists separately from save at all. create_new(true) atomically fails with AlreadyExists if the path is already taken, with no separate existence check to race against. No temp-file dance needed here, unlike save/ write_atomically: a brand-new file has no previous version a concurrent reader could see a torn mix of.

fn save<'life0, 'life1, 'async_trait>( &'life0 self, record: &'life1 Record, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Saves the provided session record to the store.

fn load<'life0, 'life1, 'async_trait>( &'life0 self, session_id: &'life1 Id, ) -> Pin<Box<dyn Future<Output = Result<Option<Record>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Loads an existing session record from the store using the provided ID.

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, session_id: &'life1 Id, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Deletes a session record from the store using the provided ID.