扫码关注官方微信

扫码下载APP
返回顶部
首页 > 资讯 > 后端开发 > Python >浅谈SpringBoot如何封装统一响应体
  • 358

0
分享到

浅谈SpringBoot如何封装统一响应体

2024-04-02 19:04:59 358人浏览 薄情痞子

Python 官方文档：入门教程 => 点击学习

摘要

目录一、前言二、添加结果类枚举三、添加统一结果类四、控制层返回五、异常处理类使用统一响应体一、前言 在上一篇 SpringBoot 参数校验 中我们对参数校验添加了异常处理，但是还是

一、前言

在上一篇 SpringBoot 参数校验 中我们对参数校验添加了异常处理，但是还是有不规范的地方，没有用统一响应体进行返回，在这篇文章中介绍如何封装统一响应体。

关于统一响应体的封装，没有一个标准答案，我在各种技术社区看了一遍，汇总了一个复用性比较好的方案。

二、添加结果类枚举

在项目目录下面建一个 responseEntity 的 package，然后在里面建一个 ResultEnum 枚举类，添加如下代码：

在这里插入图片描述

这边介绍一下枚举类的用法。枚举类的作用实际上就是定义常量，如果不使用枚举类，通常采用静态常量来表示：


public static final Integer OK_CODE = 200;
public static final String OK_MESSAGE = "成功";
public static final Integer BAD_REQUEST_CODE = 400;
public static final String BAD_REQUEST_MESSAGE = "参数错误";

这样的话存在一些问题，一是字段表意不明，特别是看别人的代码时，会很懵逼；第二当业务规模增大之后，可能要维护成百上千的静态常量，如果都写在一个文件里面，容易造成命名混淆，阅读也比较麻烦。

然后使用枚举类定义常量就比较方便，相当于一个接口，使用时只需要封装内部的数据类型，并且限定数据域。而且对于不同的枚举变量，可以调用不同的处理方法（实现枚举类的抽象方法可以做到这一点）。关于枚举类的一些知识点汇总如下：

  • 使用enum定义的枚举类默认继承了java.lang.Enum，实现了java.lang.Comparable接口，且不能继承其他类，也不可以被继承。但枚举类可以实现一个或多个接口；
  • 枚举类的所有实例必须放在第一行显示，不需使用new，不需显示调用构造方法，每个变量都是public static final修饰的，最终以分号结束。在之后的反编译中，我们就可以理解枚举类其实也是颗语法糖；
  • 枚举类的构造方法是私有的，默认的就是 private，所以不用再添加 private；

枚举类内部常用的方法：

  • valueOf() ：返回当前枚举类的name属性，如果没有，则throw new java.lang.IllegalArgumentException()；
  • values() ：是编译器自动生成的方法，Enum中并没有该方法，返回包括所有枚举变量的数组；
  • toString() 和 name() ：两个方法一样，返回当前枚举类变量的name属性，如果觉得不够用，可以覆盖默认的 toString ，结合 SWITCH CASE 来灵活的实现 toString() 方法；
  • ordinal() ：枚举类会给所有的枚举变量一个默认的次序，该次序从0开始，是根据我们定义的次序来排序的。而ordinal()方法就是获取这个次序（或者说下标）；
  • compareTo() ：比较的是两个枚举变量的次序，返回两个次序相减后的结果；

定义了枚举类之后，在类的上面添加 lombok 的 @Getter 注解，给对象的每个属性添加 getter 方法，方便后面获取常量。例如要获取 OK 的状态码，就可以这样写：


ResultEnum.OK.getCode()

这边再解释下 @Data 、@Getter 和 @Setter 的区别：

  • @Data：注解在类上；提供类所有属性的 getter 和 setter 方法，此外还提供了equals、canEqual、hashCode、toString 方
  • @Getter：注解在属性上：为属性提供 getter 方法；注解再类上表示当前类中所有属性都生成getter方法
  • @Setter：注解在属性上:为属性提供 setter 方法；注解再类上表示当前类中所有属性都生成setter方法

三、添加统一结果类

