Struct RemoteDocument

pub struct RemoteDocument<I = IriBuf, T = Value> {
    pub url: Option<I>,
    pub content_type: Option<Mime>,
    pub context_url: Option<I>,
    pub profile: HashSet<Profile<I>>,
    pub document: T,
}

Remote document.

Stores the content of a loaded remote document along with its original URL.

Fields

url: Option<I>

The final URL of the loaded document, after eventual redirection.

content_type: Option<Mime>

The HTTP Content-Type header value of the loaded document, exclusive of any optional parameters.

context_url: Option<I>

If available, the value of the HTTP Link Header RFC 8288 using the http://www.w3.org/ns/json-ld#context link relation in the response.

If the response’s Content-Type is application/ld+json, the HTTP Link Header is ignored. If multiple HTTP Link Headers using the http://www.w3.org/ns/json-ld#context link relation are found, the loader fails with a multiple context link headers error.

profile: HashSet<Profile<I>>

document: T

The retrieved document.

Implementations

impl<I, T> RemoteDocument<I, T>

pub fn new( url: Option<I>, content_type: Option<Mime>, document: T, ) -> RemoteDocument<I, T>

Creates a new remote document.

url is the final URL of the loaded document, after eventual redirection. content_type is the HTTP Content-Type header value of the loaded document, exclusive of any optional parameters.

pub fn new_full( url: Option<I>, content_type: Option<Mime>, context_url: Option<I>, profile: HashSet<Profile<I>>, document: T, ) -> RemoteDocument<I, T>

Creates a new remote document.

url is the final URL of the loaded document, after eventual redirection. content_type is the HTTP Content-Type header value of the loaded document, exclusive of any optional parameters. context_url is the value of the HTTP Link Header RFC 8288 using the http://www.w3.org/ns/json-ld#context link relation in the response, if any. profile is the value of any profile parameter retrieved as part of the original contentType.

pub fn map<U>(self, f: impl Fn(T) -> U) -> RemoteDocument<I, U>

Maps the content of the remote document.

pub fn try_map<U, E>( self, f: impl Fn(T) -> Result<U, E>, ) -> Result<RemoteDocument<I, U>, E>

Tries to map the content of the remote document.

pub fn map_iris<J>(self, f: impl FnMut(I) -> J) -> RemoteDocument<J, T>

where J: Eq + Hash,

Maps all the IRIs.

pub fn url(&self) -> Option<&I>

Returns a reference to the final URL of the loaded document, after eventual redirection.

pub fn content_type(&self) -> Option<&Mime>

Returns the HTTP Content-Type header value of the loaded document, exclusive of any optional parameters.

pub fn context_url(&self) -> Option<&I>

Returns the value of the HTTP Link Header RFC 8288 using the http://www.w3.org/ns/json-ld#context link relation in the response, if any.

If the response’s Content-Type is application/ld+json, the HTTP Link Header is ignored. If multiple HTTP Link Headers using the http://www.w3.org/ns/json-ld#context link relation are found, the loader fails with a multiple context link headers error.

pub fn document(&self) -> &T

Returns a reference to the content of the document.

pub fn document_mut(&mut self) -> &mut T

Returns a mutable reference to the content of the document.

pub fn into_document(self) -> T

Drops the original URL and returns the content of the document.

pub fn into_url(self) -> Option<I>

Drops the content and returns the original URL of the document.

pub fn set_url(&mut self, url: Option<I>)

Sets the URL of the document.

Trait Implementations

impl<I, B> Borrow<RemoteDocument<I>> for Document<I, B>

fn borrow(&self) -> &RemoteDocument<I>

Immutably borrows from an owned value.

impl<I, T> Clone for RemoteDocument<I, T>

where I: Clone, T: Clone,

fn clone(&self) -> RemoteDocument<I, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I, T> Debug for RemoteDocument<I, T>

where I: Debug, T: Debug,

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

Formats the value using the given formatter.

impl<Iri> Expand<Iri> for RemoteDocument<Iri>

Remote document expansion.

The default base URL given to the expansion algorithm is the URL of the remote document.

fn default_base_url(&self) -> Option<&Iri>

Returns the default base URL passed to the expansion algorithm and used to initialize the default empty context when calling Expand::expand or Expand::expand_with.

async fn expand_full<N, L, W>( &self, vocabulary: &mut N, context: Context<Iri, <N as BlankIdVocabulary>::BlankId>, base_url: Option<&Iri>, loader: &L, options: Options, warnings_handler: W, ) -> Result<ExpandedDocument<Iri, <N as BlankIdVocabulary>::BlankId>, Error>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, <N as BlankIdVocabulary>::BlankId: Clone + Eq + Hash, L: Loader, W: WarningHandler<N>,

