Struct RemoteDocument 

pub struct RemoteDocument<I = Iri<String>, T = Value> {
    pub url: Option<I>,
    pub content_type: Option<MediaTypeBuf>,
    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<MediaTypeBuf>

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>>

Profiles advertised by the document’s media type.

document: T

The retrieved document.

Implementations

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

pub fn new( url: Option<I>, content_type: Option<MediaTypeBuf>, 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<MediaTypeBuf>, 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.

Errors

Returns whatever f returns for the contained 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<&MediaTypeBuf>

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.

impl<I> RemoteDocument<I>

pub fn from_value( url: Option<I>, content_type: Option<MediaTypeBuf>, document: impl Into<Value>, ) -> RemoteDocument<I>

Creates a remote document from any value convertible into a jstrict::Value.

With the serde_json feature enabled, this also accepts serde_json::Value thanks to the From<serde_json::Value> implementation provided by jstrict.

Trait Implementations

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>

A remote document knows where it comes from: its own URL is used as default base URL, so relative IRI references resolve as they would for a consumer fetching the document.

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

Returns the base URL the document is expanded against when none is given explicitly, as in Expand::expand and Expand::expand_with.

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

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

Expands the document, controlling every parameter of the algorithm.

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

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

Expands the document, interpreting identifiers with the given vocabulary.

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

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

Expands the document, keeping identifiers as IriBuf and BlankIdBuf values instead of interning them in a vocabulary.