最近接手一个新项目,写用例的时候去翻看代码,发现部分代码里缺少基本的异常处理,包括对参数异常以及业务异常的处理。对照之前负责过的异常处理做得比较好的项目,给开发提了几点建议,顺便又去翻看了之前项目的代码,对常用的异常处理方式做了一个梳理。
Java把异常当做对象来处理。Throwable是所有错误或异常的超类。Throwable类有两个直接子类:Error类和Exception类。
1、Error是指java运行时系统的内部错误和资源耗尽错误,是程序无法处理的异常,应用程序不会抛出该类对象。
2、Exception是程序本身可以处理的异常,应尽可能去处理这些异常。Exception分两类,一个是运行时异常RuntimeException,一个是检查异常CheckedException。
3、CheckedException一般是外部错误,这种异常都发生在编译阶段,Java编译器会强制程序去捕获此类异常。
4、RuntimeException是那些可能在Java 虚拟机正常运行期间抛出的异常的超类。这种错误是由程序员引起的错误,可以修正代码解决。
通常在Controller层需要去捕获service层的异常,防止返回一些不友好的错误信息到客户端,但如果Controller层每个方法都用模块化的try-catch代码去捕获异常,会很难看也难维护。
异常处理最好是解耦的,并且都放在一个地方集中管理。Spring能够较好的处理这种问题,核心如下,这里主要关注前两个:
@ExceptionHandler:统一处理某一类异常,从而能够减少代码重复率和复杂度
@ControllerAdvice:异常集中处理,更好的使业务逻辑与异常处理剥离开
@ResponseStatus:可以将某种异常映射为HTTP状态码
单使用@ExceptionHandler,只能在当前Controller中处理异常,与@ControllerAdvice组合使用,则可以实现全局异常处理,不用每个controller都配置。
2.1 全局异常处理类
下面通过一个实际项目代码来看一下@ControllerAdvice+@ExceptionHandler的使用。
@ControllerAdvice定义全局异常处理类GlobalExceptionHandler
@ExceptionHandler声明异常处理方法,使用value指定异常类,value = Exception.class表示处理Controller层抛出的Exception及其子类的异常,这样Controller层代码就不需要进行异常处理了。
GlobalExceptionHandler类中对多个异常进行了处理,这些异常分两类,一类是自定义异常,如AuthenticationException、BadRequestException,一类是非自定义异常,如HttpRequestMethodNotSupportedException、TypeMismatchException等。
2.2 自定义异常
一般项目中都会有一些业务相关(非JVM抛出)的异常,可以使用自定义异常继承相关的异常来抛出有用的异常信息,其类名要能体现具体的异常信息,这样根据异常名就可以知道哪里有异常,根据异常提示信息进行程序修改。比如空指针异常NullPointException,可以抛出message为“xxx为空”定位异常位置,而不用输出堆栈信息。
自定义异常通常是定义一个继承自Exception类的子类,一般会直接继承自Exception类,而不会继承某个运行时的异常类。
下面是项目代码中自定义异常的使用。
定义自定义异常类AuthenticationException,继承Exception类:
在Service层抛出AuthenticationException:
2.3 数据校验异常处理
代码中可以使用@RequestBody+@Valid进行数据绑定和数据校验。
下面是项目代码中对Post请求表单的处理,通过@RequestBody将请求body中的json与表单对象(CreateOrderRequestVO)绑定,使用@Valid进行表单验证。如果不使用@Valid,CreateOrderRequestVO中的@NotNull等注解不生效。
在表单对象CreateOrderRequestVO类的相应字段上添加用于充当校验条件的注解(@NotNull、@NotBlank、@Min等)。
数据校验失败时,Spring MVC 框架会抛出 MethodArgumentNotValidException 异常, 在 GlobalExceptionHandler 中加上对 MethodArgumentNotValidException 异常的声明和处理,就可以全局处理数据校验的异常了。
本文主要是基于项目代码,对其中的全局统一异常处理做了一个梳理和总结。这种异常处理方式将异常处理从业务代码中解耦出来,实现异常信息的统一处理和维护,减少了模板代码,改善了代码的风格。
在日常测试中,有意识地多学习一些开发代码中写得好的地方,为自己以后写代码不断积累经验,还可以适时地对开发的代码提出一些建议。
以上转自:https://testerhome.com/topics/12058
附录我司的全局异常处理类
package api.util;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import api.framework.dto.Result;
import api.framework.exception.ServiceException;
/**
* 全局异常处理器,处理新增的异常,对于有特殊逻辑的返回直接定义个新方法,参考ServiceException
*/
@ControllerAdvice
@Component
@ResponseBody
public class GlobalExceptionHandler {
private final static Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);
@ExceptionHandler(ServiceException.class)
public Result handlerServiceException(ServiceException e){
return new Result("error", e.getMessage(), "", "", e.getCode());
}
@ExceptionHandler(Exception.class)
public Result handlerException(Exception e){
LOGGER.error("Oops", e);
return new Result("error", "网络异常", "", "", "500");
}
}
package api.framework.exception;
/**
*
* 业务异常,这里约定每个业务场景的错误都是有一个错误码的。
*
*
* 这个错误码需要展示给前端。前端需要根据这个码值做一些特殊的判断。如余额不足,
* 错误码 001,那么前端根据这个码值引导用户去充值页面。
*
*/
public class ServiceException extends RuntimeException{
private static final long serialVersionUID = 228211L;
private String code;
/**
* 构造一个业务异常类
*
* @param code 错误码,注意约定的业务错误码都是大于600的
* @param message 错误信息
*/
public ServiceException(String code, String message){
super(message);
this.code = code;
}
/**
* 返回错误码
* @return 错误码
*/
public String getCode() {
return code;
}
}