Struct SessionLoadQuery 

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

SessionLoadQuery

Fluent, session-bound load query wrapper that keeps intent pure while routing execution through the DbSession boundary.

Implementations

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

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

Return a reference to the underlying intent.

pub fn key(self, key: Key) -> Self

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

Add a predicate, implicitly AND-ing with any existing predicate.

pub fn order_by(self, field: &'static str) -> Self

Append an ascending sort key.

pub fn order_by_desc(self, field: &'static str) -> Self

Append a descending sort key.

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

Apply a load limit to bound result size.

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

Apply a load offset.

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

Explain this query without executing it.

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

Plan this query into an executor-ready plan.

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

Execute this query using the session’s policy settings.

pub fn all(&self) -> Result<Vec<E>, QueryError>

Execute a load query and return all entities.

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

Execute a load query and require exactly one entity.

pub fn one_opt(&self) -> Result<Option<E>, QueryError>

Execute a load query and return zero or one entity.