环境:SpringBoot2.7.18+Redis6.2.6+Redisson3.18.0
1. 简介
Redisson 是 Redis Java 客户端和实时数据平台。它为使用 Redis 提供了更方便、更简单的方法。Redisson 对象提供了关注点分离功能,可让你专注于数据建模和应用逻辑。
在Java中,为我们提供了丰富的集合类,如List、Set、Map等,这些集合类在单机应用或单个JVM进程中是非常强大和有效的工具。然而,在分布式系统下,数据需要在多个JVM进程或节点之间共享和同步。为实现这一目标Redisson提供了许多分布式集合实现,如RList、RSet、RMap等,这些集合类能够在多个Redis节点之间无缝地共享数据。通过使用Redisson,开发者可以像使用传统Java集合类一样,在分布式系统中进行数据的增删改查操作,而无需担心数据在不同节点之间的同步和一致性问题。
2. 实战案例
2.1 Map集合
基于 Redis 的 Java 分布式 Map 对象实现了 ConcurrentMap 接口。该对象是完全线程安全的。
- RMap类关系
public interface RMap<K, V> extends ConcurrentMap<K, V>, ...{}
接下来所有操作都是基于RedissonClient对象
@Resource
private RedissonClient redisson ;
- 同步存数据
RMap<String, User> map = redisson.getMap("user-list");
User preValue = map.put("1", new User(2L, "张三2", 22)) ;
User value = map.putIfAbsent("2", new User(2L, "李四", 33));
- 快速存数据
如果你不需要返回上一个值(旧值)建议使用相应fast* 方法
RMap<String, User> map = redisson.getMap("user-list");
map.fastPut("1", new User(2L, "张三2", 22));
map.fastPutIfAbsent("2", new User(2L, "李四", 33));
map.fastRemove("1") ;
以上操作不会返回对应key之前的旧值。
- 异步存数据
RFuture<User> f1 = map.putAsync("1", new User(2L, "张三2", 22)) ;
RFuture<Boolean> f2 = map.fastPutAsync("2", new User(2L, "李四", 33)) ;
RFuture<Long> f3 = map.fastRemoveAsync("2") ;
以上操作对应Redis数据结构
HASH数据结构
- Map集合中key绑定Lock
上面得知,Map保存的数据是hash数据结构,我们可以将每一个key绑定到对应的Lock/ReadWriteLock/Semaphore/CountDownLatch。
RMap<String, User> map = redisson.getMap("user-list") ;
RLock lock = map.getLock(key) ;
lock.lock() ;
try {
System.out.printf("当前线程: %s, 当前时间: %d%n", Thread.currentThread().getName(), System.currentTimeMillis()) ;
TimeUnit.SECONDS.sleep(3) ;
} finally {
lock.unlock() ;
}
- 本地缓存
用于加快读取操作速度,避免网络往返。它在 Redisson 端缓存地图条目,执行读取操作的速度是普通实现的** 45 倍**。支持本地缓存的地图对象实现了RLocalCachedMap,它扩展了 java.util.concurrent.ConcurrentMap 接口。该对象是完全线程安全的。
// 配置缓存策略
final LocalCachedMapOptions<String, User> LOCAL_CACHE = LocalCachedMapOptions.<String, User>defaults()
// 缓存大小
.cacheSize(200)
// 缓存模式
.storeMode(StoreMode.LOCALCACHE_REDIS)
// 删除策略
.evictionPolicy(EvictionPolicy.LRU) ;
// 获取指定key本地缓存
RLocalCachedMap<String,User> localCachedMap = redisson.getLocalCachedMap("user-list", LOCAL_CACHE) ;
User user = localCachedMap.get("1") ;
本地缓存实例对象同样支持fast*及异步方式,这里不再赘述。
- 事件监听
Redisson 允许为每个 RMap 对象绑定监听器,RMap 对象允许跟踪数据上的跟踪事件。如下表,监听类及事件
如下示例
RMap<String, User> map = redisson.getMap("user-list");
int deletedListener = map.addListener(new DeletedObjectListener() {
@Override
public void onDeleted(String name) {
// ...
}
});
int expredListener = map.addListener(new ExpiredObjectListener() {
@Override
public void onExpired(String name) {
// ...
}
});
int putListener = map.addListener(new MapPutListener() {
@Override
public void onPut(String name) {
// ...
}
});
int removeListener = map.addListener(new MapRemoveListener() {
@Override
public void onRemove(String name) {
// ...
}
});
// 删除监听器
map.removeListener(listenerId) ; // removeListener, putListener ...
以上是关于Map集合的常用操作。
2.2 Set集合
基于 Redis 的 Java Set 对象实现了 java.util.Set 接口。该对象完全线程安全。通过元素状态比较保持元素的唯一性。Redis 将集合大小限制为 4 294 967 295 个元素。Redis 使用序列化状态检查值的唯一性,而不是值的 hashCode()/equals() 方法。
- RSet类关系
public interface RSet<V> extends Set<V>,...{}
- 基本操作
RSet<User> set = redisson.getSet("user-set");
set.add(new User(1L, "张三", 33)) ;
set.add(new User(2L, "李四", 55)) ;
Redis中存储使用的数据结构
RSet使用Set集合。与RMap一样,RSet也支持同步异步方式操作数据
RFuture<Boolean> f1 = set.addAsync(new User(1L, "张三", 33)) ;
RFuture<Boolean> f2 = set.addAsync(new User(2L, "李四", 55)) ;
- 绑定Lock操作
RSet<User> set = redisson.getSet("user-set") ;
RLock lock = set.getLock(new User(1L, "张三", 33)) ;
lock.lock() ;
try {
// ...
} finally {
lock.unlock() ;
}
- 删除策略
当前的Redis实现没有设置值删除功能。因此,过期的数据会被org.redisson.eviction.EvictionScheduler清除。它一次性删除300个过期条目。如果clean task每次删除300项,它将每秒执行一次(最小执行延迟)。但如果当前的过期值小于前一个,则执行延迟将增加1.5倍。
RSetCache<User> set = redisson.getSetCache("user-set") ;
set.add(new User(3L, "阴阳路", 66), 180L, TimeUnit.SECONDS) ;
- 事件监听
与Map一样Set也有对应的事件监听,详细查看Map中对应的说明。
- Set排序
基于 Redis 的 Java 分布式 SortedSet 实现了 java.util.SortedSet 接口。该对象线程安全。它使用比较器对元素进行排序并保持唯一性。对于字符串数据类型,建议使用 LexSortedSet 对象,以提高性能。
RSortedSet<Integer> set = redisson.getSortedSet("set-sort") ;
// 这里不可以写成lambda表达式:(o1, o2) -> Integer.compare(o1, o2)
set.trySetComparator(new Comparator<Integer>() {
@Override
public int compare(Integer o1, Integer o2) {
return o1 > o2 ? 1 : (o1 < o2 ? -1 : 0) ;
}
}) ;
set.add(3) ;
set.add(1) ;
set.add(2) ;
redis中生成如下2个key
set-sort对应的值
2.3 List集合
基于 Redis 的 Java 分布式 List 对象实现了 java.util.List 接口。它按插入顺序保存元素。
它有 Async、Reactive 和 RxJava3 接口。Redis 限制列表大小为 4 294 967 295 个元素。
- RList类关系
public interface RList<V> extends List<V>, ... {}
- 基本操作
RList<User> list = redisson.getList("user-list");
User user = new User(1L, "张三", 10);
list.add(user) ;
User ret = list.get(0) ;
System.out.println("ret = " + ret) ;
list.remove(user) ;
- 事件监听
RList<User> list = redisson.getList("user-list") ;
list.addListener(new ExpiredObjectListener() {
@Override
public void onExpired(String name) {
// ...
}
}) ;
// 其它事件
/**
* DeletedObjectListener
* ListAddListener
* ListInsertListener
* ListSetListener
* ListRemoveListener
* ListTrimListener
*/
2.4 Queue队列
基于 Redis 的 Java 分布式无界队列对象,实现了 java.util.Queue 接口。该对象是完全线程安全的。它有 Async、Reactive 和 RxJava3 接口。
- RQueue类关系
public interface RQueue<V> extends Queue<V>, ... {}
- 基本操作
RQueue<User> queue = redisson.getQueue("user-queue");
queue.add(new User()) ;
// 获取但不删除
User u1 = queue.peek() ;
// 获取并删除
User u2 = queue.poll() ;
redis使用的数据结构
- 事件监听
RQueue<User> queue = redisson.getQueue("user-queue") ;
queue.addListener(new ExpiredObjectListener() {
@Override
public void onExpired(String name) {
// ...
}
}) ;
// 其它事件
/**
* ListAddListener
* ListInsertListener
* ListRemoveListener
*/
2.5 阻塞队列
基于Redis 的Java 分布式无界BlockingQueue对象,实现了 java.util.concurrent.BlockingQueue接口。该对象是完全线程安全的。它有 Async、Reactive 和 RxJava3 接口。
- 类关系
public interface RBlockingQueue<V> extends BlockingQueue<V>, ... {}
- 基本操作
RBlockingQueue<User> queue = redisson.getBlockingQueue("user-blockqueue");
queue.offer(new User(1L, "哈哈", 22)) ;
// queue.offer(new User(2L, "嘿嘿", 33)) ;
User u1 = queue.peek() ;
User u2 = queue.poll() ;
// 这里会被阻塞,最多等待10s队列中有元素则直接返回
User u3 = queue.poll(10, TimeUnit.SECONDS) ;
对应redis使用的数据结构
2.6 有界阻塞队列
大致使用用途上面一致
RBoundedBlockingQueue<SomeObject> queue = redisson.getBoundedBlockingQueue("user-capacity-queue");
// 设置容量大小
queue.trySetCapacity(2);
queue.offer(new User(1L, "张三", 20));
queue.offer(new User(2L, "李四", 10));
Redisson提供了很多分布式的队列实现,如还有双端队列,优先级队列等,这里就不一一展示了。