Struct SchemaCache 

pub struct SchemaCache { /* private fields */ }

A disk-backed schema cache with HTTP fetching and JSON parsing.

Schemas are fetched via HTTP and stored as <cache_dir>/<hash>.json where <hash> is a SHA-256 hex digest of the URI. When a schema is requested, the cache is checked first; on a miss the schema is fetched and written to disk for future use.

Implementations

impl SchemaCache

pub fn builder() -> SchemaCacheBuilder

Returns a builder pre-configured with sensible defaults.

• cache_dir = ensure_cache_dir()
• ttl = DEFAULT_SCHEMA_CACHE_TTL
• force_fetch = false

pub fn memory() -> Self

Test constructor — memory-only, no HTTP, no disk.

Pre-populate with insert. Calls to fetch for unknown URIs will error.

pub fn insert(&self, uri: &str, value: Value)

Insert a value into the in-memory cache (useful for tests).

pub async fn fetch( &self, uri: &str, ) -> Result<(Value, CacheStatus), Box<dyn Error + Send + Sync>>

Fetch a schema by URI, using the disk cache when available.

Returns the parsed schema and a CacheStatus indicating whether the result came from the disk cache, the network, or caching was disabled.

When skip_read is set, the cache read is skipped but fetched schemas are still written to disk.

Errors

Returns an error if the schema cannot be fetched from the network, read from disk cache, or parsed as JSON.

pub fn hash_uri(uri: &str) -> String

Compute the SHA-256 hash of a URI, returned as a 64-char hex string.

Trait Implementations

impl AsyncRetrieve for SchemaCache

fn retrieve<'life0, 'life1, 'async_trait>( &'life0 self, uri: &'life1 Uri<String>, ) -> Pin<Box<dyn Future<Output = Result<Value, Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

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

Asynchronously retrieve a resource from the given URI.

impl Clone for SchemaCache

fn clone(&self) -> SchemaCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.