Struct Filter 

pub struct Filter { /* private fields */ }

Raw parsed filter from query string.

Implements FromRequestParts so it can be used directly as an axum handler argument. Must be validated against a FilterSchema via validate before use in SQL generation.

Supported query-string syntax

Pattern	Meaning
field=value	Equality (=), or IN if multiple values
field.ne=value	Not equal (!=)
field.gt=value	Greater than (>)
field.gte=value	Greater than or equal (>=)
field.lt=value	Less than (<)
field.lte=value	Less than or equal (<=)
field.like=value	SQL LIKE
field.null=true	IS NULL / IS NOT NULL
sort=field	Sort ascending; sort=-field for descending; repeat for multi-column

Implementations

impl Filter

pub fn from_query_params(params: &HashMap<String, Vec<String>>) -> Self

Parse filter conditions from a pre-parsed query string map.

Pagination parameters (page, per_page, after) are silently skipped. Unknown operators are ignored.

pub fn validate(self, schema: &FilterSchema) -> Result<ValidatedFilter>

Validate against a schema, producing a ValidatedFilter.

Unknown columns are silently ignored. Sort fields not listed in the schema are dropped.

Errors

Returns a 400 error if a filter value cannot be converted to the declared FieldType (e.g., "abc" for an Int field).

Trait Implementations

impl<S: Send + Sync> FromRequestParts<S> for Filter

type Rejection = Error

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Self, Self::Rejection>

Perform the extraction.