手把手教你设计一个全局异常处理器

作者：了不起的程序猿

2022 年 8 月 08 日
本文字数：1744 字
阅读完需：约 6 分钟

前言

最近稍微闲了一点于是把这个半年都没更新的开源项目 cicada 重新捡了起来。

一些新关注的朋友应该还不知道这项目是干啥的？先来看看官方介绍吧

cicada: 基于 Netty4 实现的快速、轻量级 WEB 框架；没有过多的依赖，核心 jar 包仅 30KB。

针对这个轮子以前也写过相关的介绍，感兴趣的可以再翻回去看看：

「造个轮子」——cicada(轻量级 WEB 框架)
「造个轮子」——cicada 源码分析
「造个轮子」——cicada 设计一个配置模块
「造个轮子」——cicada 设计全局上下文
利用责任链模式设计一个拦截器
设计一个可拔插的 IOC 容器

这些都看完了相信对这个小玩意应该会有更多的想法。

效果

广告打完了，回到正题；大家平时最常用的 MVC 框架当属 SpringMVC 了，而在搭建脚手架的时候相信全局异常处理是必不可少的。

Spring 用法

通常我们的做法如下：

传统 Spring 版本：

实现一个 Spring 自带的接口，重写其中的方法，最后的异常处理便在此处。
将这个类配置在 Spring 的 xml ，当做一个 bean 注册到 Spring 容器中。

public class CustomExceptionResolver implements HandlerExceptionResolver {    @Override    public ModelAndView resolveException(HttpServletRequest request,            HttpServletResponse response, Object handler, Exception ex) {//自定义处理}<bean class="ssm.exception.CustomExceptionResolver"></bean>

复制代码

当然现在流行的 SpringBoot 也有对应的简化版本：

@ControllerAdvicepublic class GlobalExceptionHandler {    @ExceptionHandler(value = Exception.class)    public Object defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {        //自定义处理    }}

复制代码

全部都换为注解形式，但本质上还是一样的。

都是要在容器中创建一个特殊的 bean，这个 bean 专门用于处理异常，当系统运行时出现异常，就从容器中找到该 bean，并执行其中的方法即可。

至于这个特殊的 bean 如何标识出来，无非就是实现某个特定接口或者用注解声明，也就对应了传统 Spring 和 SpringBoot 的用法。

cicada 用法

cicada 在设计自己的全局异常处理器时也参考了 Spring 的相关设计，所以最终用法如下：

@CicadaBeanpublic class ExceptionHandle implements GlobalHandelException {    private final static Logger LOGGER = LoggerBuilder.getLogger(ExceptionHandle.class);    @Override    public void resolveException(CicadaContext context, Exception e) {        LOGGER.error("Exception", e);        WorkRes workRes = new WorkRes();        workRes.setCode("500");        workRes.setMessage(e.getClass().getName() + "系统运行出现异常");        context.json(workRes);    }}

复制代码

自定义一个实现了 GlobalHandelException 接口的类，当请求出现异常时，页面和后台将会如下输出：