Jedis es un cliente Java para Redis diseñado para ofrecer rendimiento y facilidad de uso.
¿Está buscando una biblioteca de alto nivel para manejar el mapeo de objetos? ¡Ver redis-om-primavera!
Aprende gratis en Redis University
Pruebe la nube de Redis
Sumérgete en los tutoriales para desarrolladores
Únase a la comunidad Redis
Trabaja en Redis
La versión más reciente de esta biblioteca es compatible con las versiones 5.0, 6.0, 6.2, 7.0, 7.2 y 7.4 de Redis.
La siguiente tabla destaca la compatibilidad de las versiones más recientes de la biblioteca y las versiones de Redis. Compatibilidad significa funciones de comunicación y capacidades de comando de Redis.
versión Jedi | Versiones de Redis compatibles | Compatibilidad JDK |
---|---|---|
3.9+ | Familia de versiones 5.0 a 6.2 | 8, 11 |
>= 4.0 | Versión 5.0 a 7.2 Familia de versiones | 8, 11, 17 |
>= 5.0 | Versión 6.0 a la actual | 8, 11, 17, 21 |
>= 5.2 | Versión 7.2 a la actual | 8, 11, 17, 21 |
Para comenzar con Jedis, primero agréguelo como una dependencia en su proyecto Java. Si estás usando Maven, se ve así:
< dependency >
< groupId >redis.clients</ groupId >
< artifactId >jedis</ artifactId >
< version >5.2.0</ version >
</ dependency >
Para utilizar los Jedis de última generación, consulte aquí.
A continuación, deberá conectarse a Redis. Considere instalar una ventana acoplable redis-stack:
docker run -p 6379:6379 -it redis/redis-stack:latest
Para muchas aplicaciones, es mejor utilizar un grupo de conexiones. Puedes crear una instancia de un grupo de conexiones Jedis de esta manera:
JedisPool pool = new JedisPool ( "localhost" , 6379 );
Con una instancia JedisPool
, puede usar un bloque de prueba con recursos para obtener una conexión y ejecutar comandos de Redis.
A continuación se explica cómo ejecutar un único comando SET dentro de un bloque de prueba con recursos :
try ( Jedis jedis = pool . getResource ()) {
jedis . set ( "clientName" , "Jedis" );
}
Las instancias Jedis
implementan la mayoría de los comandos de Redis. Consulte Jedis Javadocs para obtener la lista completa de comandos admitidos.
Usar un bloque de prueba con recursos para cada comando puede resultar engorroso, por lo que puedes considerar usar JedisPooled.
JedisPooled jedis = new JedisPooled ( "localhost" , 6379 );
Ahora puedes enviar comandos como enviar desde Jedis.
jedis . sadd ( "planets" , "Venus" );
Jedis le permite conectarse a Redis Clusters, lo que admite la especificación de Redis Cluster. Para hacer esto, necesitarás conectarte usando JedisCluster
. Vea el ejemplo a continuación:
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 );
Ahora puedes usar la instancia JedisCluster
y enviar comandos como lo harías con una conexión agrupada estándar:
jedis . sadd ( "planets" , "Mars" );
Jedis incluye soporte para módulos de Redis como RedisJSON y RediSearch.
Consulte RedisJSON Jedis o RediSearch Jedis para obtener más detalles.
Jedis admite reintentos y conmutación por error para sus implementaciones de Redis. Esto es útil cuando:
Para conocer ejemplos y opciones completas de configuración de conmutación por error, consulte los documentos de conmutación por error de Jedis.
La wiki de Jedis contiene varios artículos útiles para usar Jedis.
También puede consultar los últimos Jedis Javadocs.
Se pueden encontrar algunos ejemplos de casos de uso específicos en el paquete redis.clients.jedis.examples
de los códigos fuente de prueba.
Si tiene problemas o tiene alguna pregunta, ¡estamos aquí para ayudarlo!
Contáctenos en Redis Discord Server o Jedis GitHub Discussions o Jedis mailing list.
¡Nos encantarían tus contribuciones!
¡Los informes de errores siempre son bienvenidos! Puede abrir un informe de error en GitHub.
También puedes contribuir con documentación, o cualquier cosa para mejorar Jedis. Consulte la guía de contribución para obtener más detalles.
Jedis tiene licencia del MIT.