Struct DbSession 

pub struct DbSession<C>
where
    C: CanisterKind,
{ /* private fields */ }

DbSession Database handle plus a debug flag that controls executor verbosity.

Implementations

impl<C> DbSession<C>

where C: CanisterKind,

pub const fn new(db: Db<C>) -> DbSession<C>

Create a new session scoped to the provided database.

pub const fn debug(self) -> DbSession<C>

Enable debug logging for subsequent queries in this session.

pub const fn load<E>(&self) -> LoadExecutor<E>

where E: EntityKind<Canister = C>,

Get a LoadExecutor for building and executing queries that read entities.

pub const fn save<E>(&self) -> SaveExecutor<E>

where E: EntityKind<Canister = C>,

Get a SaveExecutor for inserting or updating entities.

Normally you will use the higher-level create/replace/update shortcuts instead.

pub const fn delete<E>(&self) -> DeleteExecutor<E>

where E: EntityKind<Canister = C>,

Get a DeleteExecutor for deleting entities by key or query.

pub fn insert<E>(&self, entity: E) -> Result<E, Error>

where E: EntityKind<Canister = C>,

Insert a new entity, returning the stored value.

pub fn replace<E>(&self, entity: E) -> Result<E, Error>

where E: EntityKind<Canister = C>,

Replace an existing entity or insert it if it does not yet exist.

pub fn update<E>(&self, entity: E) -> Result<E, Error>

where E: EntityKind<Canister = C>,

Partially update an existing entity.

pub fn insert_view<E>( &self, view: <E as View>::ViewType, ) -> Result<<E as View>::ViewType, Error>

where E: EntityKind<Canister = C>,

Insert a new view value for an entity.

pub fn replace_view<E>( &self, view: <E as View>::ViewType, ) -> Result<<E as View>::ViewType, Error>

where E: EntityKind<Canister = C>,

Replace an existing view or insert it if it does not yet exist.

pub fn update_view<E>( &self, view: <E as View>::ViewType, ) -> Result<<E as View>::ViewType, Error>

where E: EntityKind<Canister = C>,

Partially update an existing view.