Java：使用 Java 开发的一个异常处理框架

背景

这篇文章介绍的异常处理思路不错，本文试图给出一种具体实现，当然可能和作者的思路有所不同。

框架地址：https://github.com/happyframework/HappyFramework。

框架介绍

关于异常的一些想法：

1. 异常不能跨越“边界类”。
2. 在边界类之下，异步不能被“吞掉”。
3. 系统在不同场景或分层中，需要的不同的处理“策略”。
4. 每种策略都是一个可扩展的“管道”。
5. 可以和 AOP 进行集成。
6. 异常可以用来给业务用户提供“提醒”。
7. 异常可以给运维用户提供“日志”。

我希望异常处理框架以某种机制支持上面的各种想法。

针对边界类的处理场景

模拟的边界类

package com.happyframework.exception.handling;

import org.springframework.stereotype.Controller;

import com.happyframework.exception.handling.springframework.HandleException;

@Controller
public class TestController {

    @HandleException("UI")
    public void test() {
        throw new RuntimeException("业务失败");
    }
    
}

因为边界类需要特殊的异常处理策略，这里指定了的策略名字为：“UI”。

“UI”策略对应的管道配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:p="http://www.springframework.org/schema/p"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:aop="http://www.springframework.org/schema/aop"
       xmlns:util="http://www.springframework.org/schema/util"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context 
                           http://www.springframework.org/schema/context/spring-context.xsd
                           http://www.springframework.org/schema/mvc
                           http://www.springframework.org/schema/mvc/spring-mvc.xsd
                           http://www.springframework.org/schema/aop
                           http://www.springframework.org/schema/aop/spring-aop-3.0.xsd
                           http://www.springframework.org/schema/util
                            http://www.springframework.org/schema/util/spring-util-3.0.xsd">

    <context:component-scan base-package="com.happyframework.exception.handling.springframework" />
    <context:component-scan base-package="com.happyframework.exception.handling" />
    
    <aop:aspectj-autoproxy/>

     <bean class="com.happyframework.exception.handling.springframework.ExceptionHandlerDefination">
        <property name="policy" value="UI"/>
        <property name="handler">
            <bean class="com.happyframework.exception.handling.ConsoleLoggingHandler"/>
        </property>
    </bean>
     <bean class="com.happyframework.exception.handling.springframework.ExceptionHandlerDefination">
        <property name="policy" value="UI"/>
        <property name="handler">
            <bean class="com.happyframework.exception.handling.ConsoleNotificationHandler"/>
        </property>
    </bean>
</beans>
         

为管道定义了两个处理器：日志处理器和提醒处理器，因为是测试的处理器，实现就比较简单，真实项目中可以决定：哪些异常需要日志？哪些信息提醒给用户？

运行输出

记录日志：java.lang.RuntimeException: 业务失败
提示消息：java.lang.RuntimeException: 业务失败

“UI”策略导致异常被吞掉了，这也是我们期望的行为，后面会介绍如何在处理器中吞掉异常。

核心 API 介绍

主要类型

代码可以去 https://github.com/happyframework/HappyFramework 下载。

重点说一下 ExceptionHandlerChain

package com.happyframework.exception.handling;

public interface ExceptionHandlerChain {

    Throwable getException();

    void setNewException(final Throwable newException);

    boolean isExceptionHandled();

    void setExceptionHandled(final boolean exceptionHandled);

    void proceed();

}

ExceptionHandlerChain 是作为参数传递给 ExceptionHandler：

package com.happyframework.exception.handling;

public interface ExceptionHandler {

    void handle(final ExceptionHandlerChain chain);

}

ExceptionHandlerChain 的成员的主要意图是：

1. Throwable getException()：返回正在处理的异常。
2. void setNewException(final Throwable newException)：替换或包装异常的时候调用此方法。
3. boolean isExceptionHandled()：异常是否被处理过。
4. void setExceptionHandled(final boolean exceptionHandled)：吞掉异常的时候调用此方法。
5. void proceed()：执行下一个处理器。

一个简单的异常处理器

 1 package com.happyframework.exception.handling;
 2 
 3 final class ConsoleNotificationHandler implements ExceptionHandler {
 4 
 5     @Override
 6     public final void handle(final ExceptionHandlerChain chain) {
 7         System.out.println("提示消息：" + chain.getException());
 8 
 9         chain.setExceptionHandled(true);
10         chain.proceed();
11     }
12 
13 }

备注

第一次用 Java 写东西，感觉挺不错的。