首页 > 其他分享 >springboot 项目 统一 返回结果 统一 异常

springboot 项目 统一 返回结果 统一 异常

时间:2024-10-12 14:32:58浏览次数:7  
标签:返回 code return springboot private import com public 统一

统一返回结果

  • 统一结果返回 目前的前后端开发大部分数据的传输格式都是json,因此定义一个统一规范的数据格式有利于前后端的交互与UI的展示。

  • 统一结果的一般形式

    1. 是否响应成功;
    2. 响应状态码;
    3. 状态码描述;
    4. 响应数据
    5. 其他标识符
统一结果类
  • 在 项目目录 下 新建 一个 common 包
  • 在 common 包中创建一个 response 包
package com.codervibe.demo.common.response;

import lombok.Data;

import java.util.HashMap;
import java.util.Map;

@Data
public class R {
    private Boolean success;
    private Integer code;
    private String message;
    private Map<String, Object> data = new HashMap<>();

    // 构造器私有
    private R() {
    }

    // 通用返回成功
    public static R ok() {
        R r = new R();
        r.setSuccess(ResultCodeEnum.SUCCESS.getSuccess());
        r.setCode(ResultCodeEnum.SUCCESS.getCode());
        r.setMessage(ResultCodeEnum.SUCCESS.getMessage());
        return r;
    }

    // 通用返回失败,未知错误
    public static R error() {
        R r = new R();
        r.setSuccess(ResultCodeEnum.UNKNOWN_ERROR.getSuccess());
        r.setCode(ResultCodeEnum.UNKNOWN_ERROR.getCode());
        r.setMessage(ResultCodeEnum.UNKNOWN_ERROR.getMessage());
        return r;
    }

    // 设置结果,形参为结果枚举
    public static R setResult(ResultCodeEnum result) {
        R r = new R();
        r.setSuccess(result.getSuccess());
        r.setCode(result.getCode());
        r.setMessage(result.getMessage());
        return r;
    }

    /**
     * ------------使用链式编程,返回类本身-----------
     **/

    // 自定义返回数据
    public R data(Map<String, Object> map) {
        this.setData(map);
        return this;
    }

    // 通用设置data
    public R data(String key, Object value) {
        this.data.put(key, value);
        return this;
    }

    // 自定义状态信息
    public R message(String message) {
        this.setMessage(message);
        return this;
    }

    // 自定义状态码
    public R code(Integer code) {
        this.setCode(code);
        return this;
    }

    // 自定义返回结果
    public R success(Boolean success) {
        this.setSuccess(success);
        return this;
    }

}

结果类枚举
package com.codervibe.demo.common.response;

import lombok.Getter;

@Getter
public enum ResultCodeEnum {
    SUCCESS(true,20000,"成功"),
    UNKNOWN_ERROR(false,20001,"未知错误"),
    PARAM_ERROR(false,20002,"参数错误"),
    NULL_POINT(false,20003,"空指针错误"),
    HTTP_CLIENT_ERROR(false,20004,"客户端错误")

    ;
    private  Boolean success;
    private  Integer code;
    private  String message;

    ResultCodeEnum(boolean success,Integer code,String message){
        this.success =success;
        this.code = code;
        this.message =message;
    }

}
控制层返回
  • 视图层使用统一结果
package com.codervibe.demo.model;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;
import lombok.experimental.Accessors;

import java.util.Date;

/**
 * Created by Administrator on 2022/3/3  0003
 * DateTime:2022/03/03 14:24
 * Description:
 * Others:
 * @author Administrator
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
@Accessors(chain = true)
public class User {
    private int id;
    /**
     * 用户名
     */
    private String username;

    /**
     * 密码
     */
    private String password;

    /**
     * 邮箱
     */
    private String email;

    /**
     * 创建时间
     */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone="GMT+8")
    private Date createTime;

    /**
     * 角色访问权限
     */
    private String role;

    private static final long serialVersionUID = 1L;
}

package com.codervibe.demo.controller;

import com.codervibe.demo.common.response.R;
import com.codervibe.demo.model.User;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

@RestController
@RequestMapping("/user")
public class UserController {
    Logger logger = LoggerFactory.getLogger(UserController.class);
    @GetMapping("/list")
    public R list() {

        // 这里实际上应该是从 数据库中查询出来 但是 我为了省事所以就直接创建了一个 用户列表 
        // 从数据库中查询出来 实际上效果是一样的
        List<User> userList = new ArrayList<>();
        userList.add(new User(1, "孙悟空", "1111", "[email protected]", new Date(), "1"));
        userList.add(new User(2, "金蝉子", "1111", "[email protected]", new Date(), "1"));
        userList.add(new User(3, "鲁班七号", "11111", "[email protected]", new Date(), "1"));
        userList.add(new User(4, "鲁班大师", "11111", "[email protected]", new Date(), "1"));
        userList.add(new User(5, "安其拉", "111111", "[email protected]", new Date(), "1"));
        // 使用 log4j 做日志打印
        logger.info("用户列表 :"+userList.toString());

        return R.ok().data("userItems", userList).message("用户列表");
    }
}

  • 控制层类的 访问 地址
