1、异常处理
1.1 问题分析
在我们前后台分离项目中后台需要定义返回code值用于前端验证判断,往往这些信息是JSON格式的,在后台的业务逻辑中难免会碰到些bug,也就是异常,我们需要捕获并处理异常。try catch 或 throws 已经不能满足我们的需求,方法太多,不能每个方法都用try catch 或 throws,此时,我们需要自定义异常类。
1.2异常处理流程
系统对异常的处理使用统一的异常处理流程:
1、自定义异常类型。
2、自定义错误代码及错误信息。
3、对于可预知的异常由程序员在代码中主动抛出,由SpringMVC统一捕获。 可预知异常是程序员在代码中手动抛出本系统定义的特定异常类型,由于是程序员抛出的异常,通常异常信息比较 齐全,程序员在抛出时会指定错误代码及错误信息,获取异常信息也比较方便。
4、对于不可预知的异常(运行时异常)由SpringMVC统一捕获Exception类型的异常。 不可预知异常通常是由于系统出现bug、或一些不要抗拒的错误(比如网络中断、服务器宕机等),异常类型为 RuntimeException类型(运行时异常)。
5、可预知的异常及不可预知的运行时异常最终会采用统一的信息格式(错误代码+错误信息)来表示,最终也会随 请求响应给客户端。
异常抛出及处理流程:
1、在controller、service、dao中程序员抛出自定义异常;springMVC框架抛出框架异常类型
2、统一由异常捕获类捕获异常,并进行处理 3、捕获到自定义异常则直接取出错误代码及错误信息,响应给用户。
4、捕获到非自定义异常类型首先从Map中找该异常类型是否对应具体的错误代码,如果有则取出错误代码和错误 信息并响应给用户,如果从Map中找不到异常类型所对应的错误代码则统一为99999错误代码并响应给用户。
5、将错误代码及错误信息以Json格式响应给用户。
2可预知异常处理
2.1 自定义异常类
public interface ResultCode {
/**
* 操作是否成功,true为成功,false操作失败
* @return
*/
boolean success();
/**
* 操作代码
* @return
*/
int code();
/**
* 提示信息
* @return
*/
String message();
}
@ToString
public enum CmsCode implements ResultCode {
CMS_ADDPAGE_EXISTSNAME(false,24001,"页面名称已存在!"),
CMS_GENERATEHTML_DATAURLISNULL(false,24002,"从页面信息中找不到获取数据的url!"),
CMS_GENERATEHTML_DATAISNULL(false,24003,"根据页面的数据url获取不到数据!"),
CMS_GENERATEHTML_TEMPLATEISNULL(false,24004,"页面模板为空!"),
CMS_GENERATEHTML_HTMLISNULL(false,24005,"生成的静态html为空!"),
CMS_GENERATEHTML_SAVEHTMLERROR(false,24005,"保存静态html出错!"),
CMS_COURSE_PERVIEWISNULL(false,24007,"预览页面为空!");
/**
* 操作是否成功,true为成功,false操作失败
*/
boolean success;
/**
* 操作代码
*/
int code;
/**
* 提示信息
*/
String message;
private CmsCode(boolean success, int code, String message){
this.success = success;
this.code = code;
this.message = message;
}
@Override
public boolean success() {
return success;
}
@Override
public int code() {
return code;
}
@Override
public String message() {
return message;
}
}
package com.zyq.framework.exception;
import com.zyq.framework.model.response.ResultCode;
/**
* 自定义异常类型
* @author zyq
* @version 1.0
* @create 2019-08-21 15:28
**/
public class CustomException extends RuntimeException {
/**
* 错误代码code
*/
ResultCode resultCode;
public CustomException(ResultCode resultCode){
this.resultCode = resultCode;
}
public ResultCode getResultCode(){
return resultCode;
}
}
2.2 异常抛出类
package com.zyq.framework.exception;
import com.zyq.framework.model.response.ResultCode;
/**
* @author zyq
* @version 1.0
* @create 2019-08-21 15:28
**/
public class ExceptionCast {
public static void cast(ResultCode resultCode){
throw new CustomException(resultCode);
}
}
在可能出现异常的地方调用ExceptionCast即可
//抛出异常,异常内容就是页面已经存在
ExceptionCast.cast(CmsCode.CMS_ADDPAGE_EXISTSNAME);
2.1 定义异常抛出类
/**
* 统一异常捕获类
* @author zyq
* @version 1.0
* @create 2019-08-21 17:32
**/
@ControllerAdvice//控制器增强
public class ExceptionCatch {
private static final Logger LOGGER = LoggerFactory.getLogger(ExceptionCatch.class);
/**
* 定义map,配置异常类型所对应的错误代码
*/
private static ImmutableMap<Class<? extends Throwable>,ResultCode> EXCEPTIONS;
/**
* 定义map的builder对象,去构建ImmutableMap
*/
protected static ImmutableMap.Builder<Class<? extends Throwable>,ResultCode> builder = ImmutableMap.builder();
/**
* 自定义异常--捕获CustomException此类异常
* @param customException
* @return
*/
@ExceptionHandler(CustomException.class)
@ResponseBody
public ResponseResult customException(CustomException customException){
//记录日志
LOGGER.error("catch exception:{}",customException.getMessage());
ResultCode resultCode = customException.getResultCode();
return new ResponseResult(resultCode);
}
/**
* 捕获Exception此类异常
* @param exception
* @return
*/
@ExceptionHandler(Exception.class)
@ResponseBody
public ResponseResult exception(Exception exception){
//记录日志
LOGGER.error("catch exception:{}",exception.getMessage());
if(EXCEPTIONS == null){
EXCEPTIONS = builder.build();//EXCEPTIONS构建成功
}
//从EXCEPTIONS中找异常类型所对应的错误代码,如果找到了将错误代码响应给用户,如果找不到给用户响应99999异常
ResultCode resultCode = EXCEPTIONS.get(exception.getClass());
if(resultCode !=null){
return new ResponseResult(resultCode);
}else{
//返回99999异常
return new ResponseResult(CommonCode.SERVER_ERROR);
}
}
/**
* //定义异常类型所对应的错误代码
*/
static {
builder.put(HttpMessageNotReadableException.class,CommonCode.INVALID_PARAM);
builder.put(HttpRequestMethodNotSupportedException.class,CommonCode.INVALID_PARAM);
}
}
//控制器增强
@ControllerAdvice
添加此注解并不能捕获到异常信息,还需要在Application中添加注解
@ComponentScan(basePackages={"com.zyq.framework"})//扫描common包下的类