我想知道是否可以仅在swagger-core annotations w / o jak-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核心注释。