java中统一返回前端格式及统一结果处理返回详解

 更新时间:2025年02月25日 10:55:11   作者:小学鸡!  
这篇文章主要介绍了统一结果处理的重要性,以及如何在SpringBoot项目中定义和使用统一结果返回类,通过构造器私有化和静态方法ok、error,提供了成功和失败的统一响应格式,需要的朋友可以参考下

统一结果处理

为什么要使用统一结果?

1、大部分前后端项目采用 JSON 格式进行数据交互,定义一个统一的数据规范,有利于前后台的交互、以及信息处理。

2、Java后端开发项目时,需要给前端传一些数据,可以直接将一个 List 或者 Map 返回给前端,但是这样会显得很乱,并且有时候前端需要的不仅仅只是数据,可能还有一些错误码、错误信息等,这时就需要一种规范的数据格式传到前端。

返回格式的属性说明

  • success: true/false,是否响应成功,设置成 Boolean 类型。
  • code: 200/400/500等,响应状态码。设置成 Integer 类型。
  • message: 访问成功/系统异常等,状态码描述,设置成 String 类型。
  • data: 处理得数据,响应数据,设置成 HashMap 类型。

下面举出来一个 Spring Boot 项目中,通过接口返回给前端的结果格式示例:

// 举例:返回结果样式
{
  "success": true,
  "code": 200,
  "message": "查询用户列表",
  "data": {
    "itms": [
      {
        "id": "1",
        "username": "admin",
        "role": "ADMIN",
        "createTime": "2020-4-24T15:32:29",
        "modifiedTime": "2020-4-24T15:41:40"
      },{
        "id": "2",
        "username": "zhangsan",
        "role": "USER",
        "createTime": "2020-4-24T15:32:29",
        "modifiedTime": "2020-4-24T15:41:40"
      }
    ]
  }
}

统一结果返回类如何定义

  • 构造器私有,不允许进行实例化,但提供静态方法:ok、error 返回一个实例

    • ok:返回一个 成功操作 的实例对象
    • error:返回一个 失败操作 的实例对象
  • 采用链式调用(即:方法返回对象为其本身,return this)----> 下面代码中涉及到

统一结果返回类:

@Data
public class Result {
    private Boolean success;
    private Integer code;
    private String message;
    private Map<String, Object> data = new HashMap<>();
    
    // 默认私有构造器
    private Result(){
        
    }
    
    // 自定义构造器
    private Result(Boolean success, Integer code, String message){
        this.success = success;
        this.code = code;
        this.message = message;
    }
    
    
    
    // 返回一个默认的 成功操作 的实例对象,默认响应状态码 200
    public static Result ok(){
        // 使用 HttpStatus 的常量表示响应状态码,这个需要导入 httpcore 依赖
        return new Result(true, HttpStatus.SC_OK, "success");
    }
    
    // 返回一个自定义 成功操作 的实例对象
    public static Result ok(Boolean success, Integer code, String message) {
        return new Result(success, code, message);
    }
    
    
    
    // 返回一个默认的 失败操作 的结果,默认响应状态码为 500
    public static Result error() {
        return new Result(false, HttpStatus.SC_INTERNAL_SERVER_ERROR, "error");
    }
    
    // 返回一个自定义 失败操作 的实例对象
    public static Result error(Boolean success, Integer code, String message) {
        return new Result(success, code, message);
    }
    
    
    
    // 自定义响应是否成功
    public Result success(Boolean success) {
        this.setSuccess(success);
        return this;
    }
    
    // 自定义响应状态码
    public Result code(Integer code) {
        this.setCode(code);
        return this;
    }
    
    // 自定义响应消息
    public Result message(String message) {
        this.setMessage(message);
        return this;
    }
    
    // 自定义响应数据,一次设置一个 map 集合
    public Result data(Map<String, Object> map) {
        this.data.putAll(map);
        return this;
    }
    
    // 通用设置响应数据,一次设置一个 key - value 键值对
    public Result data(String key, Object value) {
        this.data.put(key, value);
        return this;
    }
}

代码说明:

1、统一结果返回类。方法采用链式调用的写法(即返回类本身 return this)。

2、构造器私有,不允许进行实例化,但提供静态方法 ok、error 返回一个实例。