C:\Users\Administrator\Desktop>curl http://localhost:5767/demo/user/list
  • 返回的结果
{
  "success": true,
  "code": 20000,
  "message": "用户列表",
  "data": {
    "userItems": [
      {
        "id": 1,
        "username": "孙悟空",
        "password": "1111",
        "email": "[email protected]",
        "createTime": "2024-01-20 23:14:44",
        "role": "1"
      },
      {
        "id": 2,
        "username": "金蝉子",
        "password": "1111",
        "email": "[email protected]",
        "createTime": "2024-01-20 23:14:44",
        "role": "1"
      },
      {
        "id": 3,
        "username": "鲁班七号",
        "password": "11111",
        "email": "[email protected]",
        "createTime": "2024-01-20 23:14:44",
        "role": "1"
      },
      {
        "id": 4,
        "username": "鲁班大师",
        "password": "11111",
        "email": "[email protected]",
        "createTime": "2024-01-20 23:14:44",
        "role": "1"
      },
      {
        "id": 5,
        "username": "安其拉",
        "password": "111111",
        "email": "[email protected]",
        "createTime": "2024-01-20 23:14:44",
        "role": "1"
      }
    ]
  }
}

统一异常处理

  • 使用统一返回结果时,还有一种情况,就是程序的保存是由于运行时异常导致的结果,有些异常我们可以无法提前预知,不能正常走到我们return的R对象返回。
  • 因此,我们需要定义一个统一的全局异常来捕获这些信息,并作为一种结果返回控制层
@ControllerAdvice 该注解为统一异常处理的核心
  • 是一种作用于控制层的切面通知(Advice),该注解能够将通用的@ExceptionHandler、@InitBinder和@ModelAttributes方法收集到一个类型,并应用到所有控制器上
  • 该类中的设计思路:
    1. 使用@ExceptionHandler注解捕获指定或自定义的异常;
    2. 使用@ControllerAdvice集成@ExceptionHandler的方法到一个类中;
    3. 必须定义一个通用的异常捕获方法,便于捕获未定义的异常信息;
    4. 自定一个异常类,捕获针对项目或业务的异常;
    5. 异常的对象信息补充到统一结果枚举中;
自定义全局异常类
  • 在common 包中 新建一个 exception 包
  • 自定义异常类 的 名字为 项目名 + exception
package com.codervibe.demo.common.exception;

import com.codervibe.demo.common.response.ResultCodeEnum;
import lombok.Data;

@Data
public class DemoException extends RuntimeException{
    private Integer code;

    public DemoException(Integer code, String message) {
        super(message);
        this.code = code;
    }

    public DemoException(ResultCodeEnum resultCodeEnum) {
        super(resultCodeEnum.getMessage());
        this.code = resultCodeEnum.getCode();
    }

    @Override
    public String toString() {
        return "DemoException{" + "code=" + code + ", message=" + this.getMessage() + '}';
    }


}

统一异常处理器
package com.codervibe.demo.common.exception;

import com.codervibe.demo.common.response.R;
import com.codervibe.demo.common.response.ResultCodeEnum;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.client.HttpClientErrorException;

@ControllerAdvice
public class GlobalExceptionHandler {
    /**-------- 通用异常处理方法 --------**/
    @ExceptionHandler(Exception.class)
    @ResponseBody
    public R error(Exception e) {
        e.printStackTrace();
        return R.error();	// 通用异常结果
    }

    /**-------- 指定异常处理方法 --------**/
    @ExceptionHandler(NullPointerException.class)
    @ResponseBody
    public R error(NullPointerException e) {
        e.printStackTrace();
        return R.setResult(ResultCodeEnum.NULL_POINT);
    }

    @ExceptionHandler(HttpClientErrorException.class)
    @ResponseBody
    public R error(IndexOutOfBoundsException e) {
        e.printStackTrace();
        return R.setResult(ResultCodeEnum.HTTP_CLIENT_ERROR);
    }

    /**-------- 自定义定异常处理方法 --------**/
    @ExceptionHandler(DemoException.class)
    @ResponseBody
    public R error(DemoException e) {
        e.printStackTrace();
        return R.error().message(e.getMessage()).code(e.getCode());
    }
}

