swagger返回值是泛型，API文檔明確指明具體類型

00.目錄

01.Demo內容

02.API文檔

03.解決問題

04.最終結果

01.Demo內容

    01-1.Demo swagger依賴

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

    01-2.Bean

User Bean

@Data
@ApiModel("User VO模型")
public class User {

    private Integer id;
    private String name;

    private Dog dog;
}

Dog Bean

@Data
@ApiModel("Dog VO 模型")
public class Dog {

    private Integer id;
    private String name;

}

Result Bean

@ApiModel("Result 模型")
@Data
public class Result<T>{
    
    private String code;
    private String msg;
    private T data;
    
}

    01-3.Controller 

 

    @ApiOperation(value = "用戶列表")
    @ApiResponses(@ApiResponse(code = 200, message = "處理成功",response = Result.class))
    @GetMapping("/userList")
    public Result<User> getUsers() {
        return Result.success(userServcie.getUserList());
    }

02.API文檔

泛型的具體類型爲空。

03.解決問題

    @ApiOperation(value = "用戶列表")
    @ApiResponses(@ApiResponse(code = 200, message = "處理成功"
    /*,response = Result.class)*/)
    @GetMapping("/userList")
    public Result<User> getUsers() {
        return Result.success(new User());
    }

把response = Result.class去掉。

04.最終結果