使用Quarkus的反应性REST服务的OpenAPI规范

Question

我试图按照官方指南，使用RESTEasy和JSON-B来启动和运行一个反应性的REST服务。我还添加了对OpenAPI的支持，以测试遵循本指南的服务。

这两个部分都独立工作，服务正确地返回硬编码的演示数据。Swagger UI显示了可用的路由，并允许调用它们。

然而，它并不像我喜欢的那样顺利...

从简单的、无反应的路由中，模式被正确地提取出来：

Fruit:
  type: object
  properties:
    description:
      type: string
    name:
      type: string

java prettyprint-override">@GET
@Path("/{name}")
public Uni<Fruit> getOne(@PathParam(value = "name") String name) {
}

UniFruit:
  type: object

@GET
@Path("/{name}")
// @Schema(ref = "#/components/schemas/Fruit")  // Nope...
// @Schema(ref = "Fruit")                       // Nope...
public Uni<Fruit> getOne(@PathParam(value = "name") String name) {
}

理想情况下，我不想单独注释每个反应方法。

是否有一种方法可以在项目范围内配置，以便每当路由返回uni 或multi 时使用t架构？

Answer 1

我浏览了微配置文件OpenAPI规范https://github.com/eclipse/microprofile-open-api/blob/master/spec/src/main/asciidoc/microprofile-openapi-spec.adoc，但找不到一种方法来完成您所请求的项目范围的模式更改。您可以为给定的类执行此操作，但在这里该类是uni，并且根据参数化类型需要不同的模式。

因此，Quarkus中的修复似乎是可行的方法，除非SmallRye OpenAPI（实现）有一些特定的方法来做到这一点。