时间:2021-05-19
前后端分离的项目开发前,会提前规定好数据返回格式,本文以JSON为例。
第一步,定义好JavaBean。
package com.yclouds.myhelper.web.response; import com.fasterxml.jackson.annotation.JsonIgnore;import com.yclouds.myhelper.web.error.code.BaseEnumError;import java.io.Serializable;import lombok.Data; /** * 所有服务统一响应数据格式 * * @author ye17186 * @version 2019/2/15 14:40 */@Datapublic class ApiResp<T> implements Serializable { private static final long serialVersionUID = 9211889136173018364L; /** * 正常响应码 */ private static final int SUCCESS_CODE = 0; /** * 正常响应消息 */ private static final String SUCCESS_MSG = "SUCCESS"; /** * 错误码 */ private int code = SUCCESS_CODE; /** * 错误信息 */ private String msg = SUCCESS_MSG; /** * 响应内容,默认为null */ private T data = null; /** * 是否的正常响应 * * @return true=正常;false=异常 */ @JsonIgnore public boolean isOK() { return code == SUCCESS_CODE; } /** * 无data的正常返回 */ public static ApiResp retOK() { return new ApiResp(); } /** * 有data的正常返回 * * @param data data内容 * @param <T> data类型 */ public static <T> ApiResp<T> retOK(T data) { ApiResp<T> response = new ApiResp<>(); response.setData(data); return response; } /** * 无data的失败返回 * * @param error 错误类型 */ public static ApiResp retFail(BaseEnumError error) { return retFail(error.getCode(), error.getMsg()); } /** * 有data的失败返回 * * @param error 错误类型 * @param data 详细错误信息 */ public static <T> ApiResp<T> retFail(BaseEnumError error, T data) { return retFail(error.getCode(), error.getMsg(), data); } /** * 无data的失败返回 * * @param code 错误码 * @param msg 错误信息 */ public static <T> ApiResp<T> retFail(int code, String msg) { ApiResp<T> response = new ApiResp<>(); response.setCode(code); response.setMsg(msg); return response; } /** * 有data的失败返回 * <br> * 失败返回的场景不多,所以没有严格要求T泛型 * * @param code 错误码 * @param msg 错误信息 */ public static <T> ApiResp<T> retFail(int code, String msg, T data) { ApiResp<T> response = new ApiResp<>(); response.setCode(code); response.setMsg(msg); response.setData(data); return response; }}第二步,在Controller中使用
@GetMapping("/test1") public ApiResp test1() { return ApiResp.retOK("Hello World"); } @GetMapping("/test2") public ApiResp test2() { return ApiResp.retFail(BaseEnumError.SYSTEM_NO_LOGIN); }可以在Postman查看具体的响应内容如下:
当然,ApiResp中的泛型,也可以使用复杂的数据对象。实际开发中,每种错误响应都有自己的响应码code,和错误信息msg,示例中统一定义了一个BaseEnumError的枚举类,具体内容可参照我的github项目https://github.com/ye17186/myhelper-spring-boot-starter
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。
在开发过程中,我们需要统一返回前端json格式的数据,但有些接口的返回值存在null或者""这种没有意义的字段。不仅影响理解,还浪费带宽,这时我们可以统一做一下
网络中数据传输经常是xml或者json,现在做的一个项目之前调其他系统接口都是返回的xml格式,刚刚遇到一个返回json格式数据的接口,通过例子由易到难总结一下
本文实例讲述了Laravel框架实现修改登录和注册接口数据返回格式的方法。分享给大家供大家参考,具体如下:1、背景:需要将所有的数据返回格式统一成retCode
在调用后端接口时,由于后端接口的不规范统一,接口最外层在没有数据时返回的是空数组(其实更想要的是空json对象),而在有数据时返回的是json对象,所以在接收到
业务场景:业务需求要求,需要对WebApi接口服务统一返回参数,也就是把实际的结果用一定的格式包裹起来,比如下面格式:{"response":{"code":2