java - 在 swagger 注释中参数化类

Question

从我的 Spring 休息服务中，我返回的响应为 -

return new ResponseEntity<ExampleOutputData>(exampleService.exampleServiceCall(inputData), responseHeaders, HttpStatus.ACCEPTED);

我在注释中提到的响应是 -

 @ApiResponses(value = { 
            @ApiResponse(code = 202, message = "Success", response = ResponseEntity.class)}) 

我收到的 yaml 文档响应为 -

  responses:
    202:
      description: "Success"
      schema:
        $ref: "#/definitions/ResponseEntity"

我的问题是如何在响应中提及ExampleOutputData，因为实际上我的响应是 ResponseEntity<ExampleOutputData>

或者这不是必需的，并且当前的实现和 swagger 定义是完美的？

Answer 1

为了在响应中包含ExampleOutputData，您只需将ResponseEntity.class更改为ExampleOutputData.class:

@ApiResponses(value = {@ApiResponse(code = 202, message = "Success", response = ExampleOutputData.class)})

查看文档 here .