Trait json_ld_core::loader::Loader

pub trait Loader {
    // Required method
    async fn load(&self, url: &Iri) -> Result<RemoteDocument<IriBuf>, LoadError>;

    // Provided method
    async fn load_with<V>(
        &self,
        vocabulary: &mut V,
        url: V::Iri,
    ) -> LoadingResult<V::Iri>
       where V: IriVocabularyMut,
             V::Iri: Clone + Eq + Hash { ... }
}

Document loader.

A document loader is required by most processing functions to fetch remote documents identified by an IRI. In particular, the loader is in charge of fetching all the remote contexts imported in a @context entry.

This library provides a few default loader implementations:

• NoLoader dummy loader that always fail. Perfect if you are certain that the processing will not require any loading.
• Standard HashMap and BTreeMap mapping IRIs to pre-loaded documents. This way no network calls are performed and the loaded content can be trusted.
• FsLoader that redirecting registered IRI prefixes to a local directory on the file system. This also avoids network calls. The loaded content can be trusted as long as the file system is trusted.
• ReqwestLoader actually downloading the remote documents using the reqwest library. This requires the reqwest feature to be enabled.

Required Methods

async fn load(&self, url: &Iri) -> Result<RemoteDocument<IriBuf>, LoadError>

Loads the document behind the given IRI.

Provided Methods

async fn load_with<V>( &self, vocabulary: &mut V, url: V::Iri, ) -> LoadingResult<V::Iri>

where V: IriVocabularyMut, V::Iri: Clone + Eq + Hash,

Loads the document behind the given IRI, using the given vocabulary.

Object Safety

This trait is not object safe.

Implementations on Foreign Types

impl Loader for BTreeMap<IriBuf, RemoteDocument>

async fn load(&self, url: &Iri) -> LoadingResult<IriBuf>

impl Loader for HashMap<IriBuf, RemoteDocument>

async fn load(&self, url: &Iri) -> LoadingResult<IriBuf>

impl<'l, L: Loader> Loader for &'l L

async fn load_with<V>( &self, vocabulary: &mut V, url: V::Iri, ) -> LoadingResult<V::Iri>

where V: IriVocabularyMut, V::Iri: Clone + Eq + Hash,

async fn load(&self, url: &Iri) -> Result<RemoteDocument<IriBuf>, LoadError>

impl<'l, L: Loader> Loader for &'l mut L

async fn load_with<V>( &self, vocabulary: &mut V, url: V::Iri, ) -> LoadingResult<V::Iri>

where V: IriVocabularyMut, V::Iri: Clone + Eq + Hash,

async fn load(&self, url: &Iri) -> Result<RemoteDocument<IriBuf>, LoadError>

Implementors

impl Loader for FsLoader

impl Loader for NoLoader

impl<L1, L2> Loader for ChainLoader<L1, L2>

where L1: Loader, L2: Loader,