Struct CallbackDataCache 

pub struct CallbackDataCache { /* private fields */ }

A custom cache for storing the callback data of an ExtBot.

Internally, it keeps two mappings with fixed maximum size:

• One for mapping the data received in callback queries to the cached objects.
• One for mapping the IDs of received callback queries to the cached objects.

The second mapping allows manually dropping data cached for keyboards of messages sent via inline mode. If necessary, the least recently used items are evicted.

Implementations

impl CallbackDataCache

pub fn new(maxsize: usize) -> Self

Creates a new CallbackDataCache.

Arguments

• maxsize - Maximum number of items in each of the internal mappings.

pub fn load_persistence_data(&mut self, data: CdcData)

Loads persisted data into the cache.

pub fn maxsize(&self) -> usize

The maximum size of the cache.

pub fn persistence_data(&self) -> CdcData

Returns the data that needs to be persisted.

pub fn process_keyboard( &mut self, reply_markup: &InlineKeyboardMarkup, ) -> InlineKeyboardMarkup

Registers the reply markup in the cache.

If any of the buttons have callback_data, stores that data and builds a new keyboard with the correspondingly replaced buttons. Otherwise, returns the original reply markup unchanged.

pub fn extract_uuids(callback_data: &str) -> (&str, &str)

Extracts keyboard uuid and button uuid from a raw callback data string.

The first 32 characters are the keyboard uuid, the rest is the button uuid.

pub fn process_message_value(&mut self, message: &mut Value) -> Option<String>

Replaces the data in the inline keyboard attached to a raw JSON message value.

Works with Message.reply_markup being Option<Value> (the raw type from the rust-tg-bot-raw crate).

Returns the keyboard UUID if resolution succeeded.

pub fn process_callback_query(&mut self, callback_query: &mut CallbackQuery)

Replaces the data in the callback query (and attached message keyboard) with cached objects.

In place – modifies the passed CallbackQuery.

pub fn drop_data( &mut self, callback_query_id: &str, ) -> Result<(), InvalidCallbackData>

Deletes the data for the specified callback query.

Errors

Returns Err if the callback query is not found in the cache.

pub fn clear_callback_data(&mut self, time_cutoff: Option<f64>)

Clears the stored callback data.

If time_cutoff is provided, only entries older than that UNIX timestamp are cleared.

pub fn clear_callback_queries(&mut self)

Clears all stored callback query IDs.

Trait Implementations

impl Clone for CallbackDataCache

fn clone(&self) -> CallbackDataCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CallbackDataCache

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

Formats the value using the given formatter.