add

qiaoba-modules/qiaoba-module-demo/pom.xml

@@ -11,6 +11,10 @@
 
     <artifactId>qiaoba-module-demo</artifactId>
 
+    <description>
+        示例模块
+        此模块主要用于典型案例的demo, 切勿引入到 qiaoba-application 模块中
+    </description>
     <dependencies>
         <dependency>
             <groupId>com.qiaoba</groupId>
@@ -24,5 +28,9 @@
             <groupId>com.qiaoba</groupId>
             <artifactId>qiaoba-common-web</artifactId>
         </dependency>
+        <dependency>
+            <groupId>com.qiaoba</groupId>
+            <artifactId>qiaoba-common-doc</artifactId>
+        </dependency>
     </dependencies>
-</project>
+</project>

qiaoba-modules/qiaoba-module-demo/src/main/java/com/qiaoba/module/demo/DemoApplication.java

@@ -0,0 +1,18 @@
+package com.qiaoba.module.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * DemoApplication
+ *
+ * @author ailanyin
+ * @version 1.0
+ * @since 2023/6/25 8:52
+ */
+@SpringBootApplication
+public class DemoApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(DemoApplication.class, args);
+    }
+}

qiaoba-modules/qiaoba-module-demo/src/main/java/com/qiaoba/module/demo/controller/DemoLock4jController.java

@@ -2,22 +2,34 @@ package com.qiaoba.module.demo.controller;
 
 import com.baomidou.lock.annotation.Lock4j;
 import com.qiaoba.common.base.result.AjaxResult;
-import com.qiaoba.module.demo.service.Lock4jService;
+import com.qiaoba.module.demo.service.DemoLock4jService;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+/**
+ * Demo-Lock4j web层
+ *
+ * @author ailanyin
+ * @version 1.0
+ * @since 2022-09-22 04:20:28
+ */
 @RestController
 @RequestMapping("/demo/lock4j")
 @RequiredArgsConstructor
-public class Lock4jController {
+@Tag(name = "Demo-Lock4j")
+@Slf4j
+public class DemoLock4jController {
 
-    private final Lock4jService lock4jService;
+    private final DemoLock4jService demoLock4JService;
 
     @GetMapping("/api-lock")
     public AjaxResult apiLock() {
-        lock4jService.apiLock();
+        log.info("开始执行 apiLock, 当前线程{}", Thread.currentThread().getName());
+        demoLock4JService.apiLock();
         return AjaxResult.success();
     }
 
@@ -29,9 +41,10 @@ public class Lock4jController {
      * @return AjaxResult
      */
     @GetMapping("/annotation-lock")
-    @Lock4j(keys = {"#accountId"}, expire = 20000, acquireTimeout = 10000)
+    @Lock4j(name = "annotationLock", acquireTimeout = 1000)
     public AjaxResult annotationLock() {
-        lock4jService.annotationLock();
+        log.info("开始执行 annotationLock, 当前线程{}", Thread.currentThread().getName());
+        demoLock4JService.annotationLock();
         return AjaxResult.success();
     }
 }

qiaoba-modules/qiaoba-module-demo/src/main/java/com/qiaoba/module/demo/service/DemoLock4jService.java

@@ -1,6 +1,13 @@
 package com.qiaoba.module.demo.service;
 
-public interface Lock4jService {
+/**
+ * Demo-Lock4j 业务层
+ *
+ * @author ailanyin
+ * @version 1.0
+ * @since 2022-09-22 04:20:28
+ */
+public interface DemoLock4jService {
 
     /**
      * 分布式锁-编程式加锁

qiaoba-modules/qiaoba-module-demo/src/main/java/com/qiaoba/module/demo/service/impl/DemoLock4jServiceImpl.java

@@ -4,15 +4,22 @@ import cn.hutool.core.thread.ThreadUtil;
 import com.baomidou.lock.LockInfo;
 import com.baomidou.lock.LockTemplate;
 import com.qiaoba.common.base.exceptions.ServiceException;
-import com.qiaoba.module.demo.service.Lock4jService;
+import com.qiaoba.module.demo.service.DemoLock4jService;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
 
+/**
+ * Demo-Lock4j 业务层实现
+ *
+ * @author ailanyin
+ * @version 1.0
+ * @since 2022-09-22 04:20:28
+ */
 @Service
 @RequiredArgsConstructor
 @Slf4j
-public class Lock4jServiceImpl implements Lock4jService {
+public class DemoLock4jServiceImpl implements DemoLock4jService {
 
     private final LockTemplate lockTemplate;
 
@@ -20,15 +27,16 @@ public class Lock4jServiceImpl implements Lock4jService {
     public void apiLock() {
         //... 各种不需要上锁的操作
         String lockKey = "lock4j:apiLock";
-        final LockInfo lockInfo = lockTemplate.lock(lockKey);
+        // expire = -1 锁自动续期
+        final LockInfo lockInfo = lockTemplate.lock(lockKey, -1, 1000);
         //申请锁失败
         if (null == lockInfo) {
             throw new ServiceException("业务处理中，请稍后再试...");
         }
         //申请锁成功
         try {
-            ThreadUtil.sleep(10 * 1000);
-            log.info("执行 apiLock, 当前线程{}", Thread.currentThread().getName());
+            ThreadUtil.sleep(30 * 1000);
+            log.info("执行完毕 apiLock, 当前线程{}", Thread.currentThread().getName());
         } finally {
             lockTemplate.releaseLock(lockInfo);
         }
@@ -38,6 +46,6 @@ public class Lock4jServiceImpl implements Lock4jService {
     public void annotationLock() {
         // 休眠 10s
         ThreadUtil.sleep(10 * 1000);
-        log.info("执行 apiLock, 当前线程{}", Thread.currentThread().getName());
+        log.info("执行完毕 annotationLock, 当前线程{}", Thread.currentThread().getName());
     }
 }

qiaoba-modules/qiaoba-module-demo/src/main/resources/application.yml

@@ -0,0 +1,15 @@
+server:
+  port: 8080
+
+springdoc:
+  swagger-ui:
+    path: /swagger-ui.html
+    tags-sorter: alpha
+    operations-sorter: alpha
+  api-docs:
+    path: /v3/api-docs
+  group-configs:
+    - group: 'Demo'
+      paths-to-match: '/**'
+      packages-to-scan: com.qiaoba.module.demo.controller
+