swagger @ApiModel添加实体类不生效的解决

@ApiModel添加实体类不生效 

swagger, @ApiModel, Models, 实体类无法加载

在使用swagger时, 以为加上@ApiModel在实体类上就可以在swagger-ui.html的Models里面显示.

但是我创建了很多实体类, 但怎么也只显示了一个???

swagger @ApiModel添加实体类不生效的解决_第1张图片

swagger @ApiModel添加实体类不生效的解决_第2张图片

swagger @ApiModel添加实体类不生效的解决_第3张图片

swagger @ApiModel添加实体类不生效的解决_第4张图片

Models中无论如何只有User这一个实体类。 后来发现不是加上@ApiModel就可以加入Models中的,必须要在controller层中关联这个实体类。由于我把所有实体类创建好后只测试了User,其它的实体类都没关联,所以swagger-ui.html中的Models没有实体类的显示。

swagger @ApiModel添加实体类不生效的解决_第5张图片

Models实体类无法显示

Swagger环境为:



    io.springfox
    springfox-swagger2
    2.9.2



    io.springfox
    springfox-swagger-ui
    2.9.2

编写实体类 User:

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

在controller中使用该实体类:

@PostMapping("/user")
public User user() {
    return new User();
}

却发现Models中根本没有User类的信息!

swagger @ApiModel添加实体类不生效的解决_第6张图片

解决办法

给实体类添加 get 和 set 方法!

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
@ApiModel("用户实体类")
public class User {
    @ApiModelProperty("用户名")
    private String username;
    @ApiModelProperty("密码")
    private String password;
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }    
}

成功显示!

swagger @ApiModel添加实体类不生效的解决_第7张图片

由此可知,以后写实体类的时候,写全!

构造方法,get、set方法,toString方法全都加上!

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

你可能感兴趣的:(swagger @ApiModel添加实体类不生效的解决)