J2Cache 多级缓存配置与使用

1. 简介

J2Cache 是一个基于 Java 的多级缓存框架，支持本地缓存（如 EHCache）与分布式缓存（如 Redis）的组合使用。本文档将指导您完成 J2Cache 的配置、使用及验证流程。

2. 环境准备

2.1 依赖引入

xml 复制代码

<!-- J2Cache 核心依赖 -->
<dependency>
    <groupId>org.javaweb</groupId>
    <artifactId>j2cache-core</artifactId>
    <version>2.1.0</version>
</dependency>

<!-- EHCache 依赖 -->
<dependency>
    <groupId>net.sf.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>2.10.4</version>
</dependency>

<!-- Redis 依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

3. 配置详解

3.1 核心配置文件

properties 复制代码

# J2Cache 配置文件：j2cache.properties
j2cache.level1.provider=net.sf.ehcache.EhCacheProvider
j2cache.level1.config=ehcache.xml
j2cache.level2.provider=org.javaweb.j2cache.provider.redis.RedisProvider
j2cache.level2.config=redis.xml
j2cache.broadcast=org.javaweb.j2cache.broadcast.RedisPubSubBroadcast

3.2 本地缓存配置（EHCache）

xml 复制代码

<!-- ehcache.xml -->
<ehcache>
    <defaultCache
        maxElementsInMemory="1000"
        eternal="false"
        timeToLiveSeconds="3600"
        maxElementsOnDisk="100000"
        diskExpiryThreadIntervalSeconds="120"
        memoryStoreEvictionPolicy="LRU"
    />
</ehcache>

3.3 分布式缓存配置（Redis）

xml 复制代码

<!-- redis.xml -->
<redis>
    <host>localhost</host>
    <port>6379</port>
    <password></password>
    <timeout>0</timeout>
    <database>0</database>
    <pool>
        <maxTotal>8</maxTotal>
        <maxIdle>8</maxIdle>
        <minIdle>0</minIdle>
        <maxWaitMillis>1000</maxWaitMillis>
    </pool>
</redis>

4. 缓存操作示例

4.1 缓存设置

java 复制代码

// 获取缓存通道
CacheChannel cacheChannel = CacheChannel.getChannel();

// 设置缓存
cacheChannel.set("sms:123456", "code:ABC123");

4.2 缓存获取

java 复制代码

// 获取缓存值
String code = (String) cacheChannel.get("sms:123456").getObject();

4.3 缓存删除

java 复制代码

// 删除指定缓存
cacheChannel.remove("sms:123456");

5. 验证与测试

5.1 Redis 验证

bash 复制代码

# 登录 Redis 客户端
redis-cli

# 查看所有键
KEYS *

# 查看具体键值
GET sms:123456

5.2 功能验证流程

调用业务接口发送验证码
检查 Redis 中是否生成对应 key
验证码校验时检查缓存命中情况
观察本地缓存与分布式缓存的数据同步

6. 高级配置

6.1 缓存层级策略

一级缓存（本地）：用于高频访问数据
二级缓存（分布式）：用于跨服务共享数据
广播机制：通过 Redis Pub/Sub 实现缓存同步

6.2 序列化配置

properties 复制代码

# 支持的序列化器
j2cache.serializer=kryo|fastjson|java

6.3 缓存策略配置

properties 复制代码

# 缓存策略配置示例
j2cache.level1.maxElementsInMemory=10000
j2cache.level2.timeout=3600

7. 常见问题

7.1 缓存未生效

检查配置文件路径是否正确
确认缓存 key 格式是否匹配
验证 Redis 连接配置

7.2 数据同步延迟

检查 Redis Pub/Sub 配置
调整缓存过期时间策略
优化本地缓存淘汰策略

8. 结论

通过本文档的配置，您已成功搭建 J2Cache 多级缓存体系。该架构能够有效提升系统性能，降低数据库压力，同时保证数据一致性。建议根据实际业务需求调整缓存策略和参数配置，以达到最佳性能表现。