还是在 responseEntity 目录下面，建一个 ServerResponse 类，添加如下代码：


@Data
public class ServerResponse {
	private Boolean success;
    private Integer code;
    private String message;
    private Object data;

	// 构造方法设为私有
    private ServerResponse() {}

	public static ServerResponse ok(Object params) {
        ServerResponse serverResponse = new ServerResponse();
        serverResponse.setSuccess(ResultEnum.OK.getSuccess());
        serverResponse.setCode(ResultEnum.OK.getCode());
        serverResponse.setMessage(ResultEnum.OK.getMessage()); // 成功展示默认提示信息
        serverResponse.setData(params); // 返回传入的参数
        return serverResponse;
    }

	public static ServerResponse badRequest(@Nullable String message) {
        ServerResponse serverResponse = new ServerResponse();
        serverResponse.setSuccess(ResultEnum.BAD_REQUEST.getSuccess());
        serverResponse.setCode(ResultEnum.BAD_REQUEST.getCode());
        serverResponse.setMessage(message != null ? message : ResultEnum.BAD_REQUEST.getMessage()); // 校验失败传入指定的提示信息
        serverResponse.setData(null); // 校验失败不返回参数
        return serverResponse;
    }
}

在上面的代码中，成员变量和构造方法都是私有的，只有静态方法向外暴露。然后处理成功的方法，message 展示默认提示信息，即定义在枚举类里面的常量，data 是需要传给前端的 JSON 参数；处理参数错误的方法，message 展示传进去的错误信息，如果传的是 null ，则展示默认提示信息，即定义在枚举类里面的常量，data 是传给前端的参数，但是在参数错误的情况下就不需要传了，因此是 null 。

这边有一个问题，暂时不清楚 Java 是否支持函数参数可选，本人测试发现定义函数的时候有参数，但是调用的时候不传，IDE 会给错误提示，因此这里通过传 null 来解决

四、控制层返回

在定义了统一结果类之后，就可以在接口中使用了。还是用之前那个方法，通过 POST 请求获取用户信息，再原封不动返回过去：


@PostMapping("validateUser")
public ServerResponse userValidate(@RequestBody @Validated UserDTO userDTO) {
    return ServerResponse.ok(null);
}

这边先给参数传 null ，不给前端进行返回，看一下响应的结果：

在这里插入图片描述

然后传递参数：


@PostMapping("validateUser")
public ServerResponse userValidate(@RequestBody @Validated UserDTO userDTO) {
    return ServerResponse.ok(userDTO);
}

看一下响应的结果：

在这里插入图片描述

五、异常处理类使用统一响应体

然后我们给异常处理的方法也添加统一响应体：


@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(value = MethodArgumentNotValidException.class)
    public ServerResponse handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        // 注意传进去的表达式有可能是 null
        // 因此在 ServerResponse 对 message 是否为 null 进行了判断
        // 如果是 null 就展示默认的提示内容
        return ServerResponse.badRequest(Objects.requireNonNull(e.getBindingResult().getFieldError()).getDefaultMessage());
    }

    // 其他异常处理方法
}

然后我们模拟一下参数异常的情况：

在这里插入图片描述

这样看起来是正常了，但是存在一个问题，后端判断参数异常的时候，因为我们捕获了异常，所以返回给前端的状态码还是 200 ，如何让状态码改为 400 呢？在 springBoot 中指定 Http 状态码主要有三种方式：

  • httpservletResponse
  • @ResponseStatus
  • ResponseEntity

这边使用第三种方式，具体的用法看一下代码应该就明白了。我们把刚才统一结果类的方法修改下：


public static ResponseEntity<ServerResponse> badRequest(@Nullable String message) {
	ServerResponse serverResponse = new ServerResponse();
    serverResponse.setSuccess(ResultEnum.BAD_REQUEST.getSuccess());
    serverResponse.setCode(ResultEnum.BAD_REQUEST.getCode());
    serverResponse.setMessage(message != null ? message : ResultEnum.BAD_REQUEST.getMessage()); // 校验失败传入指定的提示信息
    serverResponse.setData(null); // 校验失败不返回参数
    return new ResponseEntity<>(serverResponse, HttpStatus.BAD_REQUEST); // 使用 ResponseEntity 对象设置响应状态码
}

