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

Question

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

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

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

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

这里，Swagger留档没有说响应是页面

如果我有以下返回类型呢？

java prettyprint-override">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。关键是，您需要创建自己的扩展来描述泛型。