Redis nos ofrece gran cantidad de clientes para interactuar con él mediante gran cantidad de lenguajes de programación (Clientes Redis).
En nuestro ejemplo interactuaremos con Redis mediante el cliente Java denominado Jedis.
Comenzaremos creando un proyecto Maven incluyendo la depedencia siguiente en el pom.xml.
<dependency>
<groupId>redis.clients</groupId>
<artifactId>jedis</artifactId>
<version>2.6.2</version>
<type>jar</type>
<scope>compile</scope>
</dependency>
No obstante, si aún no usas Maven y prefieres incluir el driver en el proyecto puedes descargar el driver .jar de Redis.
La forma básica de obtener una conexión a Redis es instanciando directamente la clase Jedis. Indicaremos el host y usaremos el puerto por defecto
Jedis jedis = new Jedis("localhost");
Otra forma básica de conexión a Redis consiste en instanciar la clase Jedis especificando el host y el puerto de conexión
Jedis jedis = new Jedis("localhost", 6379);
Sin embargo, no se recomienda utilizar la misma instancia desde threads diferentes, ya que podemos obtener errores inesperados. Además, tampoco es adecuado la creación de múltiples instancias de Jedis ya que acarrea la creación de múltiples sockets y conexiones, lo que también puede desencadenar errores. Esto se debe a que una instancia de Jedis no es threadsafe.
Para evitar estos problemas se debe utilizar JedisPool, un pool de conexiones threadsafe. Utilizaremos el pool para crear de forma segura instancias de Jedis. De esta forma evitaremos errores y obtendremos un mejor rendimiento.
Iniciaremos un pool:
JedisPool pool = new JedisPool(new JedisPoolConfig(), "localhost");
JedisPoolConfig incluye una serie de valores predeterminados útiles. Por ejemplo, si usamos Jedis con JedisPoolConfig se liberará la conexión tras 300 segundos (5 minutos) de inactividad.
La conexión a Redis la obtendremos con el método getResource() de JedisPoolConfig
Jedis jedis = pool.getResource();
Cuando no ya no necesitemos una conexión la cerraremos con close() y quedará liberada.
jedis.close();
Cuando hayamos finalizado el trabajo destruiremos el pool con destroy().
pool.destroy();
Con set(key, value) asignamos un valor a una clave y con get(key) recuperamos el valor asociado a una clave.
Con mset(key1, value1 [, key n, value n]) asignamos una lista de pares clave-valor en una operación atómica. Con mget(key1 [, key n]) obtenemos la lista de valores asociados a las claves pasadas como parámetro.
Con del(key1 [, key n]) borramos una clave o lista de claves.
La ejecución de este método imprime
bar
10
20
30
incr(key) y decr(key) incrementan o disminuyen en 1 el valor de la clave especificada.
incrby(key, quantity) y decrby(key, quantity) incrementan o disminuyen el valor de la clave especificada en el argumento proporcionado.
La ejecución de este método imprime
counter: 105
append(key, string) añade la cadena propocionada al final del valor de la clave especificada.
substr(key, left, right) devuelve una subcadena de la clave especificada comprendida entre dos posiciones.
strlen(key) devuelve el número de caracteres del valor de la clave especificada.
La ejecución de este método imprime
Appended greeting: Hello World!
Substring: World!
greeting: Hello World!
Length: 12
Las listas son colecciones de valores que admiten repetidos.
lpush(key, value) inserta al principio (izquierda) de la clave especificada el valor proporcionado. rpush(key, value) inserta al final (derecha).
rpop(key) extrae un valor del final (derecha) de la clave especificada.
linsert(key, beforeOrAfter, pivot, value) inserta en la clave especificada el valor proporcionado. El valor se inserta antes BinaryClient.LIST_POSITION.BEFORE o después BinaryClient.LIST_POSITION.AFTER del valor especificado (pivot).
lset(key, value, position) establece en la clave especificada el valor proporcionado en la posición especificada.
lrange(key, left, right) devuelve los elementos de la lista de la clave especificada entre que estén entre las posiciones indicadas (-1 representa el final).
La ejecución de este método imprime
10/3
17/3
24/3
7/4
Los conjuntos son colecciones de valores que no admiten repetidos.
sadd(key, value1 [,value n]) añade a la clave especificada los elementos proporcionados.
srem(key, value1 [, value n]) elimina de la clave especificada los elementos proporcionados.
smembers(key) devuelve todos los miembros del conjunto asociado a la clave especificada.
scard(key) devuelve el número de elementos del conjunto de la clave especificada.
La ejecución de este método imprime
2 elements
student2
student1
sunion(set1, set2), sinter(set1, set2) y sdiff(set1, set2) obtienen, respectivamente, la unión, intersección y diferencia de conjuntos.
La ejecución de este método imprime
*** Total students:
student2
student1
student5
student4
student3
*** Common students:
student3
*** Students only in GGVD:
student2
student1
Los conjuntos ordenados son conjuntos cuyos elementos están acompañados de una puntuación que permite establecer un orden en el conjunto.
zadd(key, score, value) añade a la clave especificada la puntuación y el elemento proporcionado.
zincrby(key, increment, value) añade el incremento propocionado a la puntuación del elemento y clave especificados.
zcount(key, lower, higher) devuelve el número de elementos del conjunto que tienen su puntuación entre los límites propocionados
zRangeByScoreWithScores(key, lower, higher) devuelve los elementos y puntuación del conjunto y clave especificados cuyas puntuaciones están en el rango proporcionado.
La ejecución de este método imprime
*** Number of passed students: 2
student3 8.0
student1 9.0
Los hashes son listas de campo-valor asociados a una clave.
hset(key, field, value) asigna a la clave especificada el campo y valor propocionados.
hget(key, field) obtiene el valor asociado a la clave y campo especificados.
hkeys(key) obtiene un conjunto con la lista de campos de un clave.
La ejecución de este método imprime
twitter: @ualmtorres
surname: Torres Gil
email: mtorres@ual.es
name: Manuel
Las transacciones se inician con multi().
Para finalizar la transacción usaremos:
exec(): ejecuta las instrucciones de una transacción.discard(): cancela las instrucciones de una transacción.La ejecución de este método imprime
*** Keys after discarding:
1
2
Puedes descargar el código de este tutorial que incluye una batería de juegos de prueba del GitHub.