SpringMVC下异常处理思路

spring 同时被 3 个专栏收录
1 篇文章 0 订阅
4 篇文章 0 订阅
1 篇文章 0 订阅

SpringMVC下异常处理思路

问题
1.在做一些基础web开发的时候,为了有良好的用户体验,每一步的操作流程都要返回给用户信息,例如在添加数据或者删除数据时,需要告诉用户添加成功,或者删除成功,而在一些失败的逻辑中,也需要告诉用户失败的原因是啥,而当产生一些不可预知的异常时,我们希望返回给用户的是“系统繁忙,请稍后的重试的提示,而不是用户看不懂过的错误信息等等”
2.、service方法在执行过程出现异常在哪捕获?在service中需要都加try/catch,如果在controller也需要添加try/catch,代码冗余严重且不易维护。
解决方案:
1、在Service方法中的编码顺序是先校验判断,有问题则抛出具体的异常信息,最后执行具体的业务操作,返回成功信息。
2、在统一异常处理类中去捕获异常,无需controller捕获异常,向用户返回统一规范的响应信息。

//校验页面是否存在,已存在则抛出异常
if(cmsPage1 !=null){
//抛出异常,已存在相同的页面名称,返回前台页面重复,而非简单的操作失败信息
//...
}

异常处理流程

1、自定义异常类型。
2、自定义错误代码及错误信息。
3、对于可预知的异常由程序员在代码中主动抛出,由SpringMVC统一捕获。可预知异常是程序员在代码中手动抛出本系统定义的特定异常类型,由于是程序员抛出的异常,通常异常信息比较齐全,程序员在抛出时会指定错误代码及错误信息,获取异常信息也比较方便。
4、对于不可预知的异常(运行时异常)由SpringMVC统一捕获Exception类型的异常。不可预知异常通常是由于系统出现bug、或一些不要抗拒的错误(比如网络中断、服务器宕机等),异常类型为
RuntimeException类型(运行时异常)。
5、可预知的异常及不可预知的运行时异常最终会采用统一的信息格式(错误代码+错误信息)来表示,最终也会随请求响应给客户端。

异常抛出即处理流程
在这里插入图片描述
1、在controller、service、dao中程序员抛出自定义异常;springMVC框架抛出框架异常类型
2、统一由异常捕获类捕获异常,并进行处理
3、捕获到自定义异常则直接取出错误代码及错误信息,响应给用户。
4、捕获到非自定义异常类型首先从Map中找该异常类型是否对应具体的错误代码,如果有则取出错误代码和错误信息并响应给用户,如果从Map中找不到异常类型所对应的错误代码则统一为99999错误代码并响应给用户。
5、将错误代码及错误信息以Json格式响应给用户。

可预知异常处理

自定义异常类

在公共模块中自定义异常类,注意扫描该模块下的异常类

public class CustomException extends RuntimeException {
    private ResultCode resultCode;
    
    public CustomException(ResultCode resultCode) {
        super("错误代码:" + resultCode.code() + "错误信息:" + resultCode.message());
        this.resultCode = resultCode;
    }

    public ResultCode getResultCode() {
        return this.resultCode;
    }
}

定义异常抛出类

public class ExceptionCast {
    //使用此静态方法抛出异常
    public static void cast(ResultCode resultCode){
        throw new CustomException(resultCode);
    }
  }

以及异常获取类
使用 @ControllerAdvice和@ExceptionHandler注解来捕获指定类型的异常

@ControllerAdvice //控制器增强注解
public class ExceptionCatch {
    private static final Logger LOGGER = LoggerFactory.getLogger(ExceptionCatch.class);
    //使用EXCEPTIONS存放异常类型和错误代码的映射,ImmutableMap的特点的一旦创建不可改变,并且线程安全
    private static ImmutableMap<Class<? extends Throwable>, ResultCode> EXCEPTIONS;
    //使用builder来构建一个异常类型和错误代码的异常
    protected static ImmutableMap.Builder<Class<? extends Throwable>, ResultCode> builder =
            ImmutableMap.builder();

    static {
        //在这里加入一些基础的异常类型判断
        builder.put(HttpMessageNotReadableException.class, CommonCode.INVALID_PARAM);
    }

