Ehcache para Java: Guia Completo de Cache

Ehcache é uma biblioteca de cache poderosa e amplamente utilizada para Java, de código aberto. Ela oferece aos desenvolvedores uma API simples e de alto desempenho para armazenamento temporário de dados, permitindo acelerar significativamente as aplicações ao reduzir o tempo de acesso a fontes de dados lentas, como bancos de dados, APIs externas ou sistemas de arquivos. Ehcache é o padrão de facto para cache no ecossistema Java e é usado em grandes projetos como Hibernate (como provedor de cache de segundo nível), Spring Framework e muitos outros.

Por que usar a biblioteca Ehcache? O principal objetivo é melhorar a performance da aplicação. Quando os dados são recuperados de um banco de dados ou serviço externo, cada requisição consome tempo com chamadas de rede, I/O de disco ou cálculos complexos. O Ehcache permite salvar o resultado da primeira consulta na memória RAM (ou em disco) e, em acessos repetidos aos mesmos dados, retorná-los instantaneamente do cache. Isso reduz a carga nos bancos de dados, diminui a latência de resposta e melhora a experiência do usuário. Além disso, o Ehcache oferece mecanismos para gerenciar o ciclo de vida do cache: remoção automática de entradas expiradas (TTL, TTI), estratégias de despejo de dados quando a memória está cheia (LRU, LFU, FIFO) e suporte a cache distribuído em ambientes clusterizados.

Os principais recursos do Ehcache incluem: cache em memória e em disco, suporte a transações, integração com Jakarta EE, monitoramento JMX, configuração via XML ou programaticamente, e suporte a cache distribuído via Terracotta. A biblioteca está em constante evolução: a partir da versão 3.x, o Ehcache oferece uma API moderna e type-safe com suporte a Java Generics, tornando o código mais limpo e confiável.

Instalação

O Ehcache é distribuído pelo Maven Central. Para usá-lo no seu projeto, adicione a dependência no arquivo pom.xml (para Maven) ou build.gradle (para Gradle).

Maven

<dependency>
    <groupId>org.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>3.10.8</version> <!-- Verifique a versão mais recente no Maven Central -->
</dependency>

Gradle

implementation 'org.ehcache:ehcache:3.10.8'

Se você estiver usando uma versão mais antiga do Ehcache 2.x, a dependência será assim:

<dependency>
    <groupId>net.sf.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>2.10.9.2</version>
</dependency>

Neste artigo, usaremos o Ehcache 3.x, pois é a versão moderna e recomendada.

Início Rápido: Exemplo Mínimo Funcional

Vamos criar um cache simples que armazena pares "chave-valor" (String, String).

import org.ehcache.Cache;
import org.ehcache.CacheManager;
import org.ehcache.config.builders.CacheConfigurationBuilder;
import org.ehcache.config.builders.CacheManagerBuilder;
import org.ehcache.config.builders.ResourcePoolsBuilder;

public class EhcacheQuickStart {
    public static void main(String[] args) {
        // 1. Criando o gerenciador de cache
        CacheManager cacheManager = CacheManagerBuilder.newCacheManagerBuilder()
                .withCache("myCache",
                        CacheConfigurationBuilder.newCacheConfigurationBuilder(
                                String.class,   // Tipo da chave
                                String.class,   // Tipo do valor
                                ResourcePoolsBuilder.heap(10)) // 10 entradas na memória
                )
                .build();

        // 2. Inicializando o gerenciador
        cacheManager.init();

        // 3. Obtendo o cache pelo nome
        Cache&l