© Excellent backgrounds/Shutterstock.com
Teil 3: Möglichkeiten, mit Neo4j zu kommunizieren

Kennen Alben ihre Künstler?


Dieser Teil des Tutorials stellt die Möglichkeiten der JVM dar, mit Neo4j zu kommunizieren, und behandelt außerdem noch ein ungeliebtes, doch scheinbar notwendiges Thema: Die Abbildung von Datenbankstrukturen auf Objekte in der Anwendung. In der relationalen Welt sprechen wir von Object-relational Mapping (ORM), im Bereich der Graphendatenbanken von Object Graph Mapping (OGM). Nachdem Sie im vorherigen Teil dieser Artikelserie Neo4j und einige sanfte Grundlagen der Graphentheorie kennengelernt haben, möchte ich Ihnen im zweiten Teil zeigen, wie Sie Neo4j mit Daten befüllen können.

Auch wenn Neo4j ein „4j“ im Namen trägt und auf der JVM läuft: Die Datenbank ist selbstverständlich nicht nur von der JVM erreichbar. Für das binäre Bolt-Protokoll stehen offiziell Go-, Java-, JavaScript-, .NET- und Python-Treiber zur Verfügung [1].

Die Treiber werden mit der Prämisse entwickelt, eine möglichst einheitliche Oberfläche über Programmiersprachen hinweg zur Verfügung zu stellen. Auf der einen Seite wird damit zwar auf eine in der jeweiligen Sprache möglichst idiomatische Schnittstelle verzichtet, auf der anderen Seite ist es nicht schwierig, zwischen verschiedenen Sprachen zu wechseln. Für eine weitergehende Einbettung in die jeweiligen Ökosysteme stehen höherwertige Abstraktionen zur Verfügung, zum Beispiel GORM im Grails-Umfeld oder natürlich Neo4j-OGM und Spring Data Neo4j.

Was müssen Sie nun also machen, um die im vorherigen Teil importierten Künstlerdaten mittels Java-Treiber zu laden? Die Maven-Koordinaten lauten:

<dependency>
  <groupId>org.neo4j.driver</groupId>
  <artifactId>neo4j-java-driver</artifactId>
  <version>1.7.3</version>
</dependency>

Erstellen Sie ein Maven- (oder Gradle-)Projekt mit obiger Abhängigkeit und einer Java-Klasse ähnlich wie in Listing 1.

Listing 1: Einfacher Abruf eines „ResultSet“

public class HelloWorld {
  public static void main(String... a) {
    try (
      Driver driver =
        GraphDatabase.driver("bolt://localhost:7687d", AuthTokens.basic("neo4j", "JavaMagazin")); (1)
      Session session = driver.session() (2)
    ) {
      List<String> artistNames = session
        .readTransaction(tx -> tx.run("MATCH (a:Artist) RETURN a", Collections.emptyMap())) (3)
        .list(record -> record.get("a").get("name").asString()); (4)
    }
  }
}
  • (1) Hier erstellen Sie die Treiberinstanz. Diese ist langlebig und Thread-safe und kann über den Lebenszeitraum der Anwendung genutzt werden.

  • (2) Innerhalb einer konkreten Session werden eine oder mehrere Transaktionen geöffnet, genutzt und wieder geschlossen. Sessions sind kurzlebige Objekte und nicht Thread-safe.

  • (3) Cypher-Abfragen finden innerhalb einer Transaktion statt. Hier wird eine Transaktionsfunktion genutzt. Das Lambda arbeitet mit der konkreten Transaktion.

  • (4) Das Ergebnis einer Abfrage ist ein Result Set, das aus einem oder mehreren Records besteht. Records können skalare Werte gemäß des Cypher-Typsystems oder aber auch Objekte des Graphen, d. h. Nodes und Relationships, enthalten.

Driver und Session sind Auto-Closables. Transaktionen benötigen etwas mehr Aufmerksamkeit. Ihnen werden drei unterschiedliche Arten von Transaktionen innerhalb des Treibers begegnen:

  • Implizite bzw. Auto-Commit-Transaktionen: Diese Transaktionen werden automatisch über session.run und ähnliche Methoden eröffnet und nach der Abfrage geschlossen.

  • Transaktionsfunktionen wie in Listing 1: Mittels readTransaction oder writeTransaction werden Transaktionen eröffnet und als dezidiertes Objekt weitergeben und benutzbar gemacht.

  • Explizite Transaktionen: Schlussendlich steht mit Transaction transaction = session.beginTransaction() eine Methode zur Verfügung, die die volle Kontrolle über die Transaktion an den Clientcode übergibt. Das Transaktionsobjekt erlaubt explizites Festschreiben (commit) und Zurückrollen (rollback) einer Transaktion.

Unsere offizielle Empfehlung für Clientcode, der direkt mit dem Treiber arbeitet, ist in der Regel die Nutzung von transaktionalen Funktionen. Alle Treiber behandeln folgende Themen:

  • Authentifizierung

  • Routing

  • Causal Chaining

  • Read/Write-Zugriffe

Authentifizierung dürfte weitestgehend klar sein. In Listing 1 wird Basic-Auth genutzt. Um sich gegenüber einer in Ihrem LDAP-Cluster eingebundene Neo4j-Installation zu authentifizieren, nutzen Sie bitte GraphDatabase.driver(uri, AuthTokens.kerberos(ticket)).

Neo4j kann in einem Cluster betrieben werden. Diese Cluster können selbst aufgesetzt werden, über Neo4js Cloud-Offering oder zum Beispiel auf Googles Cloud-Computing-Plattform. Die Treiber sind dafür verantwortlich, die Adressen eines Clusters aufzulösen und festzustellen, welche Hosts Leader- und welche Hosts Follower-Rollen beinhalten.

Note: Es ist wichtig, dass Sie die Bedeutung des Zugriffsmodus (Access Mode) verstehen. Vermutlich geht es Ihnen bei der ersten Benutzung wie mir, und Sie erwarten, dass der Access Mode READ schreibende Zugriffe verhindert. Das ist erst einmal nicht der Fall. Der Zugriffsmodus ist insbesondere dann relevant, wenn Ihre Datenbank in einem Cluster und nicht als Single Instance betrieben wird. Der Zugriffsmodus wird dazu genutzt, möglichst viele Anfragen gezielt an tendenziell eher schwächere, dafür zahlenmäßig überlegende Read-Server zu routen. Die Treiber führen keine Überprüfung der Queries durch. Sollten Sie also für eine Session oder eine Transaktion angeben, dass sie read-only sein soll, Sie aber schreibende Abfragen ausführen, wird der Server diese mit einem Fehler quittieren.

Programmiermodelle

Zum Zeitpunkt, zu dem dieses Tutorial geschrieben wird, ist noch Version 1.7 des Java-Treibers aktuell. Diese Version unterstützt wie im obigen Beispiel klassische, blockierende Programmierung sowie ein asynchrones Programmiermodell. Das asynchrone Programmiermodell basiert auf Javas CompletionStage (Listing 2).

Listing 2: Asynchrone Verarbeitung

public class HelloWorld {
  public static void main(String... a) throws Exception {
    try (
      Driver driver = GraphDataba...

headline from sands settings