Struct QueryBuilder 

pub struct QueryBuilder<S>
where
    S: Schema,
{ /* private fields */ }

Typed query builder for OData queries.

This builder provides a fluent API for constructing ODataQuery instances with type-safe field references and automatic filter hashing.

Example

let query = QueryBuilder::<UserSchema>::new()
    .filter(NAME.contains("john"))
    .order_by(NAME, SortDir::Asc)
    .select([NAME, EMAIL])
    .page_size(50)
    .build();

Implementations

impl<S> QueryBuilder<S>

where S: Schema,

pub fn new() -> QueryBuilder<S>

Create a new empty query builder.

pub fn filter(self, expr: Expr) -> QueryBuilder<S>

Set the filter expression.

Example

builder.filter(ID.eq(user_id).and(NAME.contains("john")))

pub fn order_by<F>(self, field: F, dir: SortDir) -> QueryBuilder<S>

where F: AsFieldName,

Add an order-by clause.

Can be called multiple times to add multiple sort keys.

Example

builder
    .order_by(NAME, SortDir::Asc)
    .order_by(ID, SortDir::Desc)

pub fn select<I>(self, fields: I) -> QueryBuilder<S>

where I: IntoIterator, <I as IntoIterator>::Item: AsFieldKey<S>,

Set the select fields (field projection).

Example

builder.select([NAME, EMAIL])
builder.select(vec![NAME, EMAIL])

// Backwards-compatible (still supported)
builder.select(&[&ID, &NAME, &EMAIL])

pub fn page_size(self, limit: u64) -> QueryBuilder<S>

Set the page size limit.

Example

builder.page_size(50)

pub fn build(self) -> ODataQuery

Build the final ODataQuery with computed filter hash.

The filter hash is computed using the stable hashing algorithm from pagination::short_filter_hash.

Trait Implementations

impl<S> Default for QueryBuilder<S>

where S: Schema,

fn default() -> QueryBuilder<S>

Returns the “default value” for a type.