Cliente Redis (Jedis) para Java: guia completo com exemplos

O que é Jedis e para que serve?

\n\n

Jedis é uma biblioteca Java minimalista, leve e muito popular para trabalhar com Redis (Remote Dictionary Server). Redis é um armazenamento de dados em memória de alto desempenho, frequentemente usado como banco de dados, cache e broker de mensagens. Jedis fornece uma API simples e intuitiva para interagir com o servidor Redis a partir de aplicações Java.

\n\n

Para que serve o Jedis? Se sua aplicação Java usa Redis para cache, gerenciamento de sessões, filas de tarefas ou armazenamento de dados temporários, Jedis é a maneira mais direta e eficiente de se conectar ao Redis. Ele suporta todas as principais estruturas de dados do Redis (strings, listas, conjuntos, hashes, conjuntos ordenados), além de funcionalidades como Pub/Sub, transações e scripts Lua.

\n\n

Jedis é conhecido por sua simplicidade e ausência de dependências desnecessárias. Ao contrário de clientes mais pesados (como Lettuce), Jedis não requer configuração de pool de conexões pronta para uso (embora o suporte), tornando-o a escolha ideal para projetos pequenos e médios onde a simplicidade e a velocidade de desenvolvimento são importantes.

\n\n

Instalação do Jedis

\n\n

Jedis é distribuído através do Maven Central. Para adicionar a biblioteca ao seu projeto, você precisa adicionar a dependência no arquivo pom.xml (para Maven) ou build.gradle (para Gradle).

\n\n

Instalação via Maven

\n

Adicione o seguinte bloco ao seu pom.xml:

\n

<dependency>\n    <groupId>redis.clients</groupId>\n    <artifactId>jedis</artifactId>\n    <version>5.1.0</version> <!-- Use a versão estável mais recente -->\n</dependency>

\n\n

Instalação via Gradle

\n

Adicione a linha ao seu build.gradle:

\n

implementation 'redis.clients:jedis:5.1.0'

\n\n

Importante: A versão 5.x é a última grande atualização do Jedis, que inclui suporte ao Redis 7.x e novos recursos. Recomenda-se sempre usar a versão estável mais recente para obter todas as correções e novas funcionalidades.

\n\n

Início rápido com exemplo de código

\n\n

Vamos escrever um programa simples que se conecta ao Redis, salva um valor e o lê de volta.

\n\n

Suponha que o servidor Redis esteja rodando localmente na porta padrão 6379.

\n\n

import redis.clients.jedis.Jedis;\n\npublic class JedisQuickStart {\n    public static void main(String[] args) {\n        // 1. Cria a conexão com o Redis\n        // Por padrão localhost:6379\n        try (Jedis jedis = new Jedis("localhost", 6379)) {\n            \n            // 2. Verifica a conexão (PING)\n            String response = jedis.ping();\n            System.out.println("Resposta do Ping: " + response); // Deve ser "PONG"\n\n            // 3. Salva um valor\n            jedis.set("user:1000:name", "Alice");\n            jedis.set("user:1000:age", "30");\n\n            // 4. Lê o valor\n            String name = jedis.get("user:1000:name");\n            String age = jedis.get("user:1000:age");\n\n            System.out.println("Nome do usuário: " + name);\n            System.out.println("Idade do usuário: " + age);\n\n            // 5. Verifica a existência da chave\n            boolean exists = jedis.exists("user:1000:name");\n            System.out.println("Chave existe: " + exists);\n\n            // 6. Remove a chave\n            long deleted = jedis.del("user:1000:age");\n            System.out.println("Chaves removidas: " + deleted);\n        }\n    }\n}

\n\n

Este exemplo demonstra o trabalho básico: conexão, escrita, leitura, verificação de existência e remoção. Observe o uso de try-with-resources — isso garante que a conexão será fechada após o uso.

\n\n

Principais métodos do Jedis

\n\n

Jedis fornece centenas de métodos, cobrindo todos os recursos do Redis. Abaixo estão os 10 mais frequentemente us