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

Question

我正在使用 Swagger 2.0 生成文档。在我的控制器类中，我有一些操作，例如：

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 。重点是，您需要创建自己的扩展来描述泛型。