3、静态方法说明:

  • ok: 返回一个 成功操作 的结果(实例对象)。
  • error: 返回一个 失败操作 的结果(实例对象)。

4、普通方法说明:

  • success: 用于自定义响应是否成功
  • code: 用于自定义响应状态码
  • message: 用于自定义响应消息
  • data: 用于自定义响应数据

5、依赖信息说明:

  • 此处使用 @Data 注解,需导入 lombok 相关依赖文件。
  • 使用 HttpStatus 的常量表示 响应状态码,需导入 httpcore 相关依赖文件。

注意:使用 HttpStatus 时,要加这个依赖:

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpcore</artifactId>
    <version>4.4.13(版本号)</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.12</version>
    <scope>provided</scope>
</dependency>

4、使用:修改某个 controller 如下所示:

@GetMapping("selectOne")
public Result selectOne(Integer id) {
    Emp emp = this.empService.queryById(id);
    if (emp == null) {
        return Result.error().message("用户不存在");
    }
    return Result.ok().data("items", emp).message("查询成功");
}

4.1 成功:若查询用户成功,调用 ok 返回查询到的结果。

{
    "success": true,
    "code": 200,
    "message": "查询成功",
    "data": {
        "items": {
            "id": 1,
            "name": "tom",
            "salary": 6000.0,
            "age": 20,
            "email": "tom@163.com"
        }
    }
}

4.2 失败:若查询用户失败,调用 error 返回查询失败信息。

{
    "success": false,
    "code": 500,
    "message": "用户不存在",
    "data": {}
}

总结

到此这篇关于java中统一返回前端格式及统一结果处理返回的文章就介绍到这了,更多相关java统一结果处理返回内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 详解Java MyBatis 插入数据库返回主键

    详解Java MyBatis 插入数据库返回主键

    这篇文章主要介绍了详解Java MyBatis 插入数据库返回主键,有兴趣的可以了解一下。
    2017-01-01
  • Spring前后端跨域请求设置代码实例

    Spring前后端跨域请求设置代码实例

    这篇文章主要介绍了Spring前后端跨域请求设置代码实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • Java常量池知识点总结

    Java常量池知识点总结

    本篇文章给大家通过理论原理等方便彻底分析了Java常量池的相关知识,有兴趣的朋友阅读学习下吧。
    2017-12-12
  • SpringBoot使用protobuf格式的接口方式

    SpringBoot使用protobuf格式的接口方式

    这篇文章主要介绍了SpringBoot使用protobuf格式的接口方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-07-07
  • Java中关于文件路径读取问题的分析

    Java中关于文件路径读取问题的分析

    今天给大家带来的是关于Java的相关知识,文章围绕着Java中关于文件路径读取问题展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
    2021-06-06
  • Java实现直接插入排序与折半插入排序的示例详解

    Java实现直接插入排序与折半插入排序的示例详解

    这篇文章主要为大家详细介绍了插入排序中两个常见的排序:直接插入排序与折半插入排序。本文用Java语言实现了这两个排序算法,感兴趣的可以学习一下
    2022-06-06
  • Java中字节流和字符流的区别与联系

    Java中字节流和字符流的区别与联系

    Java中的字节流和字符流是用于处理输入和输出的两种不同的流,本文主要介绍了Java中字节流和字符流的区别与联系,字节流以字节为单位进行读写,适用于处理二进制数据,本文结合实例代码给大家介绍的非常详细,需要的朋友参考下吧
    2024-12-12
  • Java中的Vector和Stack底层源码分析

    Java中的Vector和Stack底层源码分析

    这篇文章主要介绍了Java中的Vector和Stack底层源码分析,Stack继承了Vector,Vector底层还是一个List,也就是基于数组来实现的,所以ArrayList有的优点,比如获取元素的速度快,随机读,它都有,需要的朋友可以参考下
    2023-12-12
  • mybatis使用foreach遍历list集合或者array数组方式

    mybatis使用foreach遍历list集合或者array数组方式

    这篇文章主要介绍了mybatis使用foreach遍历list集合或者array数组方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-07-07
  • 详解Java如何实现企业微信审批流程

    详解Java如何实现企业微信审批流程

    这篇文章主要使用了一个Java示例代码,来向大家展示如何在企业微信中实现审批流程,文中的示例代码简洁易懂,有需要的小伙伴可以参考下
    2024-11-11

最新评论