Jelly-JVM
Jelly-JVM is an implementation of the Jelly serialization format and the gRPC streaming protocol for the Java Virtual Machine (JVM), written in Scala 3. The supported RDF libraries are Apache Jena and Eclipse RDF4J.
This collection of libraries aims to provide the full stack of utilities for fast and scalable RDF streaming with the Jelly protocol.
Getting started with plugins – no code required
See the Getting started guide for a quick way to use Jelly with your Apache Jena or RDF4J application without writing any code.
Getting started for developers
If you want to use the full feature set of Jelly-JVM in your code, see the Getting started guide for developers.
TODO: versioning – point to the version selector in the navbar
0.12.1
dev
Library modules
The implementation is split into a few modules that can be used separately:
-
jelly-core
– implementation of the Jelly serialization format (using the scalapb library), along with generic utilities for converting the deserialized RDF data to/from the representations of RDF libraries (like Apache Jena or RDF4J). -
jelly-jena
– conversions and interop code for the Apache Jena library. -
jelly-rdf4j
– conversions and interop code for the RDF4J library. -
jelly-stream
– utilities for building Reactive Streams of RDF data (based on Pekko Streams). Useful for integrating with gRPC or other streaming protocols (e.g., Kafka, MQTT). -
jelly-grpc
– implementation of a gRPC client and server for the Jelly gRPC streaming protocol.
TODO: PLUGIN JARS
Compatibility
The Jelly-JVM implementation is compatible with Java 11 and newer. Java 11, 17, and 21 are tested in CI and are guaranteed to work. Jelly is built with Scala 3 LTS releases.
The following table shows the compatibility of the Jelly-JVM implementation with other libraries:
Jelly | Scala | Java | RDF4J | Apache Jena | Apache Pekko |
---|---|---|---|---|---|
1.0.x (current) | 3.3.x (LTS) | 11+ | 4.x.y | 4.x.y | 1.0.x |
Documentation
Below is a list of all documentation pages about Jelly-JVM. You can also browse the Javadoc using the badges in the module list above. The documentation uses examples written in Scala, but the libraries can be used from Java as well.
- Getting started with Jena/RDF4J plugins – how to use Jelly-JVM as a plugin for Apache Jena or RDF4J, without writing any code.
- Getting started for developers – how to use Jelly-JVM in code.
- User guide
- Developer guide
- Main Jelly website – including the Jelly protocol specification and explanation of the the various stream types.