redislock-spring-boot-starter

简介

redislock-spring-boot-starter 是基于redis实现的分布式注解锁，原理很简单，就是在redis里面setnx一个key，如果这个key不存在，则加锁成功，多线程环境下再次进入这个方法就会加锁失败。项目以spring-boot-starter的形式发布，引入方便。既可以以加注解的方式实现方法如入口层面的加锁，也可以注入相应的加锁类，以嵌入代码的形式加锁。作者更推荐使用注解的形式，注解切面的order是-1，也就是在spring事务切面的外层。开箱即用，只需要配置spring redis即可，该项目已经在作者的两家公司应用了，觉得不错记得点赞！

关于timeout的设置 小于50毫秒则会直接休眠timeout的时间。大于50时，则第一次休眠50毫秒，此后休眠时间逐次翻倍，最后一次休眠的时间为剩余待休眠时间，即保证总休眠时间等于timeout的值。

关于key到期后的安全问题 假如第一个线程执行方法超时，redis key到期后，第二个线程可以进入重新加锁。第一个超时方法执行完后是不会把第二个线程加的锁释放掉的，程序已经做了处理。怎么处理第二个线程进入的问题，框架没有处理，依赖使用者做好业务幂等处理。全局超时时间是90秒，可以根据业务自行调整，也可以在单个注解上设置单次的超时时间。另外相比手动加锁，不会有遗漏释放锁的风险。

命名更新

项目名称之前是RedisLock，考虑到用spring-boot-starter比较方便，所以使用官方推荐的命名方法。原项目1.0.0版本的jar包maven**库，强烈建议更换新项目的maven dependency。

配置

pom 引入redis

<dependency>
    <groupId>com.warmmen</groupId>
    <artifactId>redislock-spring-boot-starter</artifactId>
</dependency>

redis 配置，具体参考springboot官方文档

spring:
  redis:
      host: localhost
      port: 6379
      password:
      pool:
        max-active: 8
        max-idle: 8
        min-idle: 0
        max-wait: 10000

配置文件属性

redis-lock.timeout 全局默认阻塞获取锁的超时时间，单位毫秒，默认500。
redis-lock.prefix 所有加锁的key的前缀，默认为 "REDIS_LOCK_" 。
redis-lock.defaultError 加锁失败抛出的异常信息，默认 "The lock has been occupied.re"。
redis-lock.liveTime 锁持续的时间，单位毫秒，默认90000。锁失效后，其他线程可以进入该锁，设置需谨慎。

注解方式

@RedisLock 方法注解

方法加锁的标志，方法必须实现jdk接口，原理同事务。
value，redis中存的key值。
suffix 后缀，redis中存的key值附加的后缀。
blocked 是否阻塞获取锁，默认否，非阻塞获取会立马返回结果。如果为true，则在第一次获取锁失败后，会多次休眠尝试重新获取锁。
error 获取锁失败时抛出的异常信息，默认抛出的信息: "The lock has been occupied."
timeout 阻塞获取锁的超时时间，单位毫秒，如不设值，则取全局的默认超时时间，默认500毫秒。也可以在 application.yml配置文件中修改redis-lock.timeout的值。如有设值，则该注解修饰的方法以timeout值作为超时时间。

@RedisLockRequest 方法注解

获取Http请求参数的值
value 参数的名称

@RedisLockParam 参数注解

获取参数的值
value
当value为空时：如果参数实现了RedisLockable接口，则获取RedisLockable接口的key()，否则返回参数的toString()作为redis锁的key。
当value非空时：以SpEL表达式获取参数中的字段值，假如参数是Map类型，value=“name”, 则返回Map中key为name的值；如果参数是object，则返回name字段的toString(), 假如name字段还是个object，也可以用 “name.filed” 取出name中field字段的值，以此类推（Map 也是相同原则）。

RedisLockable 接口

自定义获取参数的锁Key

java 代码方式

@Autowired
DefaultRedisLock defaultRedisLock;

void doSomething() {
    try {
        boolean success = defaultRedisLock.tryLock("DO_SOMETHING", 100);
        
        if (success) {
            // do something
        }
    } finally {
        // unlock in finally
        defaultRedisLock.unlock("DO_SOMETHING");
    }
}

tryLock 和 lock 区别？
lock加锁失败会抛出RedisLockException异常，tryLock不会。
tryLock 可以加阻塞时间。

锁key的拼接顺序

redis-lock.prefix 的值。
@RedisLockRequest 配置的请求参数中获取，配置多个时，按配置的顺序获取。
@RedisLockParam中获取，多个时以下划线(_)分隔。
suffix 的值。

如果第2，3步取值都为空，则会抛出异常。

例子

@RedisLock(vakue = "Test_Method", suffix = "Suf", blocked = true, timeout = 1000, error = "加锁失败，请重试！")
@RedisLockRequest({"arg1", "arg2"})
public void test(@RedisLockParam param1,
                 @RedisLockParam("name") Map<String, Object> param2)

如果获取锁成功，则key的值为：REDIS_LOCK_Test_Method_arg1_arg2_param1_name_Suf，锁的持续时间时90秒
如果获取锁失败，抛出异常："加锁失败，请重试！"

lihuacheng/redislock-spring-boot-starter