全局统一返数据类型封装记录

全局统一返回值封装

​ 在Spring Boot中,实现全局统一返回值封装是一种常见的做法,它有助于保持API的一致性,并简化前端对响应数据的处理。创建一个响应体类,包含状态码、消息、数据等字段。这个类可以作为所有控制器返回值的通用格式。

​ 下面通过三种类型的统一返回响应体来实现全局统一返回值的封装!(大同小异)

​ 这里做个记录文档方便下次开发使用!!

一、返回自定义类型(常用)

1.1 封装响应状态码枚举Enum类

​ 这里的枚举类型可以自己封装。也可以使用 Hutool 工具包类中的枚举类型,针对Http响应,Hutool封装了一个类用于保存Http状态码。

​ 在Hutool工具类中, HttpStatus 是一个枚举类,它用于表示HTTP响应的状态码及其对应的描述。HttpStatus 类中定义了很多常见的HTTP状态码,如200、404、500等,并提供了方便的方法来获取状态码和描述。

  • 使用Hutool包中的枚举

    要使用Hutool的 HttpStatus ,首先确保你已经将Hutool的依赖添加到了你的项目中。如果你使用的是Maven,可以在 pom.xml 文件中添加如下依赖:

<!-- Hutool Java工具类库 -->
<dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.8.18</version>
</dependency>

​ 直接使用Hutool工具包中的枚举类型:在这里插入图片描述

  • 自定义封装Http状态码枚举类 ResultCodeEnum
/*** @author: AD_Liu* @Description: 响应状态码* @ClassName: HttpStatus*/
@Getter
public enum ResultCodeEnums {SUCCESS(200, "操作成功"),CREATED(201, "对象创建成功"),ACCEPTED(202, "请求已经被接受"),NO_CONTENT(204, "操作已经执行成功,但是没有返回数据"),MOVED_PERMANENTLY(301, "请求的URL已经移走"),SEE_OTHER(302, "请求的URL已经改变"),NOT_MODIFIED(304, "资源没有被修改"),BAD_REQUEST(400, "参数列表错误(缺少,格式不匹配)"),UNAUTHORIZED(401, "未授权"),FORBIDDEN(403, "访问受限,授权过期"),NOT_FOUND(404, "资源,服务未找到"),BAD_METHOD(405, "不支持当前请求方法"),CONFLICT(409, "资源冲突,或者资源被锁"),UNSUPPORTED_TYPE(415, "不支持的数据,媒体类型"),ERROR(500, "系统内部错误"),NOT_IMPLEMENTED(501, "接口未实现"),WARN(601, "系统警告");private final int code;private final String message;ResultCodeEnums(Integer code, String message) {this.code = code;this.message = message;}
}

1.2 统一响应体类

PS注:需要指定响应数据data的类型

package com.ainuoshengwu.answspringboot.common;
import com.ainuoshengwu.answspringboot.common.enums.HttpStatusEnums;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;
import java.io.Serializable;
/*** @ClassName : R* @Description : 全局响应数据结构 视图对象* @Author : AD*/
@Data
@NoArgsConstructor
@AllArgsConstructor
/** chain:支持链式编程  fluent:忽略get/set前缀 */
@Accessors(chain = true,fluent = true)
public class R<T> implements Serializable {/** 业务响应状态 */private Integer code;/** 响应消息:一般为请求处理失败后返回的错误提示 */private String msg;/** 响应中的数据 */private T data;/*** 返回成功消息* */public static R success(String msg,Object date){return new R(HttpStatusEnums.SUCCESS.getCode(),msg,date);}public static R success(String msg){return R.success(msg,null);}public static R success(Object date){return R.success(HttpStatusEnums.SUCCESS.getMessage(),date);}public static R success(){return R.success(HttpStatusEnums.SUCCESS.getMessage());}/*** 返回警告信息* */public static R warn(String msg,Object data) {return new R(HttpStatusEnums.WARN.getCode(), msg, data);}public static R warn(String msg){return R.warn(msg,null);}public static R warn(Object data){return R.warn(HttpStatusEnums.WARN.getMessage(),data);}public static R warn(){return R.warn(HttpStatusEnums.WARN.getMessage());}/*** 返回错误信息* */public static R error(String msg,Object data){return new R(HttpStatusEnums.ERROR.getCode(),msg,data);}public static R error(){return R.error(HttpStatusEnums.ERROR.getMessage(),null);}public static R error(String msg){return R.error(msg,null);}public static R error(int code,String msg){return new R(code,msg,null);}
}

