招摇过市-Springfox总是生成一些响应消息（401403…）默认情况下。我怎样才能移除它们？

Question

我有这样简单的控制器：

java prettyprint-override">@RequestMapping(value="/async/data", method=RequestMethod.GET, produces="application/json")
@ApiOperation(value = "Gets data", notes="Gets data asynchronously")
@ApiResponses(value={@ApiResponse(code=200, message="OK")})
public Callable<List<Data>> getData(){
    return ( () -> {return dataService.loadData();} );
}

我原以为只有HTTP状态200的响应消息。然而，springfox总是生成下面的（401, 403, 404)。如何禁用（不显示）它们？

async-rest-controller Show/Hide List Operations Expand Operations
GET /async/data Gets data

Implementation Notes
Gets data asynchronously

Response Class (Status 200)
ModelModel Schema
{}

Response Content Type 

Response Messages
HTTP Status Code    Reason  Response Model  Headers
401 Unauthorized        
403 Forbidden       
404 Not Found

Answer 1

除了使用

new Docket().useDefaultResponseMessages(false)

根据要返回的状态代码，您可能还需要使用此注释：

@ResponseStatus(HttpStatus.CREATED)

⚠️ 不要在WebFlux中使用ResponseEntity，因为这将始终添加200个代码。查看此github问题。

Answer 2

您应该能够设置插件不使用默认的响应消息。请遵循以下不同版本的说明。

对于1.0.2或之前

  new SwaggerSpringMvcPlugin(...)
        //More config
        .useDefaultResponseMessages(false) //<-- this should be false
  ...;

对于2. x

  new Docket()
        //More config
        .useDefaultResponseMessages(false) //<-- this should be false
  ...;