Struct QueryFilter 

pub struct QueryFilter {
    pub conditions: Vec<FilterCondition>,
    pub sorts: Vec<SortSpec>,
    pub search: Option<String>,
    pub search_fields: Vec<String>,
    pub limit: Option<u32>,
    pub offset: Option<u32>,
    pub page: Option<u32>,
    pub cursor_after: Option<String>,
    pub cursor_before: Option<String>,
    pub estimate_total: bool,
    /* private fields */
}

Complete query filter specification

Fields

conditions: Vec<FilterCondition>

sorts: Vec<SortSpec>

search: Option<String>

search_fields: Vec<String>

limit: Option<u32>

offset: Option<u32>

page: Option<u32>

cursor_after: Option<String>

Keyset paging: the opaque cursor from a previous page’s next_cursor (forward walk). Takes precedence over page/offset.

cursor_before: Option<String>

Keyset paging: the opaque cursor from a previous page’s prev_cursor (backward walk — the query inverts and the page is reversed so it still reads forward).

estimate_total: bool

Replace the exact COUNT (a full scan of the filtered set) with the planner’s row estimate. Screens that need the exact figure use the separate count endpoint.

Implementations

impl QueryFilter

pub fn new() -> Self

Create a new empty query filter

pub fn add_condition(&mut self, condition: FilterCondition)

Add a filter condition

pub fn add_sort(&mut self, sort: SortSpec)

Add a sort specification

pub fn with_search(&mut self, search: String, fields: Vec<String>)

Set search term

pub fn with_pagination(&mut self, page: u32, limit: u32)

Set pagination

pub fn base_conditions(&self) -> &[String]

The base conditions this filter carries, in the order they were added.

pub fn build_where_clause(&self) -> (String, Vec<String>)

Build the complete WHERE clause.

The clause is a conjunction of independent groups: each base condition, the search, and the caller’s own conditions. Every group is parenthesised whenever there is more than one, so an OR inside the caller’s conditions (or inside a base condition) can only widen its own group and never escape the soft-delete guard, the company fence or the search. Parameters are numbered in the order the groups are emitted.

pub fn build_order_by_clause(&self) -> String

Build ORDER BY clause

pub fn has_uncast_value_conditions(&self) -> bool

True when some condition compares a value that carries no cast — see FilterCondition::needs_value_cast. The repository answers it by reading the table’s column types from the catalog before it builds the query.

pub fn needs_catalog_types(&self) -> bool

Whether the table’s catalog types must be read before this filter runs: a comparison has no cast yet, or a cast names a user-defined type without its schema.

pub fn has_conditions(&self) -> bool

Check if has any conditions

Trait Implementations

impl Clone for QueryFilter

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryFilter

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

Formats the value using the given formatter.

impl Default for QueryFilter

fn default() -> Self

Returns the “default value” for a type.