From 5640248bb0b77f63a271bb739e011ca2b33ee85e Mon Sep 17 00:00:00 2001
From: shangjinshuai <1043076829@qq.com>
Date: Thu, 18 Sep 2025 10:53:08 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=EF=BC=9Aswagger=E5=9B=BE?=
 =?UTF-8?q?=E5=BD=A2=E7=95=8C=E9=9D=A2=20=E4=BF=AE=E6=94=B9=EF=BC=9A?=
 =?UTF-8?q?=E9=82=AE=E4=BB=B6=E5=8F=91=E9=80=81=E4=BA=A7=E5=93=81=E6=A0=BC?=
 =?UTF-8?q?=E5=BC=8F=20=E5=88=A0=E9=99=A4=EF=BC=9A=E6=B2=A1=E6=9C=89?=
 =?UTF-8?q?=E7=94=A8=E5=88=B0import=E5=AF=BC=E5=85=A5=E7=B1=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pom.xml                                       | 19 +++++------
 .../carbon/common/config/OpenAPIConfig.java   | 33 +++++++++++++++++++
 .../carbon/common/config/RequestConfig.java   |  2 --
 .../carbon/common/service/EmailService.java   |  4 ---
 .../example/carbon/common/utils/FileUtil.java |  8 ++---
 .../controller/sys/HxSysMinioController.java  |  2 +-
 .../HxBookingExperienceServiceImpl.java       |  5 +--
 src/main/resources/application.yml            | 18 ++++++++++
 8 files changed, 66 insertions(+), 25 deletions(-)
 create mode 100644 src/main/java/com/example/carbon/common/config/OpenAPIConfig.java

diff --git a/pom.xml b/pom.xml
index 324809e..e3df1ad 100644
--- a/pom.xml
+++ b/pom.xml
@@ -74,6 +74,13 @@
             <version>1.5.2</version>
         </dependency>
 
+        <!-- openapi -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-ui</artifactId>
+            <version>1.8.0</version>
+        </dependency>
+
         <!-- lombok -->
         <dependency>
             <groupId>org.projectlombok</groupId>
@@ -81,11 +88,7 @@
             <scope>compile</scope>
         </dependency>
 
-        <dependency>
-            <groupId>io.swagger.core.v3</groupId>
-            <artifactId>swagger-annotations</artifactId>
-            <version>2.2.20</version>
-        </dependency>
+        <!-- commons -->
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
@@ -106,12 +109,6 @@
         </dependency>
 
         <!-- javaMail -->
