Redis Client (Jedis) Java: Methoden, Beispiele…

Was ist Jedis und warum wird es benötigt?

Jedis ist eine minimalistische, leichtgewichtige und sehr beliebte Java-Bibliothek für die Arbeit mit Redis (Remote Dictionary Server). Redis ist ein leistungsstarkes In-Memory-Datenspeichersystem, das häufig als Datenbank, Cache und Message Broker eingesetzt wird. Jedis bietet eine einfache und intuitive API für die Interaktion mit einem Redis-Server aus Java-Anwendungen.

Warum wird Jedis benötigt? Wenn Ihre Java-Anwendung Redis zum Caching, zur Sitzungsverwaltung, für Aufgabenwarteschlangen oder zur Speicherung temporärer Daten nutzt, ist Jedis der direkteste und effizienteste Weg, um eine Verbindung zu Redis herzustellen. Es unterstützt alle wichtigen Redis-Datenstrukturen (Strings, Listen, Sets, Hashes, Sorted Sets) sowie Funktionen wie Pub/Sub, Transaktionen und Lua-Skripte.

Jedis ist bekannt für seine Einfachheit und das Fehlen überflüssiger Abhängigkeiten. Im Gegensatz zu schwereren Clients (z. B. Lettuce) erfordert Jedis keine sofortige Konfiguration eines Verbindungspools (obwohl es ihn unterstützt), was es zur idealen Wahl für kleine und mittlere Projekte macht, bei denen Einfachheit und Entwicklungsgeschwindigkeit im Vordergrund stehen.

Installation von Jedis

Jedis wird über Maven Central vertrieben. Um die Bibliothek in Ihr Projekt einzubinden, müssen Sie die Abhängigkeit in Ihre pom.xml-Datei (für Maven) oder build.gradle-Datei (für Gradle) aufnehmen.

Installation mit Maven

Fügen Sie den folgenden Block in Ihre pom.xml ein:

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>5.1.0</version> <!-- Verwenden Sie die neueste stabile Version -->
</dependency>

Installation mit Gradle

Fügen Sie die folgende Zeile in Ihre build.gradle ein:

implementation 'redis.clients:jedis:5.1.0'

Wichtig: Version 5.x ist das letzte große Update von Jedis, das Unterstützung für Redis 7.x und neue Funktionen bietet. Es wird empfohlen, immer die neueste stabile Version zu verwenden, um von allen Fehlerbehebungen und neuen Features zu profitieren.

Schnellstart mit einem Codebeispiel

Lassen Sie uns ein einfaches Programm schreiben, das eine Verbindung zu Redis herstellt, einen Wert speichert und ihn wieder ausliest.

Wir gehen davon aus, dass der Redis-Server lokal auf dem Standard-Port 6379 läuft.

import redis.clients.jedis.Jedis;

public class JedisQuickStart {
    public static void main(String[] args) {
        // 1. Verbindung zu Redis herstellen
        // Standardmäßig localhost:6379
        try (Jedis jedis = new Jedis("localhost", 6379)) {
            
            // 2. Verbindung testen (PING)
            String response = jedis.ping();
            System.out.println("Ping-Antwort: " + response); // Sollte "PONG" sein

            // 3. Wert speichern
            jedis.set("user:1000:name", "Alice");
            jedis.set("user:1000:age", "30");

            // 4. Wert auslesen
            String name = jedis.get("user:1000:name");
            String age = jedis.get("user:1000:age");

            System.out.println("Benutzername: " + name);
            System.out.println("Alter: " + age);

            // 5. Existenz eines Schlüssels prüfen
            boolean exists = jedis.exists("user:1000:name");
            System.out.println("Schlüssel existiert: " + exists);

            // 6. Schlüssel löschen
            long deleted = jedis.del("user:1000:age");
            System.out.println("Gelöschte Schlüssel: " + deleted);
        }
    }
}

Dieses Beispiel zeigt die grundlegende Arbeit: Verbindung, Schreiben, Lesen, Existenzprüfung und Löschen. Beachten Sie die Verwendung von try-with-resources – dies stellt sicher, dass die Verbindung nach der Nutzung geschlossen wird.

Wichtige Methoden von Jedis

Jedis bietet hunderte von Methoden, die alle Funktionen von Redis abdecken. Nachfolgend sind die 10 am häufigsten verwendeten Methoden mit detaillierter Beschreibung und Beispielen aufgeführt.