Client Redis Jedis Java : méthodes, exemples, installation…

Qu'est-ce que Jedis et pourquoi l'utiliser ?

Jedis est une bibliothèque Java minimaliste, légère et très populaire pour interagir avec Redis (Remote Dictionary Server). Redis est un magasin de données en mémoire hautes performances, souvent utilisé comme base de données, cache et courtier de messages. Jedis offre une API simple et intuitive pour communiquer avec un serveur Redis depuis des applications Java.

Pourquoi utiliser Jedis ? Si votre application Java utilise Redis pour la mise en cache, la gestion des sessions, les files d'attente de tâches ou le stockage de données temporaires, Jedis est le moyen le plus direct et efficace de se connecter à Redis. Il prend en charge toutes les structures de données principales de Redis (chaînes, listes, ensembles, hachages, ensembles triés), ainsi que des fonctionnalités comme Pub/Sub, les transactions et les scripts Lua.

Jedis est réputé pour sa simplicité et l'absence de dépendances superflues. Contrairement à des clients plus lourds (comme Lettuce), Jedis ne nécessite pas de configuration de pool de connexions par défaut (bien qu'il le supporte), ce qui en fait un choix idéal pour les projets de petite et moyenne taille où la simplicité et la rapidité de développement sont essentielles.

Installation de Jedis

Jedis est distribué via Maven Central. Pour ajouter la bibliothèque à votre projet, vous devez ajouter une dépendance dans votre fichier pom.xml (pour Maven) ou build.gradle (pour Gradle).

Installation avec Maven

Ajoutez le bloc suivant à votre pom.xml :

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>5.1.0</version> <!-- Utilisez la dernière version stable -->
</dependency>

Installation avec Gradle

Ajoutez cette ligne à votre build.gradle :

implementation 'redis.clients:jedis:5.1.0'

Important : La version 5.x est la dernière mise à jour majeure de Jedis, incluant le support de Redis 7.x et de nouvelles fonctionnalités. Il est recommandé de toujours utiliser la dernière version stable pour bénéficier de tous les correctifs et nouvelles fonctionnalités.

Démarrage rapide avec un exemple de code

Écrivons un programme simple qui se connecte à Redis, enregistre une valeur et la lit.

Supposons que le serveur Redis soit lancé localement sur le port standard 6379.

import redis.clients.jedis.Jedis;

public class JedisQuickStart {
    public static void main(String[] args) {
        // 1. Créer une connexion à Redis
        // Par défaut : localhost:6379
        try (Jedis jedis = new Jedis("localhost", 6379)) {
            
            // 2. Vérifier la connexion (PING)
            String response = jedis.ping();
            System.out.println("Réponse Ping : " + response); // Doit afficher "PONG"

            // 3. Enregistrer une valeur
            jedis.set("user:1000:name", "Alice");
            jedis.set("user:1000:age", "30");

            // 4. Lire une valeur
            String name = jedis.get("user:1000:name");
            String age = jedis.get("user:1000:age");

            System.out.println("Nom de l'utilisateur : " + name);
            System.out.println("Âge de l'utilisateur : " + age);

            // 5. Vérifier l'existence d'une clé
            boolean exists = jedis.exists("user:1000:name");
            System.out.println("Clé existante : " + exists);

            // 6. Supprimer une clé
            long deleted = jedis.del("user:1000:age");
            System.out.println("Clés supprimées : " + deleted);
        }
    }
}

Cet exemple illustre les opérations de base : connexion, écriture, lecture, vérification d'existence et suppression. Notez l'utilisation de try-with-resources qui garantit la fermeture de la connexion après utilisation.

Méthodes principales de Jedis

Jedis propose des centaines de méthodes couvrant toutes les fonctionnalités de Redis. Voici les 10 méthodes les plus couramment utilisées, avec une description détaillée et des exemples.