-        <dependency>
-            <groupId>com.sun.mail</groupId>
-            <artifactId>javax.mail</artifactId>
-            <version>1.6.2</version>
-        </dependency>
-
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-mail</artifactId>
diff --git a/src/main/java/com/example/carbon/common/config/OpenAPIConfig.java b/src/main/java/com/example/carbon/common/config/OpenAPIConfig.java
new file mode 100644
index 0000000..1cd1466
--- /dev/null
+++ b/src/main/java/com/example/carbon/common/config/OpenAPIConfig.java
@@ -0,0 +1,33 @@
+package com.example.carbon.common.config;
+
+import com.example.carbon.common.base.constant.SysConstant;
+import io.swagger.v3.oas.models.Components;
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.security.SecurityRequirement;
+import io.swagger.v3.oas.models.security.SecurityScheme;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import java.util.Arrays;
+
+@Configuration
+public class OpenAPIConfig {
+    @Bean
+    public OpenAPI customOpenAPI() {
+        return new OpenAPI()
+              .info(new Info()
+                       .title("中联创信-公司首页")
+                       .version("V1.0")
+                       .description("【公司首页-API文档】"))
+              .components(new Components()
+                       .addSecuritySchemes(SysConstant.REQUEST_TOKEN_PARAM, new SecurityScheme()
+                               .name(SysConstant.REQUEST_TOKEN_PARAM)
+                               .type(SecurityScheme.Type.APIKEY)
+                               .in(SecurityScheme.In.HEADER)
+                               .description("token")))
+              .security(Arrays.asList(
+                        new SecurityRequirement().addList(SysConstant.REQUEST_TOKEN_PARAM)
+                ));
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/com/example/carbon/common/config/RequestConfig.java b/src/main/java/com/example/carbon/common/config/RequestConfig.java
index 9faea73..f9221ec 100644
--- a/src/main/java/com/example/carbon/common/config/RequestConfig.java
+++ b/src/main/java/com/example/carbon/common/config/RequestConfig.java
@@ -6,8 +6,6 @@ import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
 import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
-import java.util.Arrays;
-
 @Configuration
 public class RequestConfig implements WebMvcConfigurer {
 
diff --git a/src/main/java/com/example/carbon/common/service/EmailService.java b/src/main/java/com/example/carbon/common/service/EmailService.java
index 713d629..61a8fbb 100644
--- a/src/main/java/com/example/carbon/common/service/EmailService.java
+++ b/src/main/java/com/example/carbon/common/service/EmailService.java
@@ -1,17 +1,13 @@
 package com.example.carbon.common.service;
 
 import org.springframework.beans.factory.annotation.Value;
-import org.springframework.core.io.FileSystemResource;
 import org.springframework.mail.javamail.JavaMailSender;
 import org.springframework.mail.javamail.JavaMailSenderImpl;
 import org.springframework.mail.javamail.MimeMessageHelper;
 import org.springframework.stereotype.Service;
-import org.springframework.util.StringUtils;
 
 import javax.annotation.PostConstruct;
-import javax.mail.Message;
 import javax.mail.MessagingException;
-import javax.mail.internet.InternetAddress;
 import javax.mail.internet.MimeMessage;
 import java.io.File;
 import java.util.List;
diff --git a/src/main/java/com/example/carbon/common/utils/FileUtil.java b/src/main/java/com/example/carbon/common/utils/FileUtil.java
index 88b45ba..ac70b84 100644
--- a/src/main/java/com/example/carbon/common/utils/FileUtil.java
+++ b/src/main/java/com/example/carbon/common/utils/FileUtil.java
@@ -5,8 +5,6 @@ import com.example.carbon.common.base.func.ThrowableConsumer;
 import com.example.carbon.common.model.info.FileInfo;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
-import org.springframework.util.StringUtils;
-import org.springframework.web.multipart.MultipartFile;
 
 import java.io.File;
 import java.io.IOException;
@@ -15,10 +13,10 @@ import java.io.OutputStream;
 import java.math.BigDecimal;
 import java.math.RoundingMode;
 import java.nio.file.Files;
-import java.nio.file.Path;
 import java.nio.file.Paths;
-import java.nio.file.StandardCopyOption;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Set;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
diff --git a/src/main/java/com/example/carbon/controller/sys/HxSysMinioController.java b/src/main/java/com/example/carbon/controller/sys/HxSysMinioController.java
index b151d79..ae013c2 100644
--- a/src/main/java/com/example/carbon/controller/sys/HxSysMinioController.java
+++ b/src/main/java/com/example/carbon/controller/sys/HxSysMinioController.java
@@ -4,8 +4,8 @@ import com.example.carbon.common.base.exception.BizException;
 import com.example.carbon.common.model.entity.sys.HxSysAttach;
 import com.example.carbon.common.model.vo.ResultVo;
 import com.example.carbon.common.utils.FileUtil;
-import com.example.carbon.service.sys.HxSysAttachService;
 import com.example.carbon.service.impl.sys.HxSysMinioServiceImpl;
+import com.example.carbon.service.sys.HxSysAttachService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
diff --git a/src/main/java/com/example/carbon/service/impl/booking/HxBookingExperienceServiceImpl.java b/src/main/java/com/example/carbon/service/impl/booking/HxBookingExperienceServiceImpl.java
index fb2d456..a7eb8ff 100644
--- a/src/main/java/com/example/carbon/service/impl/booking/HxBookingExperienceServiceImpl.java
+++ b/src/main/java/com/example/carbon/service/impl/booking/HxBookingExperienceServiceImpl.java
@@ -22,7 +22,8 @@ import org.springframework.transaction.annotation.Transactional;
 import javax.mail.MessagingException;
 import java.time.LocalDateTime;
 import java.time.LocalTime;
-import java.util.*;
+import java.util.Date;
+import java.util.List;
 import java.util.stream.Collectors;
 
 /**
@@ -72,7 +73,7 @@ public class HxBookingExperienceServiceImpl extends CommonServiceImpl<HxBookingE
         // 获取预约项目名称
         String bookingItemNames = entity.getBookingItemList().stream()
                 .map(BookingItem::getName)
-                .collect(Collectors.joining(",    "));
+                .collect(Collectors.joining("，"));
 
         // 构建邮件内容
         String emailContent = buildEmailContent(entity, bookingItemNames);
diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml
index 2ae847c..011bf10 100644
--- a/src/main/resources/application.yml
+++ b/src/main/resources/application.yml
@@ -80,3 +80,21 @@ mail:
   # 是否启用调试模式(开发环境可开启，生产环境应关闭)
   debug: false
 
+# open-api
+#springdoc:
+#  api-docs:
+#    path: /v3/api-docs
+#  group-configs:
+#    - group: carbon-booking
+#      display-name: 预约模块
+#      packages-to-scan: com.example.carbon.controller.booking
+#    - group: carbon-jurnalism
+#      display-name: 新闻管理模块
+#      packages-to-scan: com.example.carbon.controller.jrn
+#    - group: carbon-permission
+#      display-name: 权限管理模块
+#      packages-to-scan: com.example.carbon.controller.perm
+#    - group: carbon-system
+#      display-name: 系统基础模块
+#      packages-to-scan: com.example.carbon.controller.sys
+