也许我的回答会帮助别人。
如Dilip Krishnan在his answer中,您可以使用io.swagger.annotations.ApiParam
或io.swagger.annotations.ApiImplicitParam
Swagger批注用于精细调整的自定义文档。
@ApiParam
可以用于注册方法参数。
@ApiImplicitParam
可以在API参数没有明确注册的情况下使用。
@RestController
@RequestMapping(value = "/v1/test", produces = "application/json")
@Api(value = "/v1/test")
public class TestController {
@ApiOperation(value = "Do Something method", tags = "Test method")
@RequestMapping(value = "/doSomeThing", method = RequestMethod.GET)
public Foo doSomeThing(
@ApiParam(value = "Param1 Description", required = true)
@RequestParam String param) {
throw new UnsupportedOperationException("do Some Things");
}
@ApiOperation(value = "Do Something Another method", tags = "Test method")
@ApiImplicitParams({
@ApiImplicitParam(name = "anotherParam1", value = "Another Param1 Description", paramType = "header"),
@ApiImplicitParam(name = "anotherParam1", value = "Another Param1 Description", paramType = "header")
})
@RequestMapping(value = "/doSomeThingAnother", method = RequestMethod.GET)
public Foo doSomeThingAnother(Bar bar) {
throw new UnsupportedOperationException("do Some Thing Another");
}
}
而在最后,你可以看到下面的图片
不明白为什么这个问题是downvoted两次? – Gandhi