Struct dittolive_ditto::store::Store

pub struct Store { /* private fields */ }

Store provides access to Collections and a write transaction API.

Implementations

impl Store

pub fn new(ditto: Arc<BoxedDitto>) -> Self

pub fn collection(&self, collection_name: &str) -> Result<Collection, DittoError>

Returns a Collection with the provided name. A collection name is valid if :

• its length is less than 100
• it is not empty
• it does not contain the char ‘\0’
• it does not begin with “$TS_”

pub fn collections(&self) -> PendingCollectionsOperation<'_>

Returns an object that lets you fetch or observe the collections in the store.

pub fn with_batched_write<F>(
    &self,
    f: F
) -> Result<Vec<WriteTransactionResult>, DittoError>where
    for<'batch> F: FnOnce(ScopedStore<'batch>) -> Action<'batch>,

Allows you to group multiple operations together that affect multiple documents, potentially across multiple collections, without auto-committing on each operation.

At the end of the batch of operations, either batch.commit_changes or batch.revert_changes must be called.

Example

ditto.store().with_batched_write(|batch| {
    let mut foo_coll = batch.collection("foo");
    foo_coll.find...().remove();
    let mut bar_coll = batch.collection("bar");
    // Expensive multi-mutation op:
    for _ in 0 .. 10_000 {
        let doc = ...;
        bar_coll.insert(doc, None, false);
    }
    // At this point, we must say whether we commit or revert
    // these changes:
    batch.commit_changes()
})

pub fn collection_names(&self) -> Result<Vec<String>, DittoError>

Returns a list of the names of collections in the local store.

pub fn queries_hash(&self, live_queries: &[LiveQuery]) -> Result<u64, DittoError>

Returns a hash representing the current version of the given queries. When a document matching such queries gets mutated, the hash will change as well.

Please note that the hash depends on how queries are constructed, so you should make sure to always compare hashes generated with the same set of queries.

pub fn queries_hash_mnemonic(
    &self,
    live_queries: &[LiveQuery]
) -> Result<String, DittoError>

Returns a sequence of English words representing the current version of the given queries. When a document matching such queries gets mutated, the words will change as well.

Please note that the resulting sequence of words depends on how queries are constructed, so you should make sure to always compare hashes generated with the same set of queries.

pub fn start_all_live_query_webhooks(&self) -> Result<(), DittoError>

Start all live query webhooks.

pub fn start_live_query_webhook_by_id(
    &self,
    doc_id: DocumentId
) -> Result<(), DittoError>

Start a live query webhooks by its id.

pub fn register_live_query_webhook(
    &self,
    collection_name: &str,
    query: &str,
    url: &str
) -> Result<DocumentId, DittoError>

Register a new live query webhook

pub fn live_query_webhook_generate_new_api_secret(
    &self
) -> Result<(), DittoError>

Generate a new API secret for live query webhook

pub fn timeseries(&self, ts_name: &str) -> Result<TimeSeries, DittoError>

Returns a TimeSeries with the provided name.

pub fn disk_usage(&self) -> &DiskUsage

Return a DiskUsage to monitor the disk usage of the Store.

Trait Implementations

impl Clone for Store

fn clone(&self) -> Store

Returns a copy of the value.

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

Performs copy-assignment from source.