Struct PagedLoadQuery 

pub struct PagedLoadQuery<'a, E>
where
    E: EntityKind,
{ /* private fields */ }

PagedLoadQuery

Session-bound cursor pagination wrapper. This wrapper only exposes cursor continuation and paged execution.

Implementations

impl<E> PagedLoadQuery<'_, E>

where E: PersistedRow,

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

pub fn cursor(self, token: impl Into<String>) -> Self

Attach an opaque continuation token for the next page.

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

where E: PersistedRow + EntityValue,

Execute in cursor-pagination mode and return items + next cursor.

Continuation is best-effort and forward-only over live state: deterministic per request under canonical ordering, with no snapshot/version pinned across requests.

pub fn execute_trusted(self) -> Result<PagedLoadExecution<E>, QueryError>

where E: PersistedRow + EntityValue,

Execute in cursor-pagination mode without the default bounded read-admission gate.

This is for trusted maintenance/admin code that has its own caller authorization and resource policy. Application-facing reads should use execute.

pub fn execute_with_trace( self, ) -> Result<PagedLoadExecutionWithTrace<E>, QueryError>

where E: PersistedRow + EntityValue,

Execute in cursor-pagination mode and return items, next cursor, and optional execution trace details when session debug mode is enabled.

Trace collection is opt-in via DbSession::debug() and does not change query planning or result semantics.

pub fn execute_with_trace_trusted( self, ) -> Result<PagedLoadExecutionWithTrace<E>, QueryError>

where E: PersistedRow + EntityValue,

Execute in cursor-pagination mode with trace details and without the default bounded read-admission gate.

This is for trusted maintenance/admin code that has its own caller authorization and resource policy. Application-facing reads should use execute_with_trace.