如何在openApi/springfox-swagger2中为不同的状态码定义不同的响应模型

Question

给定以下带有springfox-swagger2注释的REST方法：

@GetMapping(value = "/access", produces = MediaType.APPLICATION_JSON_VALUE)
@ApiOperation(value = "check access allowed")
@ApiResponses({
        @ApiResponse(code = 200, message = "okay, there you go", response = AccessResponse.class),
        @ApiResponse(code = 204, message = "I got nothing for you", response = Void.class)
})
public ResponseEntity<AccessResponse> access() {

    if (!isAccessEnabled()) {
        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
    }
    AccessResponse response = new AccessResponse("some data");
    return ResponseEntity.ok(response);
}

null

"responses":{
  "200":{
    "description":"okay, there you go",
    "schema":{"$ref":"#/definitions/AccessResponse"}
    },
  "204":{
    "description":"I got nothing for you",
    "schema":{"$ref":"#/definitions/AccessResponse"}
    }
}

我是不是漏掉了什么？有没有办法告诉swagger为每个HTTP/OK状态代码呈现两个不同的模型？

Answer 1

我已经更改了方法的返回类型--删除了泛型类型：

public ResponseEntity access()

其结果是更好的（但不是完美的）模型描述：

"204":{
   "description": "I got nothing for you",
   "schema":{"type":"object"}
}