Struct skipdb::optimistic::OptimisticDb

source ·
pub struct OptimisticDb<K, V, S = RandomState> { /* private fields */ }
Expand description

A concurrent MVCC in-memory key-value database.

OptimisticDb requires key to be Ord and Hash.

Comparing to SerializableDb:

  1. SerializableDb support full serializable snapshot isolation, which can detect both direct dependencies and indirect dependencies.
  2. SerializableDb does not require key to implement Hash.
  3. But, OptimisticDb has more flexible write transaction APIs and no clone happen.

Implementations§

source§

impl<K, V> OptimisticDb<K, V>

source

pub fn new() -> Self

Creates a new OptimisticDb with the given options.

source§

impl<K, V, S> OptimisticDb<K, V, S>

source

pub fn with_hasher(hasher: S) -> Self

Creates a new OptimisticDb with the given hasher.

source

pub fn version(&self) -> u64

Returns the current read version of the database.

source

pub fn read(&self) -> ReadTransaction<K, V, OptimisticDb<K, V, S>, HashCm<K, S>>

Create a read transaction.

source§

impl<K, V, S> OptimisticDb<K, V, S>
where K: Ord + Eq + Hash, V: 'static, S: BuildHasher + Clone,

source

pub fn write(&self) -> OptimisticTransaction<K, V, S>

Create a optimistic write transaction.

Optimistic write transaction is not a totally Serializable Snapshot Isolation transaction. It can handle most of write skew anomaly, but not all. Basically, all directly dependencies can be handled, but indirect dependencies (logical dependencies) can not be handled. If you need a totally Serializable Snapshot Isolation transaction, you should use SerializableDb instead.

source

pub fn write_with_capacity( &self, capacity: usize ) -> OptimisticTransaction<K, V, S>

Create a optimistic write transaction with the given capacity hint.

source§

impl<K, V, S> OptimisticDb<K, V, S>
where K: Ord + Eq + Hash + Send + 'static, V: Send + 'static, S: BuildHasher + Clone,

source

pub fn compact(&self)

Compact the database.

Trait Implementations§

source§

impl<K, V, S> Clone for OptimisticDb<K, V, S>

source§

fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<K, V> Default for OptimisticDb<K, V>

source§

fn default() -> Self

Creates a new OptimisticDb with the default options.

Auto Trait Implementations§

§

impl<K, V, S> Freeze for OptimisticDb<K, V, S>

§

impl<K, V, S = RandomState> !RefUnwindSafe for OptimisticDb<K, V, S>

§

impl<K, V, S> Send for OptimisticDb<K, V, S>
where S: Sync + Send, K: Sync + Send, V: Sync + Send,

§

impl<K, V, S> Sync for OptimisticDb<K, V, S>
where S: Sync + Send, K: Sync + Send, V: Sync + Send,

§

impl<K, V, S> Unpin for OptimisticDb<K, V, S>

§

impl<K, V, S = RandomState> !UnwindSafe for OptimisticDb<K, V, S>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.