Struct SchemaCache 

pub struct SchemaCache<C: HttpClient = ReqwestClient> { /* private fields */ }

A disk-backed cache for JSON Schema files.

Schemas are fetched via HTTP and stored as <cache_dir>/<hash>.json where <hash> is a hex-encoded hash 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<C: HttpClient> SchemaCache<C>

pub fn new( cache_dir: Option<PathBuf>, client: C, skip_read: bool, ttl: Option<Duration>, ) -> Self

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

Trait Implementations

impl<C: HttpClient> AsyncRetrieve for SchemaCache<C>

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<C: Clone + HttpClient> Clone for SchemaCache<C>

fn clone(&self) -> SchemaCache<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.