可以看到我们用一个 ResponseEntity 对象包裹了我们封装的响应体，然后返回了这个对象。其中第二个参数就是状态码，HttpStatus.BAD_REQUEST 就代表 400 。然后我们还要修改下异常处理类的返回类型：


@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(value = MethodArgumentNotValidException.class)
    public ResponseEntity<ServerResponse> handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        return ServerResponse.badRequest(Objects.requireNonNull(e.getBindingResult().getFieldError()).getDefaultMessage());
    }

    // 其他异常处理方法
}

再来调试一下，这下状态码正常了：

在这里插入图片描述

在统一结果类中所有的方法都根据上面的示例进行修改即可，我这边添加了几个方法，给各位参考下，具体可以根据业务场景进行添加：


@Data
public class ServerResponse {
    private Boolean success;
    private Integer code;
    private String message;
    private Object data;

    // 构造方法设为私有
    private ServerResponse() {}

    
    public static ResponseEntity<ServerResponse> ok(Object params) {
        ServerResponse serverResponse = new ServerResponse();
        serverResponse.setSuccess(ResultEnum.OK.getSuccess());
        serverResponse.setCode(ResultEnum.OK.getCode());
        serverResponse.setMessage(ResultEnum.OK.getMessage()); // 成功展示默认提示信息
        serverResponse.setData(params); // 返回传入的参数
        return new ResponseEntity<>(serverResponse, HttpStatus.OK);
    }

    
    public static ResponseEntity<ServerResponse> created() {
        ServerResponse serverResponse = new ServerResponse();
        serverResponse.setSuccess(ResultEnum.CREATED.getSuccess());
        serverResponse.setCode(ResultEnum.CREATED.getCode());
        serverResponse.setMessage(ResultEnum.CREATED.getMessage());
//        serverResponse.setData(null);
        return new ResponseEntity<>(serverResponse, HttpStatus.CREATED);
    }

    
    public static ResponseEntity<ServerResponse> noContent() {
        return new ResponseEntity<>(null, HttpStatus.NO_CONTENT);
    }

    
    public static ResponseEntity<ServerResponse> badRequest(@Nullable String message) {
        ServerResponse serverResponse = new ServerResponse();
        serverResponse.setSuccess(ResultEnum.BAD_REQUEST.getSuccess());
        serverResponse.setCode(ResultEnum.BAD_REQUEST.getCode());
        serverResponse.setMessage(message != null ? message : ResultEnum.BAD_REQUEST.getMessage()); // 校验失败传入指定的提示信息
//        serverResponse.setData(null); // 校验失败不返回参数
        return new ResponseEntity<>(serverResponse, HttpStatus.BAD_REQUEST); // 使用 ResponseEntity 对象设置响应状态码
    }
}

此外，@ResponseStatus 也是一种设置状态码常用的方法，只需要在 Controller 方法中加一个注解就可以：


@PostMapping("validateUser")
@ResponseStatus(code=HttpStatus.BAD_REQUEST, reason="参数异常")
public ServerResponse userValidate(@RequestBody @Validated UserDTO userDTO) {
    return ServerResponse.ok(userDTO);
}

到此这篇关于浅谈SpringBoot如何封装统一响应体的文章就介绍到这了,更多相关SpringBoot封装统一响应体内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！

您可能感兴趣的文档:

--结束END--

本文标题: 浅谈SpringBoot如何封装统一响应体

本文链接: https://lsjlt.com/news/126713.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

