为什么要统一返回值

定义统一的数据返回格式有利于提高开发效率、降低沟通成本，降低调用方的开发成本。目前比较流行的是基于JSON格式的数据交互。无论是HTTP接口还是RPC接口，保持返回值格式统一很重要。

一般情况下，统一返回数据格式没有固定的规范，只要能描述清楚返回的数据状态以及要返回的具体数据即可，但是一般会包含状态码、消息提示语、具体数据这3部分内容。

{"code": 20000,"message": "成功","data": {"items": [{"id": "1","name": "weiz","intro": "备注"}]}
}

定义的返回值包含4要素：响应结果、响应码、消息、返回数据。

统一数据返回

数据格式

定义的返回值包含如下内容：

• Integer code：成功时返回0，失败时返回具体错误码。
• String message：成功时返回null，失败时返回具体错误消息。
• T data：成功时返回具体值，失败时为null。
  • data字段为泛型字段，根据实际的业务返回前端需要的数据类型。

{"code": 20000,"message": "成功","data": {"items": [{"id": "1","name": "weiz","intro": "备注"}]}
}

状态码

返回的数据中有一个非常重要的字段：状态码。状态码字段能够让服务端、客户端清楚知道操作的结果、业务是否处理成功，如果失败，失败的原因等信息。

其他的业务相关状态码需要根据实际业务定义。

定义数据处理类

视图对象（响应数据结构）：

package com.qsdbl.malldemo.entity.vo;import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;/*** @description vo - 视图对象* @author: 轻率的保罗* @since: 2022-11-26* @version V1.0*/
@Data
@ApiModel("响应数据结构")
public class DataVo