jedis

Jedis

Qu’est-ce que les Jedis ?

Jedis est un client Java pour Redis conçu pour les performances et la facilité d'utilisation.

Êtes-vous à la recherche d’une bibliothèque de haut niveau pour gérer le mappage d’objets ? Voir redis-om-spring !

Comment puis-je Redis ?

Apprenez gratuitement à l'Université Redis

Essayez le cloud Redis

Plongez dans les didacticiels des développeurs

Rejoignez la communauté Redis

Travailler chez Redis

Versions Redis prises en charge

La version la plus récente de cette bibliothèque prend en charge les versions Redis 5.0, 6.0, 6.2, 7.0, 7.2 et 7.4.

Le tableau ci-dessous met en évidence la compatibilité des versions des versions de bibliothèque les plus récentes et des versions Redis. La compatibilité signifie les fonctionnalités de communication et les capacités de commande Redis.

Version Jedis	Versions Redis prises en charge	Compatibilité JDK
3,9+	Famille de versions 5.0 à 6.2	8, 11
>= 4,0	Version 5.0 à 7.2 Famille de versions	8, 11, 17
>= 5,0	Version 6.0 à actuelle	8, 11, 17, 21
>= 5,2	Version 7.2 à actuelle	8, 11, 17, 21

Commencer

Pour démarrer avec Jedis, ajoutez-le d'abord en tant que dépendance dans votre projet Java. Si vous utilisez Maven, cela ressemble à ceci :

< dependency >
    < groupId >redis.clients</ groupId >
    < artifactId >jedis</ artifactId >
    < version >5.2.0</ version >
</ dependency >

Pour utiliser les Jedis de pointe, cliquez ici.

Ensuite, vous devrez vous connecter à Redis. Pensez à installer un docker redis-stack :

docker run -p 6379:6379 -it redis/redis-stack:latest

Pour de nombreuses applications, il est préférable d'utiliser un pool de connexions. Vous pouvez instancier un pool de connexions Jedis comme ceci :

 JedisPool pool = new JedisPool ( "localhost" , 6379 );

Avec une instance JedisPool , vous pouvez utiliser un bloc try-with-resources pour obtenir une connexion et exécuter des commandes Redis.

Voici comment exécuter une seule commande SET dans un bloc try-with-resources :

 try ( Jedis jedis = pool . getResource ()) {
  jedis . set ( "clientName" , "Jedis" );
}

Les instances Jedis implémentent la plupart des commandes Redis. Consultez la documentation Jedis Javadocs pour la liste complète des commandes prises en charge.

Un moyen plus simple d’utiliser le pool de connexions

L'utilisation d'un bloc try-with-resources pour chaque commande peut être fastidieuse, vous pouvez donc envisager d'utiliser JedisPooled.

 JedisPooled jedis = new JedisPooled ( "localhost" , 6379 );

Vous pouvez désormais envoyer des commandes comme celles envoyées par Jedis.

 jedis . sadd ( "planets" , "Venus" );

Connexion à un cluster Redis

Jedis vous permet de vous connecter aux clusters Redis, prenant en charge la spécification du cluster Redis. Pour ce faire, vous devrez vous connecter à l'aide JedisCluster . Voir l'exemple ci-dessous :

 Set < HostAndPort > jedisClusterNodes = new HashSet < HostAndPort >();
jedisClusterNodes . add ( new HostAndPort ( "127.0.0.1" , 7379 ));
jedisClusterNodes . add ( new HostAndPort ( "127.0.0.1" , 7380 ));
JedisCluster jedis = new JedisCluster ( jedisClusterNodes );

Vous pouvez désormais utiliser l'instance JedisCluster et envoyer des commandes comme vous le feriez avec une connexion poolée standard :

 jedis . sadd ( "planets" , "Mars" );

Utiliser les modules Redis

Jedis inclut la prise en charge des modules Redis tels que RedisJSON et RediSearch.

Voir RedisJSON Jedis ou RediSearch Jedis pour plus de détails.

Basculement

Jedis prend en charge les nouvelles tentatives et le basculement pour vos déploiements Redis. Ceci est utile lorsque :

1. Vous disposez de plusieurs déploiements Redis. Cela peut inclure deux serveurs Redis indépendants ou deux bases de données Redis ou plus répliquées sur plusieurs clusters Redis Enterprise actifs-actifs.
2. Vous souhaitez que votre application se connecte à un déploiement à la fois et bascule vers le prochain déploiement disponible si le premier déploiement devient indisponible.

Pour obtenir les options et exemples complets de configuration du basculement, consultez la documentation sur le basculement Jedis.

Documentation

Le wiki Jedis contient plusieurs articles utiles pour utiliser les Jedis.

Vous pouvez également consulter les derniers Javadocs Jedis.

Certains exemples de cas d'utilisation spécifiques peuvent être trouvés dans le package redis.clients.jedis.examples des codes sources de test.

Dépannage

Si vous rencontrez des problèmes ou avez des questions, nous sommes là pour vous aider !

Contactez-nous sur le serveur Redis Discord, sur les discussions Jedis GitHub ou sur la liste de diffusion Jedis.

Contribuer

Nous serions ravis de vos contributions !

Les rapports de bugs sont toujours les bienvenus ! Vous pouvez ouvrir un rapport de bug sur GitHub.

Vous pouvez également contribuer à la documentation – ou à tout ce qui améliore Jedis. Veuillez consulter les directives de contribution pour plus de détails.

Licence

Jedis est sous licence MIT.

Parrainage