一、Spring MVC的统一处理异常机制
在Spring MVC中,存在统一处理异常的机制,
具体表现为:无论是哪个处理请求的过程中出现异常,每种类型的异常只需要编写一段处理异常的代码即可!
统一处理异常的核心是定义处理异常的方法:
- 返回值类型:可参考处理请求的方法
- 方法名称:自定义
- 参数列表:至少包含被处理的异常对象,另外,可按需添加存在多个参数时,各参数不区分先后顺序。
- 注解:必须添加
@ExceptionHandler
注解,表示此方法是处理异常的方法
在项目的根包下创建ex.handler.GlobalExceptionHandler
类,作为当前项目的“全局异常处理器”类。
在类上添加@RestControllerAdvice
注解,此类中特定的方法,将可以作用于整个项目中任何处理请求的过程中!
将统一处理异常的代码编写在此类中(各控制器类中不再需要重复的处理异常的方法):
例如:
package com.luoyang.small.ex.handler;import com.luoyang.small.ex.CustomServiceException;
import com.luoyang.small.web.JsonResult;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;/*** 统一处理异常** @author luoyang* @date 2023/12/17*/
@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandlerpublic JsonResult handleServiceException(CustomServiceException e) {log.warn("统一处理CustomServiceException,异常信息:{}", e.getMessage());return JsonResult.fail(e);}
}
二、辅助代码示例
其中对应的CustomServiceException.java
public class CustomServiceException extends RuntimeException {private ServiceCode serviceCode;public CustomServiceException(ServiceCode serviceCode, String message) {super(message);this.serviceCode = serviceCode;}public ServiceCode getServiceCode() {return serviceCode;}
}
其中对应的ServiceCode.java
public enum ServiceCode {OK(200),ERR_NOT_FOUND(404),ERR_CONFLICT(409),ERR_CUSTOM(1000);// 以下属性,表示每个枚举类型的对象都有一个Integer value属性,此属性的值将通过构造方法传入private Integer value;ServiceCode(Integer value) {this.value = value;}// 用于通过枚举对象获取Integer value属性的值public Integer getValue() {return value;}
}
其中对应的JsonResult.java
@Data
@Slf4j
@NoArgsConstructor
@AllArgsConstructor
//@JsonInclude(JsonInclude.Include.NON_NULL) //配置在类上,所以属性为空是都不展示该属性
public class JsonResult implements Serializable {private Integer code;private String message;public static JsonResult ok() {JsonResult jsonResult = new JsonResult();jsonResult.setCode(ServiceCode.OK.getValue());return jsonResult;}public static JsonResult fail(ServiceCode serviceCode, String message) {JsonResult jsonResult = new JsonResult();jsonResult.setCode(serviceCode.getValue());jsonResult.setMessage(message);log.error("JsonResult fail serviceCode {}, message{}", serviceCode, message);return jsonResult;}public static JsonResult fail(CustomServiceException e) {return fail(e.getServiceCode(), e.getMessage());}
}
三、异常各处抛出,一个类统一处理
CustomServiceException异常各处抛出,如下:GlobalExceptionHandler.handleServiceException统一处理 ,
当客户端向服务器端提交请求,例如“添加相册”,如果服务器端的控制器中处理请求的方法中调用Service方法时出现异常,但是,处理请求的方法不必对此异常进行处理,例如:
当处理请求的方法不使用try..catch...
捕获异常,如果出现异常,相当于此处理请求的方法会抛出异常!
注意:重点就是在自定义全局类(如:GlobalExceptionHandler)上添加@RestControllerAdvice
注解,此类中特定的方法(例如handleServiceException(CustomServiceException e) 统一处理异常的方法)将可以作用于整个项目中任何处理请求的过程中!
创造价值,乐哉分享!
一起入门后端 204146007