Struct FlatQueryParams 

pub struct FlatQueryParams {
    pub pagination: Option<QueryPaginationParams>,
    pub sort: Option<QuerySortParams>,
    pub search: Option<QuerySearchParams>,
    pub date_range: Option<QueryDateRangeParams>,
    pub filters: Option<HashMap<String, QueryFilterCondition>>,
}

Flattened query parameters suitable for deserializing from HTTP query strings.

This struct is designed to work with web frameworks’ query string deserializers. All fields are optional to allow partial parameter specification.

Filter Syntax

Supports both simple equality and advanced operator syntax:

• Simple: field=value → Equal operator
• With operator: field[op]=value → Specified operator

Examples

use sqlx_paginated::FlatQueryParams;
use serde::Deserialize;

// Simple equality filters:
// ?status=active&role=admin

// Advanced operator filters:
// ?price[gt]=10&stock[lte]=100&status[ne]=deleted
// ?role[in]=admin,moderator&deleted_at[is_null]=

// With Actix-web:
// async fn handler(Query(params): Query<FlatQueryParams>) { ... }

// With Axum:
// async fn handler(Query(params): Query<FlatQueryParams>) { ... }

Fields

pagination: Option<QueryPaginationParams>

Pagination parameters (page, page_size)

sort: Option<QuerySortParams>

Sort parameters (sort_column, sort_direction)

search: Option<QuerySearchParams>

Search parameters (search, search_columns)

date_range: Option<QueryDateRangeParams>

Date range parameters (date_column, date_after, date_before)

filters: Option<HashMap<String, QueryFilterCondition>>

Filter conditions with operators

Supports operator syntax in query strings:

• field=value → Equality
• field[gt]=value → Greater than
• field[in]=val1,val2 → In list
• field[is_null]= → Is null

See QueryFilterOperator for all supported operators.

Trait Implementations

impl Clone for FlatQueryParams

fn clone(&self) -> FlatQueryParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FlatQueryParams

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

Formats the value using the given formatter.

impl Default for FlatQueryParams

fn default() -> FlatQueryParams

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FlatQueryParams

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'q, T> From<FlatQueryParams> for QueryParams<'q, T>

fn from(params: FlatQueryParams) -> Self

Converts to this type from the input type.

impl Serialize for FlatQueryParams

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.