我們要如何封裝這個結果?我們應該注意返回到前端的資料中包含的資訊。
#一般來說,首先,這次必須有一個code來表示介面的狀態。例如,0表示成功,1表示失敗,2表示必須傳遞錯誤的參數,4表示系統異常,依此類推。這只是一個簡單的例子。許多人可能會有疑問。 HTTP協定本身已經有了對應的回傳代碼定義。例如: 200表示成功, 500表示伺服器錯誤, 404表示找不到頁面。
例如,200表示請求成功,但它不能描述請求中的業務結果。例如,使用者名稱已經存在,事實上,業務並不成功,但HTTP的結果肯定是200, 因此我們需要一個代碼來描述我們的業務狀態。
除了程式碼之外,還有一些提示訊息,如操作成功、系統異常、使用者名稱已經存在等,所以我們新增了一個message欄位。
此外,還有我們的核心數據。例如,我根據ID取得資料。此資料的具體內容必須返回前端,因此必須有資料。此數據使用什麼類型?這種類型必須是多樣的,所以我們需要使用統一的父類,以便物件可以接收所有類型。當然,我們可以使用一些通用方法來方便操作。
然後還有我們的核心數據。例如,我根據ID取得資料。此資料的具體內容必須返回前端,因此必須有資料。此數據使用什麼類型?這種類型必須是多樣的,所以我們需要使用統一的父類,以便物件可以接收所有類型。當然,我們可以使用通用方法來方便操作。
主要程式碼展示:
public class Result<T> implements Serializable { private static final long serialVersionUID = -3960261604608758516L; private int code; private String msg; private T data; public static <T> Result<T> success() { return new Result<>(); } /** * 成功,默认状态码,返回消息,自定义返回数据 * @param data 自定义返回数据 * @param <T> 返回类泛型,不能为String * @return 通用返回Result */ public static <T> Result<T> success(T data) { return new Result<>(data); } /** * 成功,默认状态码,自定义返回消息,返回数据 * @param msg 自定义返回消息 * @param data 自定义返回数据 * @param <T> 返回类泛型 * @return 通用返回Result */ public static <T> Result<T> success(String msg, T data) { return new Result<>(msg, data); } /** * 成功,默认状态码,自定义返回消息,无返回数据 * * @param msg 自定义返回消息 * @param <T> 返回类泛型 * @return 通用返回Result */ public static <T> Result<T> success(String msg) { return new Result<>(msg); } /** * 失败,默认状态码,返回消息,无返回数据 * @param <T> 返回类泛型 * @return 通用返回Result */ public static <T> Result<T> error() { return new Result<>(ResultCode.ERROR); } /** * 失败,默认状态码,自定义返回消息,无返回数据 * @param <T> 返回类泛型 * @return 通用返回Result */ public static <T> Result<T> error(String msg) { return new Result<>(ResultCode.ERROR.getCode(), msg); } /** * 失败,自定义状态码,返回消息,无返回数据 * @param code 自定义状态码 * @param msg 自定义返回消息 * @param <T> 返回类泛型 * @return 通用返回Result */ public static <T> Result<T> error(int code, String msg) { return new Result<>(code, msg); } /** * 失败,使用CodeMsg状态码,返回消息,无返回数据 * @param resultCode CodeMsg,参数如下: * <p> code 状态码 * <p> msg 返回消息 * @param <T> 返回类泛型 * @return 通用返回Result */ public static <T> Result<T> error(ResultCode resultCode) { return new Result<>(resultCode); } /** * 成功构造器,无返回数据 */ private Result() { this(ResultCode.SUCCESS); } /** * 成功构造器,自定义返回数据 * @param data 返回数据 */ private Result(T data) { this(ResultCode.SUCCESS, data); } /** * 成功构造器,自定义返回消息,无返回数据 * @param msg 返回消息 */ private Result(String msg) { this(ResultCode.SUCCESS.getCode(), msg); } /** * 构造器,自定义状态码,返回消息 * @param code 状态码 * @param msg 返回消息 */ private Result(int code, String msg) { this.code = code; this.msg = msg; } /** * 成功构造器,自定义返回信息,返回数据 * @param msg 返回信息 * @param data 返回数据 */ private Result(String msg, T data) { this(ResultCode.SUCCESS.getCode(), msg, data); } /** * 构造器,自定义状态码,返回消息,返回数据 * @param code 状态码 * @param msg 返回消息 * @param data 返回数据 */ private Result(int code, String msg, T data) { this(code, msg); this.data = data; } /** * 构造器,使用CodeMsg状态码与返回信息,自定义返回数据 * @param resultCode CodeMsg,参数如下: * <p> code 状态码 * <p> msg 返回消息 * @param data 返回数据 */ private Result(ResultCode resultCode, T data) { this(resultCode); this.data = data; } /** * 构造器,使用CodeMsg状态码与返回信息 * @param resultCode CodeMsg,参数如下: * <p> code 状态码 * <p> msg 返回消息 */ private Result(ResultCode resultCode) { this(resultCode.getCode(), resultCode.getMsg()); } }
還需要定義幾個常見的錯誤
@Builder public class ResultCode implements Serializable { private static final long serialVersionUID = -6269841958947880397L; /** 状态码*/ private int code; /**状态信息*/ private String msg; /** 默认成功*/ public final static ResultCode SUCCESS = dispose(ResultCodeEnum.SUCCESS); /**默认失败*/ public final static ResultCode ERROR = dispose(ResultCodeEnum.ERROR); /**通用业务异常*/ public final static ResultCode BIZ_ERROR = dispose(ResultCodeEnum.BIZ_ERROR); /**文件超出最大限制*/ public final static ResultCode FILE_OUT_MAX = dispose(ResultCodeEnum.FILE_OUT_MAX); /**文件格式不正确*/ public final static ResultCode FILE_FORMAT_ERROR = dispose(ResultCodeEnum.FILE_FORMAT_ERROR); /** 参数错误*/ public final static ResultCode PARAM_ERROR = dispose(ResultCodeEnum.PARAM_ERROR); /**Json解析异常*/ public final static ResultCode JSON_FORMAT_ERROR = dispose(ResultCodeEnum.JSON_FORMAT_ERROR); /** Sql解析异常*/ public final static ResultCode SQL_ERROR = dispose(ResultCodeEnum.SQL_ERROR); /**网络超时*/ public final static ResultCode NETWORK_TIMEOUT = dispose(ResultCodeEnum.NETWORK_TIMEOUT); /** 未知的接口*/ public final static ResultCode UNKNOWN_INTERFACE = dispose(ResultCodeEnum.UNKNOWN_INTERFACE); /**请求方式不支持*/ public final static ResultCode REQ_MODE_NOT_SUPPORTED = dispose(ResultCodeEnum.REQ_MODE_NOT_SUPPORTED); /**系统异常*/ public final static ResultCode SYS_ERROR = dispose(ResultCodeEnum.SYS_ERROR); private static ResultCode dispose(ResultCodeEnum codeEnum) { return ResultCode.builder().code(codeEnum.getCode()).msg(codeEnum.getMsg()).build(); } public ResultCode(int code, String msg) { this.code = code; this.msg = msg; } }
以上是SpringBoot如何實現統一封裝回傳前端結果集的詳細內容。更多資訊請關注PHP中文網其他相關文章!