From a96e229db42c6ab85596941ddffb9c0619065e87 Mon Sep 17 00:00:00 2001
From: Wonder <hezhaohui0807@163.com>
Date: Wed, 15 Oct 2025 19:28:30 +0800
Subject: [PATCH] =?UTF-8?q?=20=E2=99=BB=EF=B8=8FRefactor:=20=E5=8D=87?=
 =?UTF-8?q?=E7=BA=A7Knife4j=E8=87=B3OpenAPI3=E5=B9=B6=E6=9B=B4=E6=96=B0MyB?=
 =?UTF-8?q?atis-Plus=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Backend/pom.xml                               | 35 ++++++++++++------
 .../com/wonder/bi/config/Knife4jConfig.java   | 36 -------------------
 .../bi/config/ThreadPoolExecutorConfig.java   |  4 +--
 .../wonder/bi/utils/SpringContextUtils.java   |  2 +-
 Backend/src/main/resources/application.yml    | 18 ++++++++++
 5 files changed, 45 insertions(+), 50 deletions(-)
 delete mode 100644 Backend/src/main/java/com/wonder/bi/config/Knife4jConfig.java

diff --git a/Backend/pom.xml b/Backend/pom.xml
index 7511c06..fb1bdf8 100644
--- a/Backend/pom.xml
+++ b/Backend/pom.xml
@@ -19,6 +19,18 @@
         <java.version>21</java.version>
     </properties>
 
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>com.baomidou</groupId>
+                <artifactId>mybatis-plus-bom</artifactId>
+                <version>3.5.14</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
     <dependencies>
         <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-amqp -->
         <dependency>
@@ -48,17 +60,17 @@
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-aop</artifactId>
         </dependency>
-        <dependency>
-            <groupId>org.mybatis.spring.boot</groupId>
-            <artifactId>mybatis-spring-boot-starter</artifactId>
-            <version>3.0.3</version>
-        </dependency>
-        <!-- https://mvnrepository.com/artifact/com.baomidou/mybatis-plus-boot-starter -->
+
         <dependency>
             <groupId>com.baomidou</groupId>
-            <artifactId>mybatis-plus-boot-starter</artifactId>
-            <version>3.5.2</version>
+            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
         </dependency>
+
+        <dependency>
+            <groupId>com.baomidou</groupId>
+            <artifactId>mybatis-plus-jsqlparser</artifactId>
+        </dependency>
+
         <!-- redis -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
@@ -68,13 +80,14 @@
             <groupId>org.springframework.session</groupId>
             <artifactId>spring-session-data-redis</artifactId>
         </dependency>
-        <!-- https://doc.xiaominfo.com/knife4j/documentation/get_start.html-->
+
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
-            <artifactId>knife4j-spring-boot-starter</artifactId>
-            <version>3.0.3</version>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+            <version>4.4.0</version>
         </dependency>
 
+
         <!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
         <dependency>
             <groupId>org.apache.commons</groupId>
diff --git a/Backend/src/main/java/com/wonder/bi/config/Knife4jConfig.java b/Backend/src/main/java/com/wonder/bi/config/Knife4jConfig.java
deleted file mode 100644
index b326f4b..0000000
--- a/Backend/src/main/java/com/wonder/bi/config/Knife4jConfig.java
+++ /dev/null
@@ -1,36 +0,0 @@
-package com.wonder.bi.config;
-
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Profile;
-import springfox.documentation.builders.ApiInfoBuilder;
-import springfox.documentation.builders.PathSelectors;
-import springfox.documentation.builders.RequestHandlerSelectors;
-import springfox.documentation.spi.DocumentationType;
-import springfox.documentation.spring.web.plugins.Docket;
-import springfox.documentation.swagger2.annotations.EnableSwagger2;
-
-/**
- * Knife4j 接口文档配置
- * https://doc.xiaominfo.com/knife4j/documentation/get_start.html
- *
- */
-@Configuration
-@EnableSwagger2
-@Profile({"dev", "test"})
-public class Knife4jConfig {
-
-    @Bean
-    public Docket defaultApi2() {
-        return new Docket(DocumentationType.SWAGGER_2)
-                .apiInfo(new ApiInfoBuilder()
-                        .title("Interface Documentation")
-                        .description("bi-backend")
-                        .version("1.1")
-                        .build())
-                .select()
-                .apis(RequestHandlerSelectors.basePackage("com.wonder.bi.controller"))
-                .paths(PathSelectors.any())
-                .build();
-    }
-}
\ No newline at end of file
diff --git a/Backend/src/main/java/com/wonder/bi/config/ThreadPoolExecutorConfig.java b/Backend/src/main/java/com/wonder/bi/config/ThreadPoolExecutorConfig.java
index e288576..d3f2cda 100644
--- a/Backend/src/main/java/com/wonder/bi/config/ThreadPoolExecutorConfig.java
+++ b/Backend/src/main/java/com/wonder/bi/config/ThreadPoolExecutorConfig.java
@@ -1,7 +1,7 @@
 package com.wonder.bi.config;
 
-import org.apache.poi.ss.formula.functions.T;
-import org.jetbrains.annotations.NotNull;
+
+import jakarta.validation.constraints.NotNull;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
diff --git a/Backend/src/main/java/com/wonder/bi/utils/SpringContextUtils.java b/Backend/src/main/java/com/wonder/bi/utils/SpringContextUtils.java
index b3e7c85..4890281 100644
--- a/Backend/src/main/java/com/wonder/bi/utils/SpringContextUtils.java
+++ b/Backend/src/main/java/com/wonder/bi/utils/SpringContextUtils.java
@@ -1,6 +1,6 @@
 package com.wonder.bi.utils;
 
-import org.jetbrains.annotations.NotNull;
+import jakarta.validation.constraints.NotNull;
 import org.springframework.beans.BeansException;
 import org.springframework.context.ApplicationContext;
 import org.springframework.context.ApplicationContextAware;
diff --git a/Backend/src/main/resources/application.yml b/Backend/src/main/resources/application.yml
index ecaaad5..bd96ed0 100644
--- a/Backend/src/main/resources/application.yml
+++ b/Backend/src/main/resources/application.yml
@@ -1,3 +1,21 @@
+# springdoc-openapi项目配置
+springdoc:
+  swagger-ui:
+    path: /swagger-ui.html
+    tags-sorter: alpha
+    operations-sorter: alpha
+  api-docs:
+    path: /v3/api-docs
+  group-configs:
+    - group: 'default'
+      paths-to-match: '/**'
+      packages-to-scan: com.wonder.bi.controller
+# knife4j的增强配置，不需要增强可以不配
+knife4j:
+  enable: true
+  setting:
+    language: zh_cn
+
 spring:
   application:
     name: bi-backend