From 89f8649e8cf9bc12b9e29abb0adc4f9b77273143 Mon Sep 17 00:00:00 2001
From: guyue <1721849008@qq.com>
Date: 星期二, 08 七月 2025 09:07:44 +0800
Subject: [PATCH] 第三方接口
---
src/main/java/com/linghu/config/Swagger2Config.java | 59 ++++++++++++-----------------------------------------------
1 files changed, 12 insertions(+), 47 deletions(-)
diff --git a/src/main/java/com/linghu/config/Swagger2Config.java b/src/main/java/com/linghu/config/Swagger2Config.java
index 8bd9361..1be5a11 100644
--- a/src/main/java/com/linghu/config/Swagger2Config.java
+++ b/src/main/java/com/linghu/config/Swagger2Config.java
@@ -21,53 +21,37 @@
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
-
@Configuration
-@EnableSwagger2 // 开启Swagger2
+@EnableSwagger2
public class Swagger2Config {
- /**
- * 配置Swagger2核心对象Docket
- */
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
- // 配置API文档基本信息
.apiInfo(apiInfo())
- // 选择需要生成文档的接口
.select()
- // 扫描指定包下的接口（替换为你的Controller包路径）
.apis(RequestHandlerSelectors.basePackage("com.linghu.controller"))
- // 匹配所有路径
.paths(PathSelectors.any())
.build()
- // 添加安全方案配置
- .securitySchemes(Arrays.asList(securityScheme()))
- .securityContexts(Arrays.asList(securityContext()))
- // 添加全局参数（header中的token参数）
- .globalOperationParameters(globalParameters());
+ // 重点修改：使用 securitySchemes + securityContext 替代全局参数
+ .securitySchemes(Arrays.asList(apiKey())) // 添加安全方案
+ .securityContexts(Arrays.asList(securityContext())); // 应用安全上下文
}
- /**
- * 配置JWT安全方案
- */
- private ApiKey securityScheme() {
+ // 1. 定义安全方案（在Swagger UI顶部添加Authorize按钮）
+ private ApiKey apiKey() {
return new ApiKey("BearerToken", "Authorization", "header");
}
- /**
- * 配置安全上下文
- */
+ // 2. 配置安全上下文（全局生效）
private SecurityContext securityContext() {
return SecurityContext.builder()
.securityReferences(defaultAuth())
- .forPaths(PathSelectors.any())
+ .forPaths(PathSelectors.any()) // 对所有路径生效
.build();
}
- /**
- * 默认的安全引用
- */
+ // 3. 设置默认授权范围
private List<SecurityReference> defaultAuth() {
AuthorizationScope authorizationScope = new AuthorizationScope("global", "accessEverything");
AuthorizationScope[] authorizationScopes = new AuthorizationScope[1];
@@ -75,30 +59,11 @@
return Arrays.asList(new SecurityReference("BearerToken", authorizationScopes));
}
- /**
- * 配置全局参数
- */
- private List<Parameter> globalParameters() {
- List<Parameter> parameters = new ArrayList<>();
- parameters.add(new ParameterBuilder()
- .name("Authorization")
- .description("JWT Token (格式: Bearer [token])")
- .modelRef(new ModelRef("string"))
- .parameterType("header")
- .required(false)
- .build());
- return parameters;
- }
-
- /**
- * http://127.0.0.1:8080/swagger-ui.html
- * 配置API文档基本信息（标题、描述、作者等）
- */
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
- .title("灵狐GEO系统 接口文档") // 文档标题
- .description("使用 Swagger2 生成的API文档") // 文档描述
- .version("1.0.0") // 版本号
+ .title("灵狐GEO系统 接口文档")
+ .description("使用 Swagger2 生成的API文档")
+ .version("1.0.0")
.build();
}
}
\ No newline at end of file
--
Gitblit v1.7.1