Enum RemoteDocumentReference 

pub enum RemoteDocumentReference<I = IriBuf, T = Value> {
    Iri(I),
    Loaded(RemoteDocument<I, T>),
}

Remote document, loaded or not.

Either an IRI or the actual document content.

Variants

Iri(I)

IRI to the remote document.

Loaded(RemoteDocument<I, T>)

Remote document content.

Implementations

impl<I, T> RemoteDocumentReference<I, T>

pub fn iri(iri: I) -> Self

Creates an IRI to a jstrict::Value JSON document.

This method can replace RemoteDocumentReference::Iri to help the type inference in the case where T = jstrict::Value.

impl<I> RemoteDocumentReference<I>

pub async fn load_with<V, L>( self, vocabulary: &mut V, loader: &L, ) -> LoadingResult<I, L::Error>

where V: IriVocabularyMut<Iri = I>, L: Loader, I: Clone + Eq + Hash,

Loads the remote document with the given vocabulary and loader.

If the document is already Self::Loaded, simply returns the inner RemoteDocument.

Errors

Returns the loader’s error when the document cannot be fetched or parsed.

pub async fn loaded_with<V, L>( &self, vocabulary: &mut V, loader: &L, ) -> Result<Cow<'_, RemoteDocument<V::Iri>>, LoadError<L::Error>>

where V: IriVocabularyMut<Iri = I>, L: Loader, I: Clone + Eq + Hash,

Loads the remote document with the given vocabulary and loader.

For Self::Iri returns an owned RemoteDocument with Cow::Owned. For Self::Loaded returns a reference to the inner RemoteDocument with Cow::Borrowed.

Errors

Returns the loader’s error when the document cannot be fetched or parsed.

impl<I> RemoteDocumentReference<I, Context>

pub async fn load_context_with<V, L: Loader>( self, vocabulary: &mut V, loader: &L, ) -> Result<RemoteContext<I>, ContextLoadError<L::Error>>

where V: IriVocabularyMut<Iri = I>, I: Clone + Eq + Hash,

Loads the remote context with the given vocabulary and loader.

If the context is already Self::Loaded, simply returns the inner RemoteContext.

Errors

Returns an error when the document cannot be fetched, or when it holds no @context entry.

pub async fn loaded_context_with<V, L: Loader>( &self, vocabulary: &mut V, loader: &L, ) -> Result<Cow<'_, RemoteContext<I>>, ContextLoadError<L::Error>>

where V: IriVocabularyMut<Iri = I>, I: Clone + Eq + Hash,

Loads the remote context with the given vocabulary and loader.

For Self::Iri returns an owned RemoteContext with Cow::Owned. For Self::Loaded returns a reference to the inner RemoteContext with Cow::Borrowed.

Errors

Returns an error when the document cannot be fetched, or when it holds no @context entry.

Trait Implementations

impl<I: Clone, T: Clone> Clone for RemoteDocumentReference<I, T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I: Debug, T: Debug> Debug for RemoteDocumentReference<I, T>

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

Formats the value using the given formatter.