Struct terminus_store::store::StoreLayerBuilder

pub struct StoreLayerBuilder { /* fields omitted */ }

A wrapper over a SimpleLayerBuilder, providing a thread-safe sharable interface.

The SimpleLayerBuilder requires one to have a mutable reference to the underlying LayerBuilder, and on commit it will be consumed. This builder only requires an immutable reference, and uses a futures-aware read-write lock to synchronize access to it between threads. Also, rather than consuming itself on commit, this wrapper will simply mark itself as having committed, returning errors on further calls.

Implementations

impl StoreLayerBuilder

pub fn name(&self) -> [u32; 5]

Returns the name of the layer being built.

pub fn parent(&self) -> Option<Arc<dyn Layer>>

Returns the parent layer this builder is building on top of, if any.

If there's no parent, this returns None.

pub fn add_string_triple(&self, triple: StringTriple) -> Result<(), Error>

Add a string triple.

pub fn add_id_triple(&self, triple: IdTriple) -> Result<(), Error>

Add an id triple.

pub fn remove_string_triple(&self, triple: StringTriple) -> Result<(), Error>

Remove a string triple.

pub fn remove_id_triple(&self, triple: IdTriple) -> Result<(), Error>

Remove an id triple.

pub fn committed(&self) -> bool

Returns true if this layer has been committed, and false otherwise.

pub async fn commit_no_load(&self) -> Result<()>

Commit the layer to storage without loading the resulting layer.

pub async fn commit(&self) -> Result<StoreLayer>

Commit the layer to storage.

pub async fn apply_delta(&self, delta: &StoreLayer) -> Result<(), Error>

Apply all triples added and removed by a layer to this builder.

This is a way to 'cherry-pick' a layer on top of another layer, without caring about its history.

pub fn apply_diff(&self, other: &StoreLayer) -> Result<(), Error>

Apply the changes required to change our parent layer into the given layer.