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) -> MetadataResult<MetadataFilter>

Builds an immutable MetadataFilter.

Errors

Returns MetadataError::InvalidFilterExpression when the builder contains a structurally invalid expression such as an empty grouped expression.

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 expression is structurally invalid, 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 T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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>, T: IntoMetadataValue,

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>, T: IntoMetadataValue,

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 T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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>, T: IntoMetadataValue,

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>, T: IntoMetadataValue,

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 T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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

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

where T: IntoMetadataValue,

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>, T: IntoMetadataValue,

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>, T: IntoMetadataValue,

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