首页 > 其他 > 详细

Swagger中常用注解

时间:2020-12-11 14:24:02      阅读:25      评论:0      收藏:0      [点我收藏+]

使用swagger时,

@ApiOperation表示生成API文档,

@Apiignore表示忽略生成。

 

@ApiIgnore 可以用在类、方法上,方法参数中,用来屏蔽某些接口或参数,使其不在页面上显示。
1、作用在类上时,整个类都会被忽略

@ApiIgnore
@Api(tags = {"Xxx控制类"})
@RestController
@RequestMapping("/xxx")
public class XxxController {
		......
}

 隐藏某个类还可以用@Api注解自带的hidden属性:

@Api(value = "xxx", tags = "xxx",hidden = true)

当hidden为true时,该类隐藏

 2、当作用在方法上时,方法将被忽略

@ApiIgnore
@ApiOperation(value = "xxx", httpMethod = "POST", notes = "xxx")
@ApiImplicitParams({
        @ApiImplicitParam(name = "xxx", value = "xxx", paramType = "query", dataType = "String", required = true)
})
@PostMapping("/xxx")
public Result importCarryEquExcel(String xxx) {
                ......
}

隐藏某个方法还可以用@APIOperation注解自带的hidden属性

@ApiIgnore
@ApiOperation(value = "xxx", httpMethod = "POST", notes = "xxx")
@ApiImplicitParams({
        @ApiImplicitParam(name = "xxx", value = "xxx", paramType = "query", dataType = "String", required = true)
})
@PostMapping("/xxx")
public Result importCarryEquExcel(String xxx) {
                ......
}

隐藏某个方法还可以用@APIOperation注解自带的hidden属性:

@ApiOperation(value = "xxx", httpMethod = "GET", notes = "xxx",hidden = true)

当hidden为true时,该方法隐藏

3、作用在参数上时,单个具体的参数会被忽略

public String abc(@ApiIgnore String a, String b, String c){
    return "a" + "b" + "c";
  }

 

Swagger中常用注解

原文:https://www.cnblogs.com/javakangkang/p/14118816.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!