带有 Spring Webflux 功能端点的 SpringDoc答案

【问题标题】：SpringDoc with Spring Webflux functional endpoints带有 Spring Webflux 功能端点的 SpringDoc
【发布时间】：2022-01-02 17:25:28
【问题描述】：

我正在使用 Spring Webfluxs 的 functional endpoints 并希望为其生成一个 openAPI 定义。

我添加了SpringDoc，但生成的 openAPI 定义为空：

{
  "openapi": "3.0.1",
  "info": {
    "title": "OpenAPI definition",
    "version": "v0"
  },
  "servers": [
    {
      "url": "http://localhost:8080",
      "description": "Generated server url"
    }
  ],
  "paths": {},
  "components": {}
}

端点定义如下

@Configuration(proxyBeanMethods = false)
public class Routers {

    @Bean
    public RouterFunction<ServerResponse> uploadRoute(UploadHandler uploadHandler) {
        return RouterFunctions
                .route(POST("/api/upload").and(accept(MediaType.MULTIPART_FORM_DATA)), uploadHandler::handleUploadedFiles);
    }
}

是否可以从 Springs 的功能端点派生 openAPI 定义？

【问题讨论】：

标签： spring spring-boot spring-webflux openapi springdoc

【解决方案1】：

您可以使用功能性 DSL 或 @RouterOperations 注释。

更多详情请参阅springdoc-openapi documentation 的这一部分。

此示例代码显示的是一个演示代码，用于了解如何支持功能端点：

https://github.com/springdoc/springdoc-openapi-demos/tree/master/springdoc-openapi-spring-boot-2-webflux-functional

【讨论】：