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 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.

pub fn register_observer<Q, F>(
    &self,
    query: Q,
    query_args: Option<QueryArguments>,
    on_change: F
) -> Result<Arc<StoreObserver>, DittoError>where
    Q: TryInto<Query, Error = DittoError>,
    F: ChangeHandler,

Register a handler to be called whenever a query’s results change in the local store.

The returned StoreObserver must be kept in scope for as long as the change handler should be called with new change events.

The given query may not modify any documents and must be a valid Ditto Query Language query.

If no on_error argument is provided, errors that are thrown in the provided change handler will be logged to the console.

pub fn observers(&self) -> impl '_ + Deref<Target = SetArc<StoreObserver>>

Gets temporary access to the set of currently registered observers.

A (read) lock is held until the return value is dropped: this means that neither Self::register_observer() nor StoreObserver::cancel() can make progress until this read lock is released.

pub async fn execute<Q>(
    &self,
    query: Q,
    query_args: Option<QueryArguments>
) -> Result<QueryResult, DittoError>where
    Q: TryInto<Query, Error = DittoError>,

Executes the given query in the local store and returns the result.

Use placeholders to incorporate values from the optional query_args parameter into the query. The keys of the QueryArguments object must match the placeholders used within the query. You can not use placeholders in the FROM clause.

Limitations:

• Supports SELECT * FROM <collection name> with optional WHERE <expression>
• No transactions

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.