Struct StoreCollection

pub struct StoreCollection<R: Runtime> { /* private fields */ }

A collection of stores. This is the core component for store plugins.

Implementations

impl<R: Runtime> StoreCollection<R>

pub fn builder() -> StoreCollectionBuilder<R>

Builds a new store collection.

pub fn ids(&self) -> Vec<String>

Lists all the store ids.

pub fn path(&self) -> &Path

Directory where the stores are saved.

pub fn with_store<F, T>(&self, store_id: impl AsRef<str>, f: F) -> Result<T>

where F: FnOnce(&mut Store<R>) -> T,

Calls a closure with a mutable reference to the store with the given id.

pub fn state(&self, store_id: impl AsRef<str>) -> Result<StoreState>

Gets a clone of the store state.

pub fn try_state<T>(&self, store_id: impl AsRef<str>) -> Result<T>

where T: DeserializeOwned,

Gets the store state, then tries to parse it as an instance of type T.

pub fn get( &self, store_id: impl AsRef<str>, key: impl AsRef<str>, ) -> Option<Json>

Gets a value from a store.

pub fn try_get<T>( &self, store_id: impl AsRef<str>, key: impl AsRef<str>, ) -> Result<T>

where T: DeserializeOwned,

Gets a value from a store and tries to parse it as an instance of type T.

pub fn try_get_or<T>( &self, store_id: impl AsRef<str>, key: impl AsRef<str>, default: T, ) -> T

where T: DeserializeOwned,

Gets a value from a store and tries to parse it as an instance of type T. If the key does not exist, returns the provided default value.

pub fn try_get_or_default<T>( &self, store_id: impl AsRef<str>, key: impl AsRef<str>, ) -> T

where T: Default + DeserializeOwned,

Gets a value from a store and tries to parse it as an instance of type T. If the key does not exist, returns the default value of T.

pub fn try_get_or_else<T, F>( &self, store_id: impl AsRef<str>, key: impl AsRef<str>, f: F, ) -> T

where T: DeserializeOwned, F: FnOnce() -> T,

Gets a value from a store and tries to parse it as an instance of type T. If the key does not exist, returns the result of the provided closure.

pub fn set<K, V>( &self, store_id: impl AsRef<str>, key: K, value: V, ) -> Result<()>

where K: AsRef<str>, V: Into<Json>,

Sets a key-value pair in a store.

pub fn patch<S>(&self, store_id: impl AsRef<str>, state: S) -> Result<()>

where S: Into<StoreState>,

Patches a store state.

pub fn save(&self, store_id: impl AsRef<str>) -> Result<()>

Saves a store to the disk.

pub fn save_now(&self, store_id: impl AsRef<str>) -> Result<()>

Saves a store to the disk immediately, ignoring the save strategy.

pub fn save_some(&self, ids: &[impl AsRef<str>]) -> Result<()>

Saves some stores to the disk.

pub fn save_some_now(&self, ids: &[impl AsRef<str>]) -> Result<()>

Saves some stores to the disk immediately, ignoring the save strategy.

pub fn save_all(&self) -> Result<()>

Saves all the stores to the disk.

pub fn save_all_now(&self) -> Result<()>

Saves all the stores to the disk immediately, ignoring the save strategy.

pub fn default_save_strategy(&self) -> SaveStrategy

Default save strategy for the stores. This can be overridden on a per-store basis.

pub fn set_autosave(&self, duration: Duration)

Saves the stores periodically.

pub fn clear_autosave(&self)

Stops the autosave.

pub fn watch<F>(&self, store_id: impl AsRef<str>, f: F) -> Result<u32>

where F: Fn(AppHandle<R>) -> Result<()> + Send + Sync + 'static,

Watches a store for changes.

pub fn unwatch( &self, store_id: impl AsRef<str>, watcher_id: u32, ) -> Result<bool>

Removes a watcher from a store.

pub fn unload_store(&self, id: &str) -> Result<()>

Removes the store from the collection.

Trait Implementations

impl<R: Runtime> Debug for StoreCollection<R>

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

Formats the value using the given formatter.

impl<R: Runtime> Drop for StoreCollection<R>

fn drop(&mut self)

Executes the destructor for this type.

impl<R: Runtime> Resource for StoreCollection<R>

fn name(&self) -> Cow<'_, str>

Returns a string representation of the resource. The default implementation returns the Rust type name, but specific resource types may override this trait method.

fn close(self: Arc<Self>)

Resources may implement the close() trait method if they need to do resource specific clean-ups, such as cancelling pending futures, after a resource has been removed from the resource table.