Struct SearchAttributes 

pub struct SearchAttributes { /* private fields */ }

A collection of search attribute payloads, providing type-safe access via SearchAttributeKey.

Implementations

impl SearchAttributes

pub fn new( updates: impl IntoIterator<Item = SearchAttributeUpdate>, ) -> SearchAttributes

Construct from an iterator of SearchAttributeUpdates.

Updates with None payloads remove any existing entry for that key.

pub fn apply(&mut self, update: SearchAttributeUpdate)

Apply a single update to this collection. If the update sets a value, it is inserted (replacing any existing entry); if the update unsets a value, the entry is removed.

pub fn get<T>(&self, key: &SearchAttributeKey<T>) -> Option<T>

where T: SearchAttributeValue,

Retrieve a typed value. Returns None if the key is absent or deserialization fails (graceful degradation — no panic on type mismatch).

pub fn try_get<T>( &self, key: &SearchAttributeKey<T>, ) -> Result<Option<T>, SearchAttributeError>

where T: SearchAttributeValue,

Retrieve a typed value, distinguishing “key absent” from “deserialization failed”. Returns Ok(None) if the key is absent, Ok(Some(val)) on success, or Err if the payload is present but cannot be deserialized.

pub fn contains_key<T>(&self, key: &SearchAttributeKey<T>) -> bool

where T: SearchAttributeValue,

Returns true if a payload exists for the given key.

pub fn is_empty(&self) -> bool

Returns true if there are no search attributes.

pub fn len(&self) -> usize

Returns the number of search attributes.

pub fn keys(&self) -> impl Iterator<Item = &str>

Returns an iterator over the attribute names in this collection.

pub fn raw_payload(&self, name: &str) -> Option<&Payload>

Returns a reference to the raw payload for the given attribute name, if present. This is useful for advanced use cases such as forwarding payloads without deserializing them.

pub fn to_proto(&self) -> SearchAttributes

Convert to the proto wire representation.

pub fn into_proto(self) -> SearchAttributes

Convert to the proto wire representation, consuming self to avoid cloning.

pub fn from_proto(attrs: &SearchAttributes) -> SearchAttributes

Construct from the proto wire representation by cloning the inner map.

impl SearchAttributes

pub fn updates_to_proto( updates: impl IntoIterator<Item = SearchAttributeUpdate>, ) -> SearchAttributes

Convert to the proto representation, producing empty-data payloads for entries that were unset. This is used when building an upsert command that needs to explicitly clear attributes on the server.

Trait Implementations

impl Clone for SearchAttributes

fn clone(&self) -> SearchAttributes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchAttributes

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

Formats the value using the given formatter.

impl Default for SearchAttributes

fn default() -> SearchAttributes

Returns the “default value” for a type.

impl From<SearchAttributes> for SearchAttributes

fn from(attrs: SearchAttributes) -> SearchAttributes

Construct from an owned proto, moving the inner map without cloning.

impl PartialEq for SearchAttributes

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SearchAttributes