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

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】即可免费领取。

阅读全文

精尽 MyBatis 源码

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