猜你喜欢
  • 浅谈SpringBoot如何封装统一响应体
    目录一、前言二、添加结果类枚举三、添加统一结果类四、控制层返回五、异常处理类使用统一响应体一、前言 在上一篇 SpringBoot 参数校验 中我们对参数校验添加了异常处理，但是还是...
    99+
    2024-04-02
  • SpringBoot怎么封装统一响应体
    这篇文章主要介绍了SpringBoot怎么封装统一响应体，具有一定借鉴价值，感兴趣的朋友可以参考下，希望大家阅读完这篇文章之后大有收获，下面让小编带着大家一起了解一下。一、前言关于统一响应体的封装，没有一个标准答案，我在各种技术社区看了一遍...
    99+
    2023-06-15
  • SpringBoot如何实现统一封装返回前端结果集
    这篇文章主要介绍了SpringBoot如何实现统一封装返回前端结果集的相关知识，内容详细易懂，操作简单快捷，具有一定借鉴价值，相信大家阅读完这篇SpringBoot如何实现统一封装返回前端结果集文章都会有所收获，下面我们一起来看看吧。我们如...
    99+
    2023-07-02
  • axios请求响应数据加解密封装如何实现
    本篇内容主要讲解“axios请求响应数据加解密封装如何实现”，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习“axios请求响应数据加解密封装如何实现”吧!安装依赖在前端开发中，我们经常需要向后端发送...
    99+
    2023-07-05
  • golang中如何实现db事务的统一封装
    小编给大家分享一下golang中如何实现db事务的统一封装，相信大部分人都还不怎么了解，因此分享这篇文章给大家参考一下，希望大家阅读完这篇文章后大有收获，下面让我们一起去了解一下吧！事务处理的流程示例database :=&nbs...
    99+
    2023-06-22
  • vue3如何封装input组件和统一表单数据
    本篇内容主要讲解“vue3如何封装input组件和统一表单数据”，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习“vue3如何封装input组件和统一表单数据”吧!准备工作用vue create ex...
    99+
    2023-07-06
  • Vue项目中如何封装axios（统一管理http请求）
    1、需求说明 在使用Vue.js框架开发前端项目时，会经常发送ajax请求服务端接口，在开发过程中，需要对axios进一步封装，方便在项目中的使用。 2、Vue项目结构 在本地创...
    99+
    2024-04-02
  • win7系统程序未响应怎么办如何解决？具体步骤
     很多win7用户碰到rdquo;问题，而后程序就动不了啦!那么对于这个问题要怎么解决呢现在一起去看看吧! 1.打开开始—所有程序—附件—运行。 2.打开运行在里面输入reg...
    99+
    2023-06-02
    win7 程序未响应 程序 系统 具体步骤
  • AngularJS如何使用Interceptors来统一处理HTTP请求和响应
    这篇文章主要为大家展示了“AngularJS如何使用Interceptors来统一处理HTTP请求和响应”，内容简而易懂，条理清晰，希望能够帮助大家解决疑惑，下面让小编带领大家一起研究并学习一下“Angul...
    99+
    2024-04-02
  • angular如何使用拦截器统一处理http请求和响应
    这篇文章给大家分享的是有关angular如何使用拦截器统一处理http请求和响应的内容。小编觉得挺实用的，因此分享给大家做个参考，一起跟随小编过来看看吧。想使用angularjs里的htpp向后台发送请求,...
    99+
    2024-04-02
  • 如何使用Go编写一个高效的响应日志系统？
    日志是我们在开发过程中不可或缺的一部分，它可以帮助我们监控程序运行情况，及时发现问题并进行调试。而对于一个高流量的应用，如何高效地记录日志也是一件非常重要的事情。本文将介绍如何使用Go编写一个高效的响应日志系统，以满足高流量应用的需求。 ...
    99+
    2023-07-21
    编程算法 响应 日志
  • CMS系统php.ini中的一些对性能影响较大的参数应该如何设置
    本篇内容主要讲解“CMS系统php.ini中的一些对性能影响较大的参数应该如何设置”，感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷，实用性强。下面就让小编来带大家学习“CMS系统php.ini中的一些对性能影响较大的参数应该如何设置”...
    99+
    2023-06-17
软考高级职称资格查询
热门wiki
近期文章
推荐阅读
热门问答
热门标签
编程网，编程工程师的家园，是目前国内优秀的开源技术社区之一，形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容，为IT开发者提供了一个发现、使用、并交流开源技术的平台。

  • 官方手机版

  • 微信公众号

  • 商务合作