Expand the document with full options.

async fn expand_with<'a, N, L>( &'a self, vocabulary: &'a mut N, loader: &'a L, ) -> Result<ExpandedDocument<Iri, <N as BlankIdVocabulary>::BlankId>, Error>

where N: VocabularyMut<Iri = Iri>, Iri: 'a + Clone + Eq + Hash, <N as BlankIdVocabulary>::BlankId: 'a + Clone + Eq + Hash, L: Loader,

Expand the input JSON-LD document with the given vocabulary to interpret identifiers.

async fn expand<'a, L>( &'a self, loader: &'a L, ) -> Result<ExpandedDocument<Iri>, Error>

where (): VocabularyMut<Iri = Iri>, Iri: 'a + Clone + Eq + Hash, L: Loader,

Expand the input JSON-LD document.

impl<I> JsonLdProcessor<I> for RemoteDocument<I>

async fn compare_full<N>( &self, other: &Self, vocabulary: &mut N, loader: &impl Loader, options: Options<I>, warnings: impl WarningHandler<N> + WarningHandler<N>, ) -> CompareResult

where N: VocabularyMut<Iri = I>, I: Clone + Eq + Hash, N::BlankId: Clone + Eq + Hash,

Compare this document against other with a custom vocabulary using the given options and warnings handler.

async fn expand_full<N>( &self, vocabulary: &mut N, loader: &impl Loader, options: Options<I>, warnings: impl WarningHandler<N> + WarningHandler<N>, ) -> ExpandResult<I, N::BlankId>

where N: VocabularyMut<Iri = I>, I: Clone + Eq + Hash, N::BlankId: Clone + Eq + Hash,

Expand the document with the given vocabulary and loader, using the given options and warning handler.

async fn into_document_full<'a, N>( self, vocabulary: &'a mut N, loader: &'a impl Loader, options: Options<I>, warnings: impl 'a + WarningHandler<N> + WarningHandler<N>, ) -> IntoDocumentResult<I, N::BlankId>

where N: VocabularyMut<Iri = I>, I: 'a + Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

async fn compact_full<'a, N>( &'a self, vocabulary: &'a mut N, context: RemoteContextReference<I>, loader: &'a impl Loader, options: Options<I>, warnings: impl 'a + WarningHandler<N> + WarningHandler<N>, ) -> CompactResult

where N: VocabularyMut<Iri = I>, I: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Compact the document relative to context with the given vocabulary and loader, using the given options and warning handler.

async fn flatten_full<'a, N>( &'a self, vocabulary: &'a mut N, generator: &'a mut impl Generator<N>, context: Option<RemoteContextReference<I>>, loader: &'a impl Loader, options: Options<I>, warnings: impl 'a + WarningHandler<N> + WarningHandler<N>, ) -> FlattenResult<I, N::BlankId>

where N: VocabularyMut<Iri = I>, I: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Flatten the document with the given vocabulary, generator and loader, using the given options and warning handler.

async fn compare_with_using<'a, N>( &'a self, other: &'a Self, vocabulary: &'a mut N, loader: &'a impl Loader, options: Options<Iri>, ) -> CompareResult

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Compare this document against other with a custom vocabulary using the given options.

async fn compare_with<'a, N>( &'a self, other: &'a Self, vocabulary: &'a mut N, loader: &'a impl Loader, ) -> CompareResult

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Compare this document against other with a custom vocabulary.

async fn compare_using<'a>( &'a self, other: &'a Self, loader: &'a impl Loader, options: Options<Iri>, ) -> CompareResult

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Compare this document against other using the given options.

async fn compare<'a>( &'a self, other: &'a Self, loader: &'a impl Loader, ) -> CompareResult

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Compare this document against other with a custom vocabulary.

async fn expand_with_using<'a, N>( &'a self, vocabulary: &'a mut N, loader: &'a impl Loader, options: Options<Iri>, ) -> ExpandResult<Iri, N::BlankId>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Expand the document with the given vocabulary and loader, using the given options.

async fn expand_with<'a, N>( &'a self, vocabulary: &'a mut N, loader: &'a impl Loader, ) -> ExpandResult<Iri, N::BlankId>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Expand the document with the given vocabulary and loader.

async fn expand_using<'a>( &'a self, loader: &'a impl Loader, options: Options<Iri>, ) -> ExpandResult<Iri, BlankIdBuf>

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Expand the document with the given loader using the given options.

