Struct CacheManager 

pub struct CacheManager { /* private fields */ }

Cache manager for HTTP responses

This provides a foundation for HTTP caching that can be extended to use pingora-cache’s full capabilities when they stabilize.

Implementations

impl CacheManager

pub fn new() -> Self

Create a new cache manager

pub fn stats(&self) -> Arc<HttpCacheStats>

Get cache statistics

pub fn register_route(&self, route_id: &str, config: CacheConfig)

Register cache configuration for a route

pub fn get_route_config(&self, route_id: &str) -> Option<CacheConfig>

Get cache configuration for a route

pub fn is_enabled(&self, route_id: &str) -> bool

Check if caching is enabled for a route

pub fn generate_cache_key( method: &str, host: &str, path: &str, query: Option<&str>, ) -> String

Generate a cache key string from request info

pub fn is_method_cacheable(&self, route_id: &str, method: &str) -> bool

Check if a method is cacheable for a route

pub fn is_status_cacheable(&self, route_id: &str, status: u16) -> bool

Check if a status code is cacheable for a route

pub fn parse_max_age(header_value: &str) -> Option<u64>

Parse max-age from Cache-Control header value

pub fn is_no_cache(header_value: &str) -> bool

Check if Cache-Control indicates no caching

pub fn calculate_ttl( &self, route_id: &str, cache_control: Option<&str>, ) -> Duration

Calculate TTL from Cache-Control or use default

pub fn should_serve_stale( &self, route_id: &str, stale_duration: Duration, is_error: bool, ) -> bool

Determine if response should be served stale

pub fn route_count(&self) -> usize

Get count of registered routes with caching

pub fn purge(&self, path: &str) -> usize

Purge a single cache entry by exact key (path).

Returns the number of entries purged (0 or 1). The purge is tracked so that subsequent cache hits for this key will be invalidated via ForcedInvalidationKind.

pub fn purge_wildcard(&self, pattern: &str) -> usize

Purge cache entries matching a wildcard pattern.

Supports glob-style patterns:

• * matches any sequence of characters except /
• ** matches any sequence of characters including /
• ? matches any single character

Returns the number of pattern registrations (actual purges happen on cache hit).

pub fn should_invalidate(&self, cache_key: &str) -> bool

Check if a cache key should be invalidated due to a purge request.

This is called from cache_hit_filter to determine if a cached response should be re-fetched from upstream.

pub fn active_purge_count(&self) -> usize

Get count of active purge entries (for stats/debugging)

Trait Implementations

impl Default for CacheManager

fn default() -> Self

Returns the “default value” for a type.