Skip to main content

Operator

Enum Operator 

Source
#[non_exhaustive]
pub enum Operator { And, Or, Not, }
Expand description

Logical operator for combining filter conditions (RFC 8620 §5.5).

§Excluded from extras preservation

This enum is out of scope for the workspace extras-preservation policy: it carries no Other(String) catch-all variant, and backends must dispatch on its known variants (AND, OR, NOT) to evaluate a filter tree. An Other operator would be meaningless — a server that cannot interpret the operator cannot evaluate the filter, and silently round- tripping it back to the client would yield wrong query results.

More broadly, filter algebra (this enum and the per-object FilterCondition / Comparator types) is excluded because unrecognised filter clauses are a query-correctness hazard: silently dropping or round-tripping a clause the server does not understand can return the wrong set of records to the client without any error signal.

§What to do instead

IETF-track path. Vendors who need both capability-level declaration and filterability for custom fields should use draft-ietf-jmap-metadata (capability URI urn:ietf:params:jmap:metadata), which adds namespace-keyed metadata / privateMetadata properties to each listed data type, with per-type schema discovery via the capability’s dataTypes (namespaces / supportsVendorNamespaces / maxDepth) and metadataExists / metadataTextContains / metadataTextEquals conditions on that type’s own /query filter (draft-ietf-jmap-metadata-04 §1.2.1, §3.6). Helpers live in jmap-metadata-types, jmap-metadata-server, and jmap-metadata-client.

Pre-IETF escape. Vendors who cannot wait for the metadata draft can either escape the filter tree to serde_json::Value or fork the per-crate FilterCondition type. See crate-jmap-calendars-types/PLAN.md for the hybrid sloppy-value pattern.

Cross-reference: bd JMAP-lbdy “Decision: filter algebra excluded”.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

And

Logical AND: all sub-filters must match (RFC 8620 §5.5).

§

Or

Logical OR: at least one sub-filter must match (RFC 8620 §5.5).

§

Not

Logical NOT: none of the sub-filters may match (RFC 8620 §5.5).

Trait Implementations§

Source§

impl Clone for Operator

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Operator

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for Operator

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for Operator

Source§

impl PartialEq for Operator

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for Operator

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for Operator

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.