Struct SharedDb 

pub struct SharedDb { /* private fields */ }

Shared handle to an on-disk GraphDb. Clone is cheap and shares state.

Event-sink deadlock

GraphDb::set_event_sink runs the hook inside log_then_apply while this write guard is still held. A sink must never call SharedDb::read or SharedDb::write on the same handle (the RwLock is not re-entrant). The sink is Send + Sync; std::sync::mpsc::Sender is not Sync. Intended examples: std::sync::mpsc::SyncSender, tokio::sync::mpsc::Sender, tokio::sync::broadcast::Sender, or Arc<Mutex<Vec<_>>>.

Implementations

impl SharedDb

pub fn open(dir: &Path) -> Result<Self>

pub fn read(&self) -> impl Deref<Target = GraphDb<RealFs>> + '_

Shared read access. Many readers may hold this concurrently.

Deadlock warning

Do not hold a returned guard while calling any method on the same SharedDb; the RwLock is not re-entrant; doing so deadlocks.

pub fn write(&self) -> impl DerefMut<Target = GraphDb<RealFs>> + '_

Exclusive write access. Blocks until no other readers or writers hold the lock.

Deadlock warning

Do not hold a returned guard while calling any method on the same SharedDb; the RwLock is not re-entrant; doing so deadlocks.

Trait Implementations

impl Clone for SharedDb

fn clone(&self) -> SharedDb

Returns a duplicate of the value.

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

Performs copy-assignment from source.