JarCastingrlock-spring-boot-starter
基于Redisson的分布式锁starter
特别提示: 配置项使用优先级(1 > 2 > 3):
-
- 优先使用通过 RedissonProperties.config 指定的配置
-
- 配置文件中 spring.redis 前缀的配置
-
- 默认配置
默认的锁会使用WatchDog自动延长锁的持有时间, 且无限等待获取锁, 如需修改, 可修改@Rlock中的参数
简介
该项目主要利用Spring Boot的自动化配置特性来实现快速的将redis分布式锁引入spring boot应用，简化Redisson的操作。
源码地址
GitHub：https://github.com/dawn9117/rlock-spring-boot-starter
小工具一枚，欢迎使用和Star支持，如使用过程中碰到问题，可以提出Issue，我会尽力完善该Starter
版本基础
- spring-boot-starter-parent: 2.2.4.RELEASE
- redisson: 3.12.0
- fastjson: 1.2.62
- commons-collections4: 4.3
- commons.lang3: 3.9
如何使用
在该项目的帮助下，我们的Spring Boot可以轻松的引入redis分布式锁，主需要做下面两个步骤：
step1. 在pom.xml中引入依赖：
<dependency>
<groupId>com.github.dawn9117</groupId>
<artifactId>rlock-spring-boot-starter</artifactId>
<version>${version}</version>
</dependency>
step2. 根据需求配置参数
参考:
- com.github.dawn9117.rlock.config.RlockProperties
- org.springframework.boot.autoconfigure.data.redis.RedisProperties
- org.redisson.config.Config
step3. 在需要加分布式锁的方法上增加@Rlock注解
@Service
public class UserService implements IUserService {
@Rlock(keys = "#user.name")
@Override
public User add(User user) {
// do something
return user;
}
}
锁说明: 默认使用ReentrantLock(可通过LockModal指定)
规则如下(key构建规则可自定义, 参考 com.github.dawn9117.rlock.core.lock.name.LockNameBuilder):
- 注解未指定keys: prefix + 项目名称 + 类全路径 + 方法名, 例如: /locks/project/com.github.dawn.UserService/add
- 指定keys: prefix + 项目名称 + 类全路径 + 方法名 + key, 例如 /locks/project/com.github.dawn.UserService/add/zhangsan
- SPEL: prefix + 项目名称 + 类全路径 + 方法名 + SPEL, 例如 @Rlock("#param1"): /locks/project/com.github.dawn.UserService/add/解析#param1得到的值