Struct MetadataFilterBuilder 

pub struct MetadataFilterBuilder { /* private fields */ }

Builder for MetadataFilter.

Predicates without an explicit connector (eq, gt, exists, and so on) are appended with logical AND. Use or_* methods or group methods for more complex expressions.

Implementations

impl MetadataFilterBuilder

pub fn build(self) -> MetadataFilter

Builds an immutable MetadataFilter.

pub fn build_checked( self, schema: &MetadataSchema, ) -> MetadataResult<MetadataFilter>

Builds an immutable filter and validates it against schema.

Errors

Returns an error when the filter references unknown schema fields, uses range operators on non-comparable field types, or compares a field with an incompatible value type.

pub fn with_options(self, options: FilterMatchOptions) -> Self

Replaces the match options used by the built filter.

pub fn missing_key_policy(self, missing_key_policy: MissingKeyPolicy) -> Self

Sets how the built filter treats missing keys in negative predicates.

pub fn number_comparison_policy( self, number_comparison_policy: NumberComparisonPolicy, ) -> Self

Sets how the built filter handles mixed numeric comparisons.

pub fn eq<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends an equality predicate with AND: key == value.

pub fn ne<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a not-equal predicate with AND: key != value.

pub fn lt<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a less-than predicate with AND: key < value.

pub fn le<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a less-than-or-equal predicate with AND: key <= value.

pub fn gt<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a greater-than predicate with AND: key > value.

pub fn ge<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a greater-than-or-equal predicate with AND: key >= value.

pub fn in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, Value: ValueConstructor<T>,

Appends an inclusion predicate with AND: key is in values.

pub fn not_in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, Value: ValueConstructor<T>,

Appends an exclusion predicate with AND: key is not in values.

pub fn exists(self, key: &str) -> Self

Appends an existence predicate with AND.

pub fn not_exists(self, key: &str) -> Self

Appends a non-existence predicate with AND.

pub fn and_eq<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends an equality predicate with AND: key == value.

pub fn and_ne<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a not-equal predicate with AND: key != value.

pub fn and_lt<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a less-than predicate with AND: key < value.

pub fn and_le<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a less-than-or-equal predicate with AND: key <= value.

pub fn and_gt<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a greater-than predicate with AND: key > value.

pub fn and_ge<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a greater-than-or-equal predicate with AND: key >= value.

pub fn and_in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, Value: ValueConstructor<T>,

Appends an inclusion predicate with AND: key is in values.

pub fn and_not_in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, Value: ValueConstructor<T>,

Appends an exclusion predicate with AND: key is not in values.

pub fn and_exists(self, key: &str) -> Self

Appends an existence predicate with AND.

pub fn and_not_exists(self, key: &str) -> Self

Appends a non-existence predicate with AND.

pub fn or_eq<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends an equality predicate with OR: key == value.

pub fn or_ne<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a not-equal predicate with OR: key != value.

pub fn or_lt<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a less-than predicate with OR: key < value.

pub fn or_le<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a less-than-or-equal predicate with OR: key <= value.

pub fn or_gt<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a greater-than predicate with OR: key > value.

pub fn or_ge<T>(self, key: &str, value: T) -> Self

where Value: ValueConstructor<T>,

Appends a greater-than-or-equal predicate with OR: key >= value.

pub fn or_in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, Value: ValueConstructor<T>,

Appends an inclusion predicate with OR: key is in values.

pub fn or_not_in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, Value: ValueConstructor<T>,

Appends an exclusion predicate with OR: key is not in values.

pub fn or_exists(self, key: &str) -> Self

Appends an existence predicate with OR.

pub fn or_not_exists(self, key: &str) -> Self

Appends a non-existence predicate with OR.

pub fn and<F>(self, build: F) -> Self

where F: FnOnce(Self) -> Self,

Appends a grouped expression with AND.

The closure receives a fresh builder for the group. Policies configured inside the group are ignored; configure policies on the outer builder.

pub fn or<F>(self, build: F) -> Self

where F: FnOnce(Self) -> Self,

Appends a grouped expression with OR.

The closure receives a fresh builder for the group. Policies configured inside the group are ignored; configure policies on the outer builder.

pub fn and_not<F>(self, build: F) -> Self

where F: FnOnce(Self) -> Self,

Appends a negated grouped expression with AND.

pub fn or_not<F>(self, build: F) -> Self

where F: FnOnce(Self) -> Self,

Appends a negated grouped expression with OR.

pub fn not(self) -> Self

Negates the entire builder expression.

Trait Implementations

impl Clone for MetadataFilterBuilder

fn clone(&self) -> MetadataFilterBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetadataFilterBuilder

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

Formats the value using the given formatter.

impl Default for MetadataFilterBuilder

fn default() -> MetadataFilterBuilder

Returns the “default value” for a type.

impl PartialEq for MetadataFilterBuilder

fn eq(&self, other: &MetadataFilterBuilder) -> 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 MetadataFilterBuilder