Struct ProjectedQuery 

pub struct ProjectedQuery { /* private fields */ }

Typed projected-query request builder.

Implementations

impl ProjectedQuery

pub fn new( contract: ApplicationContract, projection_name: impl Into<String>, org_scope: ApplicationValue, ) -> Result<Self, ApplicationClientError>

Builds a projected query with required org scope and available freshness.

pub fn select(self, select: Vec<String>) -> Self

Sets selected field names (empty = all projected fields).

pub fn predicates(self, predicates: Vec<ProjectedPredicate>) -> Self

Sets conjunctive predicates.

pub fn order(self, order: Vec<ProjectedOrder>) -> Self

Sets sort keys (primary-key tie-break remains engine-owned).

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

Sets the declared result bound: the post-sort row limit.

For a request with Self::group_by keys this is the maximum number of groups the query may return — grouped results are measured in groups rather than rows. Exceeding it is a typed rejection returning nothing, not a truncated set of groups.

It has no effect on an aggregate without group keys: that result is one value per requested function however many rows were folded.

pub fn aggregate(self, aggregate: ProjectedAggregate) -> Self

Adds one aggregate function; repeat for several.

A query with at least one aggregate answers with ProjectedQueryOutcome::ReadyAggregates instead of rows, and the requested ProjectedResponseEncoding no longer applies.

Several functions require Self::group_by keys: the server computes exactly one whole-set function per query.

pub fn group_by(self, keys: Vec<String>) -> Self

Sets the group-by key field names (empty = whole-set aggregate).

pub fn freshness(self, freshness: FreshnessPolicy) -> Self

Sets the freshness policy (Available / Bounded / Causal with token).

pub const fn encoding(self, encoding: ProjectedResponseEncoding) -> Self

Selects row or packed Ready encoding.

pub fn projection_name(&self) -> &str

Projection name.

pub const fn response_encoding(&self) -> ProjectedResponseEncoding

Requested response encoding.

pub fn into_wire_request( self, ) -> Result<ExecuteProjectedQueryRequest, ApplicationClientError>

Builds the public wire request (for tests and advanced callers).

Trait Implementations

impl Clone for ProjectedQuery

fn clone(&self) -> ProjectedQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectedQuery

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

Formats the value using the given formatter.

impl Eq for ProjectedQuery

impl PartialEq for ProjectedQuery

fn eq(&self, other: &ProjectedQuery) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ProjectedQuery