精尽 MyBatis 源码分析 —— 异常模块

作者简介：大家好，我是smart哥，前中兴通讯、美团架构师，现某互联网公司CTO

联系qq：184480602，加我进群，大家一起学习，一起进步，一起对抗互联网寒冬

学习必须往深处挖，挖的越深，基础越扎实！

阶段1、深入多线程

阶段2、深入多线程设计模式

阶段3、深入juc源码解析

阶段4、深入jdk其余源码解析

阶段5、深入jvm源码解析

码哥源码部分

码哥讲源码-原理源码篇【2024年最新大厂关于线程池使用的场景题】

码哥讲源码【炸雷啦！炸雷啦！黄光头他终于跑路啦！】

码哥讲源码-【jvm课程前置知识及c/c++调试环境搭建】

​​​​​​码哥讲源码-原理源码篇【揭秘join方法的唤醒本质上决定于jvm的底层析构函数】

码哥源码-原理源码篇【Doug Lea为什么要将成员变量赋值给局部变量后再操作？】

码哥讲源码【你水不是你的错,但是你胡说八道就是你不对了！】

码哥讲源码【谁再说Spring不支持多线程事务，你给我抽他！】

终结B站没人能讲清楚红黑树的历史，不服等你来踢馆！

打脸系列【020-3小时讲解MESI协议和volatile之间的关系，那些将x86下的验证结果当作最终结果的水货们请闭嘴】

1.概述

定义了 MyBatis 专有的 PersistenceException 和 TooManyResultsException 异常。

2. exceptions 包

2.1 IbatisException

org.apache.ibatis.exceptions.IbatisException ，实现 RuntimeException 类，IBatis 的异常基类。代码如下：

    @Deprecated
    public class IbatisException extends RuntimeException {
    
      private static final long serialVersionUID = 3880206998166270511L;
    
      public IbatisException() {
        super();
      }
    
      public IbatisException(String message) {
        super(message);
      }
    
      public IbatisException(String message, Throwable cause) {
        super(message, cause);
      }
    
      public IbatisException(Throwable cause) {
        super(cause);
      }
    
    }

实际上，IbatisException 已经在 2015 年被废弃，取代它的是 PersistenceException 类。

2.2 IbatisException

org.apache.ibatis.exceptions.PersistenceException ，继承 IbatisException 类，目前 MyBatis 真正的异常基类。代码如下：

    public class PersistenceException extends IbatisException {
    
      private static final long serialVersionUID = -7537395265357977271L;
    
      public PersistenceException() {
        super();
      }
    
      public PersistenceException(String message) {
        super(message);
      }
    
      public PersistenceException(String message, Throwable cause) {
        super(message, cause);
      }
    
      public PersistenceException(Throwable cause) {
        super(cause);
      }
    }

2.3 ExceptionFactory

org.apache.ibatis.exceptions.ExceptionFactory ，异常工厂。代码如下：

    public class ExceptionFactory {
    
      private ExceptionFactory() {
        // Prevent Instantiation
      }
    
      public static RuntimeException wrapException(String message, Exception e) {
        return new PersistenceException(ErrorContext.instance().message(message).cause(e).toString(), e);
      }
    
    }

2.4 TooManyResultsException

org.apache.ibatis.exceptions.TooManyResultsException ，继承 PersistenceException 类，查询返回过多结果的异常。期望返回一条，实际返回了多条。代码如下：

    public class TooManyResultsException extends PersistenceException {
    
      private static final long serialVersionUID = 8935197089745865786L;
    
      public TooManyResultsException() {
        super();
      }
    
      public TooManyResultsException(String message) {
        super(message);
      }
    
      public TooManyResultsException(String message, Throwable cause) {
        super(message, cause);
      }
    
      public TooManyResultsException(Throwable cause) {
        super(cause);
      }
    }

2.5 ParsingException

org.apache.ibatis.parsing.ParsingException ，继承 PersistenceException 类，解析异常。代码如下：

    public class ParsingException extends PersistenceException {
      private static final long serialVersionUID = -176685891441325943L;
    
      public ParsingException() {
        super();
      }
    
      public ParsingException(String message) {
        super(message);
      }
    
      public ParsingException(String message, Throwable cause) {
        super(message, cause);
      }
    
      public ParsingException(Throwable cause) {
        super(cause);
      }
    }

3. 其它包

实际上，我们会看到其他包，会和 parsing 包一样，都会定义其独有的异常类。但是，代码都是相同的。所以，这里就简单整理如下：

reflection 包：ReflectionException
logging 包：LogException
builder 包：BuilderException、IncompleteElementException
scripting 包：ScriptingException
binding 包：BindingException
type 包：TypeException
session 包：SqlSessionException
cache 包：CacheException
transaction 包：TransactionException
datasource 包：DataSourceException
executor 包：ResultMapException、ExecutorException、BatchExecutorException
plugin 包：PluginException