async fn expand<'a>( &'a self, loader: &'a impl Loader, ) -> ExpandResult<Iri, BlankIdBuf>

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Expand the document with the given loader.

async fn into_document_with_using<'a, N>( self, vocabulary: &'a mut N, loader: &'a impl Loader, options: Options<Iri>, ) -> IntoDocumentResult<Iri, N::BlankId>

where N: VocabularyMut<Iri = Iri>, Iri: 'a + Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

async fn into_document_with<'a, N>( self, vocabulary: &'a mut N, loader: &'a impl Loader, ) -> IntoDocumentResult<Iri, N::BlankId>

where N: VocabularyMut<Iri = Iri>, Iri: 'a + Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

async fn into_document<'a>( self, loader: &'a impl Loader, ) -> IntoDocumentResult<Iri, BlankIdBuf>

where (): VocabularyMut<Iri = Iri>, Iri: 'a + Clone + Eq + Hash,

async fn compact_with_using<'a, N>( &'a self, vocabulary: &'a mut N, context: RemoteContextReference<Iri>, loader: &'a impl Loader, options: Options<Iri>, ) -> CompactResult

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Compact the document relative to context with the given vocabulary and loader, using the given options.

async fn compact_with<'a, N>( &'a self, vocabulary: &'a mut N, context: RemoteContextReference<Iri>, loader: &'a impl Loader, ) -> CompactResult

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Compact the document relative to context with the given vocabulary and loader.

async fn compact_using<'a>( &'a self, context: RemoteContextReference<Iri>, loader: &'a impl Loader, options: Options<Iri>, ) -> CompactResult

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Compact the document relative to context with the given loader, using the given options.

async fn compact<'a>( &'a self, context: RemoteContextReference<Iri>, loader: &'a impl Loader, ) -> CompactResult

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Compact the document relative to context with the given loader.

async fn flatten_with_using<'a, N>( &'a self, vocabulary: &'a mut N, generator: &'a mut impl Generator<N>, loader: &'a impl Loader, options: Options<Iri>, ) -> FlattenResult<Iri, N::BlankId>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Flatten the document with the given vocabulary, generator and loader, using the given options.

async fn flatten_with<'a, N>( &'a self, vocabulary: &'a mut N, generator: &'a mut impl Generator<N>, loader: &'a impl Loader, ) -> FlattenResult<Iri, N::BlankId>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: 'a + Clone + Eq + Hash,

Flatten the document with the given vocabulary, generator and loader.

async fn flatten_using<'a>( &'a self, generator: &'a mut impl Generator, loader: &'a impl Loader, options: Options<Iri>, ) -> FlattenResult<Iri, BlankIdBuf>

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Flatten the document with the given generator, loader and using the given options.

async fn flatten<'a>( &'a self, generator: &'a mut impl Generator, loader: &'a impl Loader, ) -> FlattenResult<Iri, BlankIdBuf>

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash,

Flatten the document with the given generator and loader.

async fn to_rdf_full<N, G>( &self, vocabulary: N, generator: G, loader: &impl Loader, options: Options<Iri>, warnings: impl WarningHandler<N> + WarningHandler<N>, ) -> ToRdfResult<N, G>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: Clone + Eq + Hash, G: Generator<N>,

Serializes the document into an RDF dataset with a custom vocabulary using the given options and warnings handler.

async fn to_rdf_with_using<N, G>( &self, vocabulary: N, generator: G, loader: &impl Loader, options: Options<Iri>, ) -> ToRdfResult<N, G>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: Clone + Eq + Hash, G: Generator<N>,

Serializes the document into an RDF dataset with a custom vocabulary using the given options.

async fn to_rdf_with<N, G>( &self, vocabulary: N, generator: G, loader: &impl Loader, ) -> ToRdfResult<N, G>

where N: VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, N::BlankId: Clone + Eq + Hash, G: Generator<N>,

Serializes the document into an RDF dataset with a custom vocabulary.

async fn to_rdf_using<G>( &self, generator: G, loader: &impl Loader, options: Options<Iri>, ) -> ToRdfResult<(), G>

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, G: Generator,

Serializes the document into an RDF dataset using the given options.

async fn to_rdf<G>( &self, generator: G, loader: &impl Loader, ) -> ToRdfResult<(), G>

where (): VocabularyMut<Iri = Iri>, Iri: Clone + Eq + Hash, G: Generator,

Serializes the document into an RDF dataset.