Struct ThumbnailCache 

pub struct ThumbnailCache {
    config: Arc<Mutex<CacheConfig>>,
    cache_dir: PathBuf,
}

Thumbnail cache with LRU eviction

Fields

config: Arc<Mutex<CacheConfig>>

cache_dir: PathBuf

Implementations

impl ThumbnailCache

pub fn new(app_data_dir: PathBuf, config: CacheConfig) -> Self

Create a new thumbnail cache

fn resolve_in_cache_dir(&self, filename: &str) -> Result<PathBuf, String>

Resolve a cache filename against the cache directory, refusing anything that lands outside it.

.. is folded away lexically rather than through canonicalize, so a file that does not exist yet still resolves — the same approach as media_server::resolve_path. safe_component should already have made an escape impossible; this is the check at the point of use.

TRACES: | DR-210 | UT-204

pub fn is_enabled(&self) -> bool

Check if caching is enabled

pub async fn get_cached_path( &self, db: Arc<RusqliteService>, item_id: &str, image_type: &str, tag: &str, ) -> Option<PathBuf>

Get cached thumbnail path, or None if not cached Updates last_accessed timestamp for LRU tracking

async fn touch( &self, db: &Arc<RusqliteService>, item_id: &str, image_type: &str, tag: Option<&str>, )

Update last_accessed for LRU tracking. When tag is Some, scope to that exact row; when None, touch every row for the item + type.

pub async fn save_thumbnail( &self, db: Arc<RusqliteService>, item_id: &str, image_type: &str, tag: &str, data: &[u8], width: Option<i32>, height: Option<i32>, ) -> Result<PathBuf, String>

Save thumbnail to cache

TRACES: | DR-210 | UT-204

async fn ensure_space( &self, db: Arc<RusqliteService>, needed_bytes: u64, ) -> Result<(), String>

Ensure there’s enough space by evicting LRU items if needed

async fn evict_lru( &self, db: Arc<RusqliteService>, to_free: u64, ) -> Result<(), String>

Evict least recently used items to free up space

pub async fn get_cache_size(&self, db: Arc<RusqliteService>) -> u64

Get current total cache size in bytes

pub async fn get_item_count(&self, db: Arc<RusqliteService>) -> i64

Get count of cached items

pub async fn get_limit(&self, db: Arc<RusqliteService>) -> u64

Get the current cache limit in bytes

pub async fn set_limit( &self, db: Arc<RusqliteService>, limit_bytes: u64, ) -> Result<(), String>

Set the cache limit in bytes

pub async fn clear_cache(&self, db: Arc<RusqliteService>) -> Result<(), String>

Clear all cached thumbnails

pub async fn delete_item( &self, db: Arc<RusqliteService>, item_id: &str, ) -> Result<(), String>

Delete cached thumbnail for a specific item