Spring Boot实战系列(4)统一异常处理

项目开发中保证零异常彷佛是不可能的，不管是系统异常仍是程序自己的编码问题形成的异常信息都要以一种约定的数据结构返回，友好的处理方式在先后端分离模式下（后端提供API接口给到前端）能大大增长你们的沟通、工做效率。基于Spring Boot进行异常统一处理，本文中主要用到@ControllerAdvice注解。

快速导航

• 统一返回数据结构
  • [统一返回数据结构] 定义接口返回数据结构
  • [统一返回数据结构] 数据接口字段模型定义
  • [统一返回数据结构] 封装接口返回方法（成功、失败）
• 统一异常处理
  • [统一异常处理] 状态消息枚举
  • [统一异常处理] 自定义异常类
  • [统一异常处理] @ControllerAdvice统一处理异常
• 测试
  • [测试] 测试正常返回及空指针系统异常
  • [测试] 自定义异常测试

本文示例基于Spring Boot实战系列(3)AOP面向切面编程 /chapter3/chapter3-1可在Github获取源码

统一返回数据结构

定义接口返回数据结构

先定义接口返回数据结构，code为0表示操做成功，非0表示异常。其中data只有在处理成功才会返回，其余状况不会返回，或者那些不须要返回数据的接口（更新、删除...）

{
 	"code": 0,
 	"message": "SUCCESS",
 	"data": {

 	}
}
复制代码

数据接口字段模型定义

建立/domain/Result.java类，对以上数据接口涉及的字段进行定义。

Result.java

package com.angelo.domain;

public class Result<T> {
    private Integer code; // 状态码

    private String message; // 状态描述信息

    private T data; // 定义为范型

    // 如下 getter、setter方法省略
}
复制代码

封装接口返回方法

建立/util/MessageUtil.java类，对返回的成功、失败进行统一封装。

MessageUtil.java

package com.angelo.util;

import com.angelo.domain.Result;

public class MessageUtil {

    /** * 成功方法 * @param object * @return */
    public static Result success(Object object) {
        Result result = new Result();
        result.setCode(0);
        result.setMessage("SUCCESS");
        if (object != null) {
            result.setData(object);
        }

        return result;
    }

    /** * 成功可是 */
    public static Result success() {
        return success(null);
    }

    /** * 失败方法 * @param code * @param message * @return */
    public static Result error(Integer code, String message) {
        Result result = new Result();
        result.setCode(code);
        result.setMessage(message);

        return result;
    }
}
复制代码

统一异常处理

状态消息枚举

项目用到的状态码、描述信息要有个文件统一去作枚举定义，一方面能够实现复用，另外一方面若是状态码、描述有改动只须要在定义枚举的地方改动便可。

新建/enums/MessageEnum.java枚举

package com.angelo.enums;

public enum MessageEnum {
    SYSTEM_ERROR(1001, "系统异常"),
    NAME_EXCEEDED_CHARRACTER_LIMIT(2000, "姓名超过了限制，最大4个字符!");

    private Integer code;

    private String message;

    MessageEnum(Integer code, String message) {
        this.code = code;
        this.message = message;
    }

    public Integer getCode() {
        return code;
    }

    public String getMessage() {
        return message;
    }
}
复制代码

自定义异常类

Spring Boot框架只对抛出的RuntimeException异常进行事物回滚，那么Spring Boot封装的RuntimeException异常也是继承的Exception

新建/exception/UserException.java类，继承于RuntimeException

UserException.java

package com.angelo.exception;

import com.angelo.enums.MessageEnum;

public class UserException extends RuntimeException {
    private Integer code;

    public UserException(MessageEnum messageEnum) {
        super(messageEnum.getMessage());
        this.code = messageEnum.getCode();
    }

    public Integer getCode() {
        return code;
    }

    public void setCode(Integer code) {
        this.code = code;
    }
}
复制代码

@ControllerAdvice统一处理异常

关于@ControllerAdvice更多内容可参考官方文档https://docs.spring.io/spring-framework/docs/5.0.0.M1/javadoc-api/org/springframework/web/bind/annotation/ControllerAdvice.html

• @ControllerAdvice，spring3.2新增长，用于定义 @ExceptionHandler, @InitBinder, 和 @ModelAttribute方法，并应用到全部的@RequestMapping方法。

• @ExceptionHandler，拦截异常，方法里的value是指须要拦截的异常类型，经过该注解可实现自定义异常处理。

• 注意： 以前讲过AOP面向切面编程，注解@AfterThrowing会捕捉到项目中的错误信息，若是使用了此注解，它捕获到错误信息以后，会直接返回，是不会触发@ControllerAdvice注解的。

package com.angelo.handle;

import com.angelo.domain.Result;
import com.angelo.exception.UserException;
import com.angelo.util.MessageUtil;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

@ControllerAdvice
public class ExceptionHandle {

    private final static Logger logger = LoggerFactory.getLogger(ExceptionHandle.class);

    @ExceptionHandler(value = Exception.class)
    @ResponseBody
    public Result handle(Exception e) {
        logger.info("进入error");

        // 是否属于自定义异常
        if (e instanceof UserException) {
            UserException userException = (UserException) e;

            return MessageUtil.error(userException.getCode(), userException.getMessage());
        } else {
            logger.error("系统异常 {}", e);

            return MessageUtil.error(1000, "系统异常!");
        }
    }
}
复制代码

测试

测试正常返回及空指针系统异常

修改Usercontroller.java类，在查询用户列表接口增长返回值处理，以下所示：

/** * 查询用户列表 * @return */
@RequestMapping(value = "/user/list/{exception}")
public Result<User> userList(@PathVariable("exception") Boolean exception) {
    if (exception) {
        return null; // 测试空指针异常
    }

    return MessageUtil.success(userRepository.findAll());
}
复制代码

• 返回成功

• 返回系统异常

自定义异常测试

修改Usercontroller.java类，在保存用户信息接口增长姓名长度校验抛出自定义错误，以下所示：

/** * 保存一个用户 * @param name * @param age * @return */
@PostMapping(value = "/user")
public User userAdd(@RequestBody User userParams) throws Exception {
    User user = new User();
    user.setName(userParams.getName());
    user.setAge(userParams.getAge());

    if (userParams.getName().length() > 4) { // 校验测试异常类
        throw new UserException(MessageEnum.NAME_EXCEEDED_CHARRACTER_LIMIT);
    }

    return userRepository.save(user);
}
复制代码

Github查看本文完整示例 chapter4-1

做者：五月君
连接：www.imooc.com/article/260…
来源：慕课网
Github: Spring Boot实战系列