二、返回JSONObject类型

2.1 响应体封装

package cn.zhidasifang.camundaproject.utils;
import com.alibaba.fastjson.JSONObject;
import kotlin.jvm.JvmOverloads;/*** @Description: 统一返回值工具类* @ClassName: R*/
public class R extends JSONObject {/***@Description--请求操作成功!!*@Param [msg, resultObj]*@return cn.zhidasifang.camundaproject.utils.R*/public static R ok(String msg,Object resultObj){R jsonObject = new R();jsonObject.put("result","ok");jsonObject.put("msg",msg);jsonObject.put("resultObj",resultObj);return jsonObject;}//@Overloadspublic static R ok(String msg){R jsonObject = new R();jsonObject.put("result","ok");jsonObject.put("msg",msg);jsonObject.put("resultObj",null);return jsonObject;}/***@Description--请求错误返回数据!*@Param [msg, resultObj]*@return cn.zhidasifang.camundaproject.utils.R*/public static R error(String msg,Object resultObj){R r = new R();r.put("result","error");r.put("msg",msg);r.put("resultObj",resultObj);return r;}/***@Description--请求获取数据失败的返回参数*@Param [msg, resultObj]*@return cn.zhidasifang.camundaproject.utils.R*/public static R fail(String msg,Object resultObj){R r = new R();r.put("result","fail");r.put("msg",msg);r.put("resultObj",resultObj);return r;}
}

三、返回HashMap类型(推荐使用)

3.1 响应状态码枚举类型封装

/*** @author: AD_Liu* @Description: 响应状态码* @ClassName: HttpStatus*/
@Getter
public enum HttpStatusEnum {SUCCESS(200, "操作成功"),CREATED(201, "对象创建成功"),ACCEPTED(202, "请求已经被接受"),NO_CONTENT(204, "操作已经执行成功,但是没有返回数据"),MOVED_PERMANENTLY(301, "请求的URL已经移走"),SEE_OTHER(302, "请求的URL已经改变"),NOT_MODIFIED(304, "资源没有被修改"),BAD_REQUEST(400, "参数列表错误(缺少,格式不匹配)"),UNAUTHORIZED(401, "未授权"),FORBIDDEN(403, "访问受限,授权过期"),NOT_FOUND(404, "资源,服务未找到"),BAD_METHOD(405, "不支持当前请求方法"),CONFLICT(409, "资源冲突,或者资源被锁"),UNSUPPORTED_TYPE(415, "不支持的数据,媒体类型"),ERROR(500, "系统内部错误"),NOT_IMPLEMENTED(501, "接口未实现"),WARN(601, "系统警告");private final int code;private final String message;HttpStatusEnum(Integer code, String message) {this.code = code;this.message = message;}
}

3.2 统一返回值实体类封装

import cn.hutool.core.util.ObjectUtil;
import cn.zhidasifang.common.enums.HttpStatusEnum;
import java.io.Serializable;
import java.util.HashMap;
import java.util.Objects;/*** @author: AD_Liu* @Description: 同一响应数据类型* @ClassName: ApiResult*/
public class ApiResult<T> extends HashMap<String, Object> implements Serializable {/*** 状态码*/public static final String CODE_TAG = "code";/*** 返回内容*/public static final String MSG_TAG = "msg";/*** 数据对象*/public static final String DATA_TAG = "data";/*** 构造器* */public ApiResult() {}public ApiResult(int code, String msg) {super.put(CODE_TAG, code);super.put(MSG_TAG, msg);}public ApiResult(int code, String msg,Object data) {super.put(CODE_TAG, code);super.put(MSG_TAG, msg);if (ObjectUtil.isNotNull(data)) {super.put(DATA_TAG, data);}}/*** 返回成功消息* */public static ApiResult success(String msg,Object date){return new ApiResult(HttpStatusEnum.SUCCESS.getCode(),msg,date);}public static ApiResult success(String msg){return ApiResult.success(msg,null);}public static ApiResult success(Object date){return ApiResult.success(HttpStatusEnum.SUCCESS.getMessage(),date);}public static ApiResult success(){return ApiResult.success(HttpStatusEnum.SUCCESS.getMessage());}/*** 返回警告信息* */public static ApiResult warn(String msg,Object data) {return new ApiResult(HttpStatusEnum.WARN.getCode(), msg, data);}public static ApiResult warn(String msg){return ApiResult.warn(msg,null);}/*** 返回错误信息* */public static ApiResult error(String msg,Object data){return new ApiResult(HttpStatusEnum.ERROR.getCode(),msg,data);}public static ApiResult error(){return ApiResult.error(HttpStatusEnum.ERROR.getMessage(),null);}public static ApiResult error(String msg){return ApiResult.error(msg,null);}public static ApiResult error(int code,String msg){return new ApiResult(code,msg,null);}/*** 检验消息类型* */public boolean isSuccess() {return Objects.equals(HttpStatusEnum.SUCCESS.getCode(), this.get(CODE_TAG));}public boolean isWarn() {return Objects.equals(HttpStatusEnum.WARN.getCode(), this.get(CODE_TAG));}public boolean isError(){return Objects.equals(HttpStatusEnum.ERROR.getCode(), this.get(CODE_TAG));}/*** 从写HashMap的put方法,方便链式编程* */@Overridepublic ApiResult put(String key,Object value){super.put(key,value);return this;}
}

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/791528.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Vue.js组件精讲 开篇:Vue.js的精髓——组件

