springdoc支持版本

springdoc支持的版本包括2.0.0和2.0.4。在引用中，版本号为2.0.0，而在引用中，版本号为2.0.4。如果你使用的是SpringBoot3.x版本，则需要使用2.x以上版本的springdoc；如果是SpringBoot2.x版本，则可以使用1.x版本的springdoc。请注意，只需要添加springdoc-openapi-starter-webmvc-ui这个webmvc的依赖即可。

相关问题

SpringDoc支持哪些注解来定制文档内容？

SpringDoc是一款强大的API文档自动化工具，它支持多种注解来定制API文档的内容。以下是一些关键的注解：

1. **@Api**：用于标注整个API组或控制器，提供API的基本信息如标题、描述、版本等。

   @Api(value = "Your API Name", description = "API 描述")
   @ApiInfo(title = "API Title", version = "1.0", contact = @Contact(name = "Author"))

2. **@ApiOperation**：用于标注HTTP方法（GET, POST, PUT等），定义操作名称、描述、返回值类型等。

   @ApiOperation(value = "获取用户信息", notes = "根据用户ID获取用户详情")

3. **@ApiParam**：用于定义路径变量、请求头、请求体参数等的描述。

   @ApiParam(name = "userId", value = "用户的唯一标识")
   @ApiModelProperty(example = "123456")
   private Long userId;

4. **@ApiResponse**：用于定义预期的响应结果，包括HTTP状态码、返回类型及异常情况。

   @ ApiResponse(code = 200, message = "成功", response = UserResponse.class)
   @ApiResponse(code = 404, message = "未找到用户", response = ErrorResponse.class)

5. **@ApiModel** 和 **@ApiModelProperty**：用于模型类，描述类的属性及其意义。

   @ApiModel(description = "用户模型")
   public class User {
       @ApiModelProperty(position = 1, name = "username", required = true)
       private String username;
   }

通过这些注解，你可以精细控制生成的文档结构和内容。SpringDoc还支持自定义模板和主题，以进一步个性化API文档。

springdoc教程

关于springdoc的教程，你可以在官网https://springdoc.org/上找到详细的操作手册和教程。官网提供了关于maven依赖的配置信息，你可以根据项目的需要添加相应的依赖。如果你的项目中使用了spring security，还需要添加springdoc与spring security配合的依赖。在Spring Boot中使用springdoc非常简单，只需要引入其starter即可。它的groupId是org.springdoc，artifactId是springdoc-openapi-ui，版本号可以根据你的需求进行选择。springdoc是Spring生态的一个开源库，是Swagger与OpenAPI规范的具体实现。它可以帮助我们在Spring中生成API文档。虽然它不再更新，不支持Spring Boot 3及以上版本，但目前仍然是行业标准之一。如果你正在进行新项目的开发，建议使用Springdoc。
#### 引用[.reference_title]
- *1* [01_学习springdoc的基本使用](https://blog.csdn.net/ShiJunzhiCome/article/details/128835092)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insertT0,239^v3^insert_chatgpt"}} ] [.reference_item]
- *2* *3* [秒懂SpringBoot之如何集成SpringDoc（全网目前最新最系统最全面的springdoc教程）](https://blog.csdn.net/ShuSheng0007/article/details/131304104)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insertT0,239^v3^insert_chatgpt"}} ] [.reference_item]
[ .reference_list ]