点击查看【bilibili】

lock4 简介

lock4j 是一个分布式锁组件,其提供了多种不同的支持以满足不同性能和环境的需求。立志打造一个简单但富有内涵的分布式锁组件。

① 添加依赖

  1. <dependency>
  2. <groupId>com.baomidou</groupId>
  3. <artifactId>lock4j-redis-template-spring-boot-starter</artifactId>
  4. <version>2.2.2</version>
  5. </dependency>

② 配置 redis 链接信息

:::warning 以下为默认位置的redis链接信息,点击对应配置文件检查即可 :::

  1. spring:
  2. redis:
  3. host: pig-redis

③ 代码使用 @Lock4j 注解

  1. @Service
  2. public class DemoService {
  3. //默认获取锁超时3秒,30秒锁过期
  4. @Lock4j
  5. public void simple() {
  6. //do something
  7. }
  8. //完全配置,支持spel
  9. @Lock4j(keys = {"#key"}, expire = 60000, acquireTimeout = 1000)
  10. public R customMethod(String key) {
  11. return R.ok();
  12. }
  13. }

④ 高级使用

4.1 全局属性配置

配置全局默认的获取锁超时时间和锁过期时间

  1. lock4j:
  2. acquire-timeout: 3000 #默认值3s,可不设置
  3. expire: 30000 #默认值30s,可不设置
  4. primary-executor: com.baomidou.lock.executor.RedisTemplateLockExecutor #默认redisson>redisTemplate>zookeeper,可不设置
  5. lock-key-prefix: lock4j #锁key前缀, 默认值lock4j,可不设置

:::warning acquire-timeout 可以理解为排队时长,超过这个时才就退出排队,抛出获取锁超时异常。

为什么必须要有这个参数?现实你会一直排队等下去吗?所有人都一直排队有没有问题 ?

expire 锁过期时间 。 主要是防止死锁。 建议估计好你锁方法运行时常,正常没有复杂业务的增删改查最多几秒,留有一定冗余,10秒足够。 我们默认30秒是为了兼容绝大部分场景。 :::

4.2 自定义执行器。

  1. @Service
  2. public class DemoService {
  3. //可在方法级指定使用某种执行器,若自己实现的需要提前注入到Spring。
  4. @Lock4j(executor = RedissonLockExecutor.class)
  5. public Boolean test() {
  6. return "true";
  7. }
  8. }

4.3 自定义锁key生成器

默认的锁key生成器为 com.baomidou.lock.DefaultLockKeyBuilder

  1. @Component
  2. public class MyLockKeyBuilder extends DefaultLockKeyBuilder {
  3. @Override
  4. public String buildKey(MethodInvocation invocation, String[] definitionKeys) {
  5. String key = super.buildKey(invocation, definitionKeys);
  6. // do something
  7. return key;
  8. }
  9. }

4.4 自定义锁获取失败策略

默认的锁获取失败策略为 com.baomidou.lock.DefaultLockFailureStrategy

  1. @Component
  2. public class MyLockFailureStrategy implements LockFailureStrategy {
  3. @Override
  4. public void onLockFailure(String key, long acquireTimeout, int acquireCount) {
  5. // write my code
  6. }
  7. }

4.5 手动上锁解锁

  1. @Service
  2. public class ProgrammaticService {
  3. @Autowired
  4. private LockTemplate lockTemplate;
  5. public void programmaticLock(String userId) {
  6. // 各种查询操作 不上锁
  7. // ...
  8. // 获取锁
  9. final LockInfo lockInfo = lockTemplate.lock(userId, 30000L, 5000L, RedissonLockExecutor.class);
  10. if (null == lockInfo) {
  11. throw new RuntimeException("业务处理中,请稍后再试");
  12. }
  13. // 获取锁成功,处理业务
  14. try {
  15. System.out.println("执行简单方法1 , 当前线程:" + Thread.currentThread().getName() + " , counter:" + (counter++));
  16. } finally {
  17. //释放锁
  18. lockTemplate.releaseLock(lockInfo);
  19. }
  20. //结束
  21. }
  22. }