    //捕获Exception异常
    @ResponseBody
    @ExceptionHandler(Exception.class)
    public ResponseResult exception(Exception e) {
        LOGGER.error("catch exception : {}\r\nexception: ", e.getMessage(), e);
        if (EXCEPTIONS == null)//ImmutableMap未构建
            EXCEPTIONS = builder.build();//EXCEPTIONS构建成功,构建成功后map中才有数据
        final ResultCode resultCode = EXCEPTIONS.get(e.getClass());
        final ResponseResult responseResult;
        //从EXCEPTION中找到异常类所对应的错误代码,如果找到了将错误代码响应给用户,如果找不到,给用户响应99999异常
        if (resultCode != null) {
            responseResult = new ResponseResult(resultCode);
        } else {//返回99999异常
            responseResult = new ResponseResult(CommonCode.SERVER_ERROR);
        }
        return responseResult;
    }

    //捕获CustomException异常
    @ExceptionHandler(CustomException.class)
    @ResponseBody
    public ResponseResult customException(CustomException e) {
        LOGGER.error("catch exception:{}\r\nexception ", e.getMessage(), e);
        ResultCode resultCode = e.getResultCode();
        ResponseResult responseResult = new ResponseResult(resultCode);
        return responseResult;
    }
}

定义错误代码,每个使用异常操作都用异常代码去标识

@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, "预览页面为空!");
    //操作代码
    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;
    }
}

抛出异常,在controller、service、 dao中都可以抛出异常,通过异常抛出类中的静态方法抛出异常

	if (byPageNameAndPageAliaseAndSiteId != null) {//校验页面是否已经存在,不为空则表示已经存在
            
            ExceptionCast.cast(CmsCode.CMS_ADDPAGE_EXISTSNAME);//抛出异常
        }

前端获取后端返回的json信息,如下

{"success":false,"code":24001,"message":"页面名称已存在!"}

在将返回的message信息前台展示给用户即可

不可预知异常处理

如上代码所示,在异常获取类中添加对Exception的获取,对于一些常见的不可预知的异常,解决方案是

1、我们在map中配置异常类如:HttpMessageNotReadableException和错误代码。
2、在异常捕获类中对Exception异常进行捕获,并从map中获取异常类型对应的错误代码,如果存在错误代码则返
回此错误,否则统一返回99999错误。
具体的开发实现如下:
1、在通用错误代码类CommCode中配置非法参数异常

INVALID_PARAM(false,10003,"非法参数!"),

2、在异常捕获类中配置 HttpMessageNotReadableException 为非法参数异常。
异常捕获类代码如下:(同上异常获取代码)

 private static final Logger LOGGER = LoggerFactory.getLogger(ExceptionCatch.class);
    //使用EXCEPTIONS存放异常类型和错误代码的映射,ImmutableMap的特点的一旦创建不可改变,并且线程安全
    private static ImmutableMap<Class<? extends Throwable>, ResultCode> EXCEPTIONS;
    //使用builder来构建一个异常类型和错误代码的异常
    protected static ImmutableMap.Builder<Class<? extends Throwable>, ResultCode> builder =
            ImmutableMap.builder();

    static {
        //在这里加入一些基础的异常类型判断
        builder.put(HttpMessageNotReadableException.class, CommonCode.INVALID_PARAM);
    }

    //捕获Exception异常
    @ResponseBody
    @ExceptionHandler(Exception.class)
    public ResponseResult exception(Exception e) {
        LOGGER.error("catch exception : {}\r\nexception: ", e.getMessage(), e);
        if (EXCEPTIONS == null)//ImmutableMap未构建
            EXCEPTIONS = builder.build();//EXCEPTIONS构建成功,构建成功后map中才有数据
        final ResultCode resultCode = EXCEPTIONS.get(e.getClass());
        final ResponseResult responseResult;
        //从EXCEPTION中找到异常类所对应的错误代码,如果找到了将错误代码响应给用户,如果找不到,给用户响应99999异常
        if (resultCode != null) {
            responseResult = new ResponseResult(resultCode);
        } else {//返回99999异常
            responseResult = new ResponseResult(CommonCode.SERVER_ERROR);
        }
        return responseResult;
    }

当产生一些不可预知的异常时就会返回前台99999异常

{"success":false,"code":99999,"message":"抱歉,系统繁忙,请稍后重试!"}
  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

©️2021 CSDN 皮肤主题: 数字20 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值