Swagger 在 204 (No Content) 上生成响应正文

Question

这是一个删除端点：

@ApiOperation(value = "delete subscription")
@ApiResponses(value = {
                @ApiResponse(code = 204, message = "Deleted", response = Void.class),
                @ApiResponse(code = 404, message = "Not Found")
})
@DeleteMapping("/{id}")
@ResponseStatus(HttpStatus.NO_CONTENT)
public ListenableFuture<ResponseEntity<Void>> delete(@PathVariable long id)

Springfox 生成带有响应正文的 API 规范：

{
  "cancelled": true,
  "done": true
}

显然我希望 204 的响应正文规范为空白。如何实现这一点？

注意如果我将端点更改为同步：

public void delete(@PathVariable long id)

那么生成的API就好了。

Answer 1

尝试添加

.genericModelSubstitutes(ListenableFuture.class)

到您的 Docket 配置以支持 ListenableFuture<T>。

文档：http://springfox.github.io/springfox/javadoc/2.7.0/springfox/documentation/spring/web/plugins/Docket.html#genericModelSubstitutes(java.lang.Class...)

用它的直接参数化类型替换每个泛型类。 genericModelSubstitutes(ResponseEntity.class) 将替代 ResponseEntity 与 MyModel

例如：

return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.any())
            .paths(PathSelectors.any())
            .build()
            .genericModelSubstitutes(ListenableFuture.class);