@ ApiResponse上的Swagger API文档，地图作为responseContainer不起作用

Question

我有一个返回Map<String,MyObject>的端点

public Response doStuff(){
  Map<String,MyObject> map = getMap();
  return Response.ok(map ).build();
}

因此，我很疲倦地将API描述如下：

@ApiResponses({@ApiResponse(code = 200, message = "OK", response = MyObject.class, responseContainer = "Map[String,MyObject]")}
public Response doStuff(){
   Map<String,MyObject> map = getMap();
   return Response.ok(map ).build();
}

在swagger UI中，这仅使我将MyObject模型渲染为返回类型，而忽略了Map和String键。

当我像这样声明端点时（最终我会not这样做）

public  Map<String,MyObject> doStuff(){
  ...
}

swagger ui可以按预期方式呈现模型：

我找不到任何有关Map作为响应容器的有用文档。

如何在Map<String,MyObject批注中声明@ApiResponse的返回模型？

Answer 1

尝试此