Struct Query 

pub struct Query<T> { /* private fields */ }

A query over one template, compiled to parameterized SQL.

The template comes from the type, so the qname is never typed out:

let sql = Query::<AppInstallRequest>::active()
    .filter(Predicate::eq("user", party))
    .limit(100)
    .compile();

Implementations

impl<T: Contract> Query<T>

pub fn active() -> Self

Contracts of this template that are active now.

pub fn active_at(offset: i64) -> Self

Contracts of this template that were active as of an offset.

What makes a paged or repeated read consistent: the ACS at a point, rather than a target that moves between calls.

pub fn creates(from: Option<i64>, to: Option<i64>) -> Self

Contracts of this template created between two offsets.

None on either side keeps the store’s own default — its oldest retained offset, and its latest.

pub fn archives(from: Option<i64>, to: Option<i64>) -> Self

Contracts of this template archived between two offsets.

pub fn qname() -> String

The qname PQS knows this template by: <package>:<Module>:<Entity>.

The package name, not its id — which is what makes a query survive a Smart Contract Upgrade instead of pinning one build.

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

Add a condition. Conditions are combined with AND.

pub fn limit(self, rows: i64) -> Self

Cap the number of rows.

pub fn compile(&self) -> Sql

Compile to SQL and its parameters.

Every caller-supplied value is a parameter — including JSON paths, which are bound as text[]. The statement text depends only on the shape of the query, never on its data.

Trait Implementations

impl<T: Clone> Clone for Query<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Query<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.