写在前面 Vue.js&#xff0c;无疑是当下最火热的前端框架 Almost&#xff0c;而 Vue.js 最精髓的&#xff0c;正是它的组件与组件化。写一个 Vue 工程&#xff0c;也就是在写一个个的组件。 业务场景是千变万化的&#xff0c;而不变的是 Vue.js 组件开发的核心思想和使用技巧…

达梦配置ODBC连接

达梦配置ODBC连接 基础环境 操作系统&#xff1a;Red Hat Enterprise Linux Server release 7.9 (Maipo) 数据库版本&#xff1a;DM Database Server 64 V8 架构&#xff1a;单实例1 下载ODBC包 下载网址&#xff1a;https://www.unixodbc.org/ unixODBC-2.3.0.tar.gz2 编译并…

python-django物流仓储进销存配送管理系统flask_1ea2k

实现了一个完整的物流管理系统&#xff0c;其中主要有站点信息模块、物流进度模块、用户表模块、司机模块、入库信息模块、签收信息模块、类型模块、快递信息模块、客户模块、客服模块、公告信息模块、服务类型模块、配置文件模块、出库信息模块、车辆信息模块、仓管模块、账户…

有一个已排好序的数组,要求输入一个数后,按原来排序的规律将它插入数组中

#include <stdio.h> // 标准输入输出头文件 int main(){ // 初始化数组a&#xff0c;包含10个有序整数 int a[11]{1,4,6,9,13,16,19,28,40,100}; int temp1,temp2,number,end,i,j; // 打印数组a的当前内容 printf("请输入数组a:\n"…

Lucky Chains

题目链接 Educational Codeforces Round 139 (Rated for Div. 2) D. Lucky Chains 取模的性质&#xff0c;更相减损术 思路&#xff1a; 我们假设链的长度为 w w w&#xff0c;不妨设 x ≥ y x\ge y x≥y&#xff0c;那么 g c d ( x k , y k ) 1 ( 0 ≤ k ≤ w ) gcd…

生成式AI的情感实验——AI能否产生思想和情感?

机器人能感受到爱吗&#xff1f;这是一个很好的问题&#xff0c;也是困扰了科学家们很多年的科学未解之谜。虽然我们尚未准备好向智能机器赋予情感&#xff0c;但智能机器却已经可以借助生成式人工智能&#xff08;AI&#xff09;来帮助我们表达自己的情感。 自然情感表达 AI正…

阻抗控制中的effort and flow

阻抗控制&#xff0c;由Hogan在&#xff08;Hogan&#xff0c;1985&#xff09;中首次描述&#xff0c;已被广泛应用于机器人系统的控制中&#xff0c;以调节交互或接触任务的遵从性。阻抗表示运动与相互作用力或扭矩之间的动态关系。 阻抗控制是一种基于力的控制方法&#xf…

leetcode3100--换水问题II

