我想知道是否有可能只在swagger-core annotations上使用jax-rs或springfox等任何适配器的帮助来构建Swagger文档?
为什么要问这个问题:例如当使用springfox时,它依赖于Spring注释,如 @RequestMapping
, @ResponseStatus
等 . 想象一下,我想指定一个默认返回201的POST方法:
@ApiOperation(value = "some api")
@ApiResponses(value = {
@ApiResponse(code = 201, message = "Created")
})
@RequestMapping(method = RequestMethod.POST)
@ResponseStatus(HttpStatus.CREATED)
如果没有最后一行,springfox将默认生成200状态,我不希望向控制器添加命令式 @ResponseStatus
注释 .
即我希望完全控制生成的API规范,该规范应该仅依赖于swagger核心注释 .