Struct SessionLoadQuery 

pub struct SessionLoadQuery<'a, C: CanisterKind, E: EntityKind<Canister = C>> { /* private fields */ }

SessionLoadQuery

Session-bound load query wrapper. Owns intent construction and execution routing only. All result inspection and projection is performed on Response<E>.

Implementations

impl<'a, C: CanisterKind, E: EntityKind<Canister = C>> SessionLoadQuery<'a, C, E>

pub const fn query(&self) -> &Query<E>

pub fn by_key(self, key: E::PrimaryKey) -> Self

pub fn many<I>(self, keys: I) -> Self

where I: IntoIterator<Item = E::PrimaryKey>,

pub fn filter(self, predicate: Predicate) -> Self

pub fn filter_expr(self, expr: FilterExpr) -> Result<Self, QueryError>

pub fn sort_expr(self, expr: SortExpr) -> Result<Self, QueryError>

pub fn order_by(self, field: impl AsRef<str>) -> Self

pub fn order_by_desc(self, field: impl AsRef<str>) -> Self

pub fn limit(self, limit: u32) -> Self

pub fn offset(self, offset: u32) -> Self

pub fn explain(&self) -> Result<ExplainPlan, QueryError>

pub fn plan(&self) -> Result<ExecutablePlan<E>, QueryError>

pub fn execute(&self) -> Result<Response<E>, QueryError>

Execute this query using the session’s policy settings.

pub fn is_empty(&self) -> Result<bool, QueryError>

Execute and return whether the result set is empty.

pub fn count(&self) -> Result<u32, QueryError>

Execute and return the number of matching rows.

pub fn require_one(&self) -> Result<(), QueryError>

Execute and require exactly one matching row.

pub fn require_some(&self) -> Result<(), QueryError>

Execute and require at least one matching row.

impl<C: CanisterKind, E: EntityKind<Canister = C>> SessionLoadQuery<'_, C, E>

where E::PrimaryKey: UnitKey,

pub fn only(self) -> Self

Load the singleton entity identified by the unit primary key ().