swagger - Swagger 2.0 将如何处理参数或返回类型中的泛型？

Question

我正在使用 Swagger 2.0 来生成文档。在我的 Controller 类中，我有一些操作，例如:

public Page<Employee> getEmployees(Pageable pageable) {....}

为响应上述操作而生成的 Swagger 文档:

"responses" : {
          "200" : {
            "schema" : {
              "$ref" : "#/definitions/Page"
              } 
            }
          }

这里，Swagger 文档没有说响应是 Page<Employee> 。如何在 Swagger 文档中获取泛型数据？

如果我有以下返回类型怎么办？

Page<String,Employee>
Page<Employee,List<Department>>
Page<Employee,Tuple.Two<String,User>>

Swagger 操作参数和模型属性也是如此。

Answer 1

这是 Swagger 的一个已知问题，请检查以下问题:https://github.com/OAI/OpenAPI-Specification/issues/957 。重点是，您需要创建自己的扩展来描述泛型。