refactor(api-doc): 将默认API文档UI从Knife4j替换为NextDoc4j

- 移除对Knife4j相关依赖和资源配置
- 新增NextDoc4j依赖及版本管理
- 重构BaseEnumParameterHandler以继承ModelResolver
- 添加ObjectMapper注入支持枚举参数解析
- 调整资源处理器配置移除旧版静态资源配置
- 删除自定义OpenApiHandler及相关构建器配置
- 更新YAML配置文件启用NextDoc4j并移除Knife4j设置
This commit is contained in:
吴泽威
2025-10-20 16:05:41 +08:00
parent 33748f7cec
commit a60d452aee
6 changed files with 39 additions and 326 deletions

View File

@@ -62,7 +62,8 @@
<crane4j.version>2.9.0</crane4j.version>
<!-- API Documentation Versions -->
<knife4j.version>4.5.0</knife4j.version>
<nextdoc4j.version>1.0.1</nextdoc4j.version>
<swagger-annotations.version>2.2.36</swagger-annotations.version>
<!-- Tracing and Logging Versions -->
<tlog.version>1.5.2</tlog.version>
@@ -325,11 +326,11 @@
<version>${crane4j.version}</version>
</dependency>
<!-- Knife4j前身是 swagger-bootstrap-ui集 Swagger2 和 OpenAPI3 为一体的增强解决方案) -->
<!--NextDoc4j (现代化 API 文档 UI 工具 全面替代 Swagger UI) -->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-dependencies</artifactId>
<version>${knife4j.version}</version>
<groupId>top.nextdoc4j</groupId>
<artifactId>nextdoc4j-bom</artifactId>
<version>${nextdoc4j.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -422,6 +423,13 @@
<version>${commons-compress.version}</version>
</dependency>
<!-- Swagger 注解 -->
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-annotations-jakarta</artifactId>
<version>${swagger-annotations.version}</version>
</dependency>
<!-- ContiNew Starter 依赖 -->
<dependency>
<groupId>top.continew.starter</groupId>