但是生成的文件並不能滿足我們日常專案中的需求，舉個例子：

我們在專案中需要返回這種資料

{
  "code": 200,
  "msg": "string",
  "result": {
    "currentPage": 0,
    "list": [
      {
        "address": "string",
        "createTime": "2018-09-21T11:38:15.781Z",
        "description": "string",
        "id": 0,
        "name": "string"
      }
    ],
    "pageSize": 0,
    "totalCount": 0,
    "totalPage": 0
  },
  "version": "string"
}
 

從上面的資料可以分解為三個物件

首先是外層的通用返回物件

package com.ktnw.management.util;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

import java.io.Serializable;

@ApiModel("api介面通用返回物件")
public class ResultUtil implements Serializable{

    @ApiModelProperty(value = "返回碼",dataType = "int")
    private int code;

    @ApiModelProperty(value = "錯誤資訊",dataType = "String")
    private String msg;

    @ApiModelProperty(value = "api版本",dataType = "String")
    private String version;

    public int getCode() {
        return code;
    }

    public void setCode(int code) {
        this.code = code;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public String getVersion() {
        return version;
    }

    public void setVersion(String version) {
        this.version = version;
    }
}
 

第二層就是分頁物件(這裡我需要用到java中的泛型)

package com.ktnw.management.util;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

import java.io.Serializable;
import java.util.List;

@ApiModel("分頁物件")
public class PageUtil<T> implements Serializable {

    @ApiModelProperty(value = "頁碼",dataType = "int")
    private int currentPage;

    @ApiModelProperty(value = "頁面記錄數",dataType = "int")
    private int pageSize;

    @ApiModelProperty(value = "總頁數",dataType = "int")
    private int totalPage;

    @ApiModelProperty(value = "總記錄數",dataType = "long")
    private long totalCount;

    @ApiModelProperty(value = "分頁記錄",dataType = "List")
    private List<T> list;

    public PageUtil() {
        super();
    }

    public int getCurrentPage() {
        return currentPage;
    }

    public void setCurrentPage(int currentPage) {
        this.currentPage = currentPage;
    }

    public int getPageSize() {
        return pageSize;
    }

    public void setPageSize(int pageSize) {
        this.pageSize = pageSize;
    }

    public int getTotalPage() {
        return totalPage;
    }

    public void setTotalPage(int totalPage) {
        this.totalPage = totalPage;
    }

    public long getTotalCount() {
        return totalCount;
    }

    public void setTotalCount(long totalCount) {
        this.totalCount = totalCount;
    }

    public List<T> getList() {
        return list;
    }

    public void setList(List<T> list) {
        this.list = list;
    }
}
 

第三層就是我們需要使用到的引數物件

package com.ktnw.management.entity;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

import java.io.Serializable;
import java.util.Date;

@ApiModel("demo物件資訊")
public class Demo implements Serializable {

    @ApiModelProperty(value = "demo id",dataType = "int")
    private int id;

    @ApiModelProperty(value = "名稱",dataType = "String")
    private String name;

    @ApiModelProperty(value = "描述",dataType = "String")
    private String description;

    @ApiModelProperty(value = "地址",dataType = "String")
    private String address;

    @ApiModelProperty(value = "建立時間",dataType = "Date")
    private Date createTime;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    public String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    public Date getCreateTime() {
        return createTime;
    }

    public void setCreateTime(Date createTime) {
        this.createTime = createTime;
    }
}

光是這樣這樣是不能返回上面的json資料

還需要宣告一個專門的返回類（這裡需要用到java的繼承）

package com.ktnw.management.models;

import com.ktnw.management.entity.Demo;
import com.ktnw.management.util.PageUtil;
import com.ktnw.management.util.ResultUtil;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

@ApiModel(value = "demo分頁資訊",parent = ResultUtil.class)
public class DemoPageResult extends ResultUtil {

    @ApiModelProperty(value = "資料列表",dataType = "List")
    private PageUtil<Demo> result;

    public PageUtil<Demo> getResult() {
        return result;
    }

    public void setResult(PageUtil<Demo> result) {
        this.result = result;
    }
}

請求處理完成之後，我們直接返回 DemoPageResult  就行了