Struct buildsrs_storage::Cache

pub struct Cache { /* private fields */ }

Storage caching layer.

This is a layer you can use to wrap an existing storage provider to add an in-memory cache. This allows you to serve commonly requested artifacts more efficiently.

The cache is implemented using the moka crate, which is optimized for highly concurrent, lock-free access.

Implementations

impl Cache

pub fn new(storage: AnyStorage, config: CacheConfig) -> Self

Create new caching layer on top of a storage.

You need to create a CacheConfig to create the cache, which specifies some important metrics such as the capacity of the cache. You can use CacheConfig::default() to use defaults, which should be sane. Read the documentation on CacheConfig for more information on what can be tuned.

pub fn storage(&self) -> &AnyStorage

Get a reference to the underlying storage.

pub fn clear(&self)

Clear the cache.

This will invalidate all cache entries.

Trait Implementations

impl Clone for Cache

fn clone(&self) -> Cache

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cache

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

Formats the value using the given formatter.

impl Storage for Cache

fn artifact_put<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, version: &'life1 ArtifactId, data: &'life2 [u8] ) -> Pin<Box<dyn Future<Output = Result<(), StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Put an artifact into storage.

fn artifact_get<'life0, 'life1, 'async_trait>( &'life0 self, version: &'life1 ArtifactId ) -> Pin<Box<dyn Future<Output = Result<ArtifactData, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get an artifact from storage.