控制层展示

  • 以下为展示当遇到null指定异常时,返回的结果信息
{
  "success": false,
  "code": 20007,
  "message": "空指针异常",
  "data": {}
}

加我粉丝群 企鹅 179469398

标签:返回,code,return,springboot,private,import,com,public,统一
From: https://www.cnblogs.com/codervibe/p/18460499

相关文章

  • GenossGPT:开源AI模型的统一接口
    GenossGPT:开源AI的革新之路在人工智能快速发展的今天,各种强大的语言模型层出不穷。然而,不同模型间的接口差异给开发者带来了不小的挑战。为了解决这一问题,GenossGPT应运而生。这个开创性的开源项目旨在为各种AI语言模型提供一个统一的API接口,让开发者能够轻松地在应用中集成和切......
  • Springboot高校学生奖、助学金管理系统t0v2u(程序+源码+数据库+调试部署+开发环境)
    本系统(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上,文末可获取,系统界面在最后面。系统程序文件列表学生,奖助学金,奖助学金申请,贫困生申请,奖助学金发放,工作类型,勤工助学岗位,岗位申请开题报告内容一、研究背景随着高等教育的普及和学生数量的不断增加,高校......
  • Springboot高校学科竞赛赛事管理1313s(程序+源码+数据库+调试部署+开发环境)
    本系统(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上,文末可获取,系统界面在最后面。系统程序文件列表评委老师,学生,竞赛类型,竞赛信息,参赛记录,竞赛成绩开题报告内容一、选题背景随着高校教育的快速发展和学科竞赛的日益普及,建立一个高效、便捷、公平的学科竞......
  • Springboot高校失物招领信息平台h8spk(程序+源码+数据库+调试部署+开发环境)
    本系统(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上,文末可获取,系统界面在最后面。系统程序文件列表用户,物品分类,招领启事,寻物启事开题报告内容一、研究背景与意义在高校中,由于学生人数众多且流动性大,个人物品的遗失事件时有发生。这些失物可能包含有价值的......
  • SpringBoot实战教程:购物推荐网站的设计与实现
    3系统分析3.1可行性分析通过对本东大每日推购物推荐网站实行的目的初步调查和分析,提出可行性方案并对其一一进行论证。我们在这里主要从技术可行性、经济可行性、操作可行性等方面进行分析。3.1.1技术可行性本东大每日推购物推荐网站采用JAVA作为开发语言,SpringBoot框......
  • 基于SpringBoot+Vue的中山社区医疗综合服务平台系统+万字论文+Mp4演示
    系统简介:基于SpringBoot+Vue的中山社区医疗综合服务平台系统+万字论文+Mp4演示资源描述:是否有万字论文:有是否有论文视频:有是否有PPT:没有是否有Mp4演示:有是否有演示站:有是否前后端分离:是技术栈:Java:JDK8主要编程语言,用于后端开发MySQL:数据库管......
  • 电商新动力:SpringBoot购物推荐网站开发详解
    2相关技术2.1MYSQL数据库MySQL是一个真正的多用户、多线程SQL数据库服务器。是基于SQL的客户/服务器模式的关系数据库管理系统,它的有点有有功能强大、使用简单、管理方便、安全可靠性高、运行速度快、多线程、跨平台性、完全网络化、稳定性等,非常适用于Web站点或者其他......
  • SpringBoot框架下购物推荐系统的架构与实现
    2相关技术2.1MYSQL数据库MySQL是一个真正的多用户、多线程SQL数据库服务器。是基于SQL的客户/服务器模式的关系数据库管理系统,它的有点有有功能强大、使用简单、管理方便、安全可靠性高、运行速度快、多线程、跨平台性、完全网络化、稳定性等,非常适用于Web站点或者其他......
  • SpringBoot驱动的智能购物推荐平台开发指南
    1系统概述1.1研究背景如今互联网高速发展,网络遍布全球,通过互联网发布的消息能快而方便的传播到世界每个角落,并且互联网上能传播的信息也很广,比如文字、图片、声音、视频等。从而,这种种好处使得互联网成了信息传播的主要途径,社会上各种各样的信息都想尽办法通过互联网进行......
  • 构建高效购物推荐系统:SpringBoot实战
    1系统概述1.1研究背景如今互联网高速发展,网络遍布全球,通过互联网发布的消息能快而方便的传播到世界每个角落,并且互联网上能传播的信息也很广,比如文字、图片、声音、视频等。从而,这种种好处使得互联网成了信息传播的主要途径,社会上各种各样的信息都想尽办法通过互联网进行......