Struct DocumentCache 

pub struct DocumentCache { /* private fields */ }

Generic JSON document cache shared by metadata and JWKS layers.

Implementations

impl DocumentCache

pub fn new( fetcher: DocumentFetcherFn, refresh_seconds: u64, document_type: impl Into<String>, on_change: Option<DocumentChangeCallback>, ) -> Arc<Self>

Build a new cache with default error factory (transport_error).

pub fn with_error_factory( fetcher: DocumentFetcherFn, refresh_seconds: u64, document_type: impl Into<String>, on_change: Option<DocumentChangeCallback>, error_factory: Box<dyn Fn(&str) -> AuthplaneError + Send + Sync>, ) -> Arc<Self>

Build a cache with a custom error factory (e.g. JwksFetchError).

pub fn document_type(&self) -> &str

Document type label.

pub fn refresh_seconds(&self) -> u64

Configured refresh interval in seconds.

pub async fn get(&self, force_refresh: bool) -> Result<Value, AuthplaneError>

Return the cached document, fetching or refreshing as needed.

Concurrent callers serialise behind an internal mutex so only one fetch is in flight at a time. On fetch errors a stale cache is served, silently — the crate carries no logging facility, so the failed refresh leaves no trace; if no cache existed yet, the error factory is invoked.

pub async fn aclose(&self)

Cancel the background refresh task (if any). Safe to call multiple times.

Trait Implementations

impl Debug for DocumentCache

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

Formats the value using the given formatter.