之前我们在写项目的实体类的时候，只是简单的写一个实体类，但是现在我们想要让实体类在swagger界面显示，

首先是写一个实体类
只要这个实体在请求接口的返回值上（即使是泛型），都能映射到实体项中：

@ApiModel("用户实体")
public class User {
   
    @ApiModelProperty("用户名")
    public String username;
    @ApiModelProperty("密码")
    public String password;
}

这个实体类上面的注解的意思，只是给这个类名，属性名的一个注释，可以让这个注释在swagger页面显示，好解释对应的这个是啥意思。

之后在controller层写一个接口，返回值是user对象

启动项目，我们就可以看到


注：并不是因为@ApiModel这个注解让实体显示在这里了，而是只要出现在接口方法的返回值上的实体都会显示在这里，而@ApiModel和@ApiModelProperty这两个注解只是为实体添加注释的。

@ApiModel为类添加注释

@ApiModelProperty为类属性添加注释4

swagger常用的注解

Swagger的所有注解定义在io.swagger.annotations包下

下面列一些经常用到的，未列举出来的可以另行查阅说明：

Swagger注解	简单说明
@Api(tags = "xxx模块说明")	作用在模块类上
@ApiOperation("xxx接口说明")	作用在接口方法上
@ApiModel("xxxPOJO说明")	作用在模型类上：如VO、BO
@ApiModelProperty(value = "xxx属性说明",hidden = true)	作用在类方法和属性上，hidden设置为true可以隐藏该属性
@ApiParam("xxx参数说明")	作用在参数、方法和字段上，类似@ApiModelProperty

这些注解除了在pojo层进行使用，还可以在controller层进行使用

@ApiOperation("接口")
@PostMapping("/jing")
@ResponseBody
public String jing(@ApiParam("这个名字会被返回")String username){
   
   return username;
}