springboot如何集成springdoc

springboot集成springdoc的步骤：1、添加依赖；2、配置文件；3、配置Swagger3Config类；4、创建DTO类；5、创建API接口和注解；6、启动应用程序并访问API文档页面。详细介绍：1、添加依赖，在Spring Boot项目的pom.xml文件中，添加Springdoc的依赖；2、配置文件，在Spring Boot项目等等。

本教程操作系统：windows10系统、DELL G3电脑。

要集成Spring Boot和Springdoc，您可以按照以下步骤进行操作：

1、添加依赖

在您的Spring Boot项目的pom.xml文件中，添加Springdoc的依赖。以下是一个示例：

  
    org.springdoc  
    springdoc-openapi-ui  
    1.5.3  

2、配置文件

在您的Spring Boot项目的application.yml文件中，添加以下配置：

springdoc:  
  api-docs:  
    enabled: true # 开启文档功能，默认为true，可不配置  
  swagger-ui:  
    path: /api # 访问路径，默认为/swagger-ui.html

3、配置Swagger3Config类

创建一个Swagger3Config类，并实现OpenAPISchemaConverter接口。该类用于配置Swagger3的相关参数。以下是一个示例：

情感家园企业站5.0 多语言多风格版

一套面向小企业用户的企业网站程序！功能简单，操作简单。实现了小企业网站的很多实用的功能，如文章新闻模块、图片展示、产品列表以及小型的下载功能，还同时增加了邮件订阅等相应模块。公告，友情链接等这些通用功能本程序也同样都集成了！同时本程序引入了模块功能，只要在系统默认模板上创建模块，可以在任何一个语言环境（或任意风格）的适当位置进行使用！

下载

@Configuration  
public class Swagger3Config {  
    @Bean  
    public OpenAPISchemaConverter openAPISchemaConverter() {  
        return new OpenAPISchemaConverter();  
    }  
}

4、创建DTO类

创建一个DTO（Data Transfer Object）类，用于定义API请求和响应的模型。使用Swagger注解来描述模型字段和类型。以下是一个示例：

@ApiModel(description = "用户模型")  
public class UserDTO {  
    @ApiModelProperty(notes = "用户ID", required = true)  
    private Long id;  
    @ApiModelProperty(notes = "用户姓名", required = true)  
    private String name;  
    // 其他字段和注解...  
}

5、创建API接口和注解

在您的服务层或控制器层中，创建API接口和注解，使用Swagger注解来描述API的路径、请求方法、参数等信息。以下是一个示例：

@RestController  
@RequestMapping("/api")  
public class UserController {  
    @ApiOperation(value = "获取用户信息", notes = "根据ID获取用户信息")  
    @ApiImplicitParams({@ApiImplicitParam(name = "id", value = "用户ID", required = true, dataType = "Long")})  
    @GetMapping("/user/{id}")  
    public ResponseEntity getUserById(@PathVariable Long id) {  
        // 实现获取用户信息的逻辑...  
    }  
}

6、启动应用程序并访问API文档页面

启动您的Spring Boot应用程序，并在浏览器中输入应用程序的访问地址。您应该能够看到Swagger UI界面，其中包含了您的API文档和可用的API接口。