1. 题意 经典空瓶换汽水问题 2. 题解 直接模拟即可 class Solution { public:int maxBottlesDrunk(int numBottles, int numExchange) {int ans 0;while (numBottles > numExchange) {ans numExchange;numBottles - numExchange - 1;numExchange;}return ans numBott…

risc-v向量扩展strlen方法学习

riscv向量文档中给出了strlen的实现&#xff0c; 大概是这么一个思路&#xff0c; 加载向量: 使用向量加载指令&#xff08;如 vload&#xff09;从内存中加载一个向量长度的字符。比较向量与零: 使用向量比较指令&#xff08;如 vmask 或 vcmpeq&#xff09;来检查向量中的每…

加快形成新质生产力的重要着力点

新一轮科技革命和产业变革、大国竞争加剧以及我国经济发展方式转型等重大挑战在当下形成历史性交汇&#xff0c;这也为我国创造了重要的战略机遇。想要牢牢抓住发展的“机会窗口”&#xff0c;必须以科技创新推动产业创新&#xff0c;以产业升级构筑竞争新优势&#xff0c;加快…

Linux网络协议栈从应用层到内核层④

文章目录 1、网卡接受数据2、网络设备层接收数据3、ip层接受数据4、tcp层接受数据5、上层应用读取数据6、数据从网卡到应用层的整体流程 1、网卡接受数据 当网卡收到数据时&#xff0c;会触发一个中断&#xff0c;然后就会调用对应的中断处理函数&#xff0c;再做进一步处理。…

Least Prefix Sum

题目链接 Hello 2023 C. Least Prefix Sum 思路&#xff1a; 仔细看式子&#xff0c;发现可以对它进行推理&#xff08; m m m 是定值&#xff0c; 1 ≤ k ≤ n 1\le k\le n 1≤k≤n &#xff09;&#xff1a; 当 k ≤ m k\le m k≤m 时&#xff0c;有 a 1 a 2 ⋯ a …

pycharm

✅作者简介&#xff1a;CSDN内容合伙人、阿里云专家博主、51CTO专家博主、新星计划第三季python赛道Top1&#x1f3c6; &#x1f4c3;个人主页&#xff1a;hacker707的csdn博客 &#x1f525;系列专栏&#xff1a;零基础学Python &#x1f4ac;个人格言&#xff1a;不断的翻越一…

ubuntu22.04 静态IP设置脚本

#!/bin/bash# 设置静态IP地址的脚本# 网卡名称 interface"ens33"# 静态IP地址 ip_address"192.168.225.2"# 子网掩码长度 subnet_mask_len"24"# 默认网关 default_gateway"192.168.225.1"# DNS服务器 dns_servers"[114.114.114.1…

企业计算机服务器中了mallox勒索病毒怎么办?Mallox勒索病毒解密流程步骤

网络技术的不断应用与发展&#xff0c;为企业的生产运营带来了极大便利&#xff0c;企业通过网络办公开展各项工作业务已经成为常态&#xff0c;网络为企业的发展带来了更多机遇&#xff0c;但随之而来的网络数据安全威胁也在不断增加。近期&#xff0c;云天数据恢复中心接到山…

19k star, 导出微信聊天记录,生成 HTML、Word、CSV等格式,并分析聊天数据,做成可视化年报

19k star, 导出微信聊天记录&#xff0c;生成 HTML、Word、CSV等格式&#xff0c;并分析聊天数据&#xff0c;做成可视化年报 分类 开源分享 项目名: 留痕 -- 一款强大的微信聊天管理工具 Github 开源地址&#xff1a;https://github.com/LC044/WeChatMsg Gitee 开源地址&…

分布式架构中一些常用算法的理解

对分布式算法 - 一致性Hash算法的理解 一致性哈希算法是一种分布式算法&#xff0c;用于解决数据分布和负载均衡问题。它通过将数据和节点映射到一个哈希环上&#xff0c;实现了数据在节点之间的均匀分布和最小化数据迁移。 一致性哈希算法的核心思想是将数据和节点都映射到哈…

python随笔学习

python里面的高阶函数: 在Python中&#xff0c;高阶函数是指能够接收其他函数作为参数&#xff0c;或者将函数作为返回值的函数。这种特性使得函数更加灵活&#xff0c;可以用来构建更复杂的功能。 Python中常见的高阶函数: map(function, iterable)&#xff1a;将一个函数应…

百度行驶证C++离线SDK V1.1 C#接入

百度行驶证C离线SDK V1.1 C#接入 目录 说明 效果 项目 代码 下载 说明 自己根据SDK封装了动态库&#xff0c;然后C#调用。 SDK包结构 效果 项目 代码 using Newtonsoft.Json; using System; using System.Drawing; using System.Runtime.InteropServices; using System…

LeetCode-94. 二叉树的中序遍历【栈 树 深度优先搜索 二叉树】

LeetCode-94. 二叉树的中序遍历【栈 树 深度优先搜索 二叉树】 题目描述&#xff1a;解题思路一&#xff1a;递归解题思路二&#xff1a;迭代解题思路三&#xff1a;0 题目描述&#xff1a; 给定一个二叉树的根节点 root &#xff0c;返回 它的 中序 遍历 。 示例 1&#xff1…