Struct Cache

pub struct Cache { /* private fields */ }

Client for the cache API.

Reusing a single client for multiple requests is potentially more efficient due to connection reuse.

Implementations

impl Cache

pub fn new(user_agent: &str) -> Result<Self>

Creates a new client instance.

The passed user_agent should identify the program using this library.

pub async fn get_url( &self, key_space: &str, key_prefixes: &[&str], ) -> Result<Option<(CacheHit, String)>>

Performs a cache lookup and returns the URL for a matching entry.

• key_space - parameter is an identifier, usually a hex string, which must match exactly
• key_prefixes - list of key prefixes to look up in order of preference

See the official documentation for the precedence in case of multiple matching entries. Note that key_space is not exposed by the official client and thus not mentioned there.

pub async fn get_bytes( &self, key_space: &str, keys: &[&str], ) -> Result<Option<(CacheHit, Bytes)>>

Performs a cache lookup and returns the content of a matching entry.

See get_url for details about the lookup.

pub async fn put_bytes( &self, key_space: &str, key: &str, data: Bytes, ) -> Result<()>

Stores an entry in the cache.