Skip to main content

Apache Jena

This page describes how to integrate FalkorDB with Apache Jena using the jena-falkordb-adapter.

Overview​

The jena-falkordb-adapter allows applications built on Jena to use FalkorDB as a backend for RDF data storage and querying. This enables seamless graph data management and SPARQL query execution on FalkorDB.

Getting Started​

Follow the GETTING_STARTED.md guide for step-by-step instructions on setting up the adapter and connecting Jena to FalkorDB.

Install from Maven​

Add the FalkorDB Jena adapter dependency to your project's pom.xml. Replace the version with the latest release from the adapter repository.

<dependency>
<groupId>com.falkordb</groupId>
<artifactId>jena-falkordb-adapter</artifactId>
<version>0.2.0</version>
</dependency>

If the adapter is published to a non-standard Maven repository, add the repository block shown in the adapter's README. Otherwise the dependency should resolve from Maven Central (if published there).

Quick Getting Started (Java)​

The snippet below shows a minimal Jena program that registers the FalkorDB adapter and runs a simple SPARQL query. This is intentionally small — see the adapter's GETTING_STARTED.md and Main.java for a complete example with configuration and connection options.

import org.apache.jena.query.*;
import org.apache.jena.rdf.model.Model;

public class JenaFalkorExample {
public static void main(String[] args) {
// Create or obtain a Jena Model backed by FalkorDB.
// The exact factory method depends on the adapter; check the adapter README/Main.java for the
// connection options (hostname, port, credentials, etc.).
Model model = FalkorDBJenaFactory.createModel("http://localhost:7474");

// Example: add a triple
model.createResource("http://example.org/alice")
.addProperty(model.createProperty("http://example.org/knows"),
model.createResource("http://example.org/bob"));

// Run a simple SPARQL SELECT
String sparql = "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10";
try (QueryExecution qexec = QueryExecutionFactory.create(sparql, model)) {
ResultSet rs = qexec.execSelect();
ResultSetFormatter.out(System.out, rs);
}

// Remember to close the model when finished
model.close();
}
}

Notes:

  • Replace FalkorDBJenaFactory.createModel(...) with the actual adapter factory call used in the adapter (see Main.java).
  • Use the adapter's configuration options (connection URL, authentication) when creating the model.

Usage Example​

See the Main.java for a sample Java application demonstrating how to use the adapter.

Reference​