@comunica/actor-rdf-parse-jsonld

Comunica JSON-LD RDF Parse Actor

An RDF Parse actor that handles JSON-LD.

This module is part of the Comunica framework, and should only be used by developers that want to build their own query engine.

Click here if you just want to query with Comunica.

Install

$ yarn add @comunica/actor-rdf-parse-jsonld

Configure

After installing, this package can be added to your engine's configuration as follows:

{
  "@context": [
    ...
    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-rdf-parse-jsonld/^3.0.0/components/context.jsonld"
  ],
  "actors": [
    ...
    {
      "@id": "urn:comunica:default:rdf-parse/actors#jsonld",
      "@type": "ActorRdfParseJsonLd",
      "priorityScale": 0.9,
      "mediatorHttp": { "@id": "urn:comunica:default:http/mediators#main" }
    }
  ]
}

Config Parameters

• priorityScale: An optional priority for this parser, used for content negotiation, defaults to 1.
• mediatorHttp: A mediator over the HTTP bus, for fetching remote JSON-LD contexts.

Passing custom options

If you want to pass custom options to the JSON-LD parser, you can use the '@comunica/actor-rdf-parse-jsonld:parserOptions' context entry to provide parser options as a hash.

Using a custom document loader

If you want to override how the JSON-LD parser loads external contexts, you can pass a custom document loader via the '@comunica/actor-rdf-parse-jsonld:documentLoader' context entry. This document loader must implement the IDocumentLoader interface.

Enabling stricter parsing mode

Via the '@comunica/actor-rdf-parse-jsonld:strictValues' context entry, you can set the JSON-LD parser to run in a more strict mode. This corresponds to the strictValues option in JSON-LD Streaming Parser.

Changelog

v3.0.1 - 2024-03-19

BREAKING CHANGES

• Rename sparqlee-specific package names
  • @comunica/actor-query-operation-filter-sparqlee -> @comunica/actor-query-operation-filter
  • @comunica/actor-query-operation-orderby-sparqlee -> @comunica/actor-query-operation-orderby
• Generalize sources to accept all query operations
  • The rdf-resolve-quad-pattern bus has been removed in favor of the new query-source-identify bus. This bus enables identification of IQuerySource's which can accept any kind of query operation, not just quad patterns like before.
  • brTPF support is added.
  • Bound joins are supported: pushing bindings into sources (FedX)
  • Several context-preprocess actors are added due to this, which offer:
    • Grouping operations into sources during federated querying (FedX)
    • Pushing down filters into sources
    • Skolemization of blank nodes
• Move sequential query process steps to separate bus and actor
• Move context shortcut handling to preprocess actor

Added

• Allow Bindings to have contexts
• Add timeout for sparql endpoint count queries
• Process source contexts to support shortcuts
• Add option to disable caching (#1297)
• Allow sources to be annotated with traverse flag

Fixed

• Fix GROUP_CONCAT losing languages if equal

Changed

• Update to asynciterator 3.9.0 to make results async iterable
• Ensure QueryEngine instances are fully independent
• Update to Components.js v6

<a name="v2.10.2"></a>