Mybatis技術內幕（2.2）：異常模塊

1.0 概述

MyBatis 的異常模塊，源碼對應exceptions包。異常模塊雖然不屬於基礎支持層，可是也貫穿了業務處理的各個環節。以下圖：

包下的內容很簡單，逐一看一看

2.0 PersistenceException

IbatisException已經被廢棄。 org.apache.ibatis.exceptions.PersistenceException是MyBatis真正的異常基類。代碼以下：

@Deprecated
public class IbatisException extends RuntimeException {
    ....省略代碼
}

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);
    }
}
複製代碼

3.0 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);
  }
}
複製代碼

4.0 ExceptionFactory

org.apache.ibatis.exceptions.ExceptionFactory異常工廠,用於包裝異常成PersistenceException。代碼以下：

public class ExceptionFactory {

    private ExceptionFactory() {}

    /** * 包裝異常成 PersistenceException * @param message 消息 * @param e 發生的異常 * @return PersistenceException */
    public static RuntimeException wrapException(String message, Exception e) {
        return new PersistenceException(ErrorContext.instance().message(message).cause(e).toString(), e);
    }
}
複製代碼

其餘異常

實際上，咱們會看到各個模塊包下面都有其都有的異常類，代碼大部分都是相同的，繼承，代碼以下：

public class BindingException extends PersistenceException {

  private static final long serialVersionUID = 4300802238789381562L;

  public BindingException() {
    super();
  }

  public BindingException(String message) {
    super(message);
  }

  public BindingException(String message, Throwable cause) {
    super(message, cause);
  }

  public BindingException(Throwable cause) {
    super(cause);
  }
}
複製代碼

簡單整理下：

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

Java雖然提供了豐富的異常處理類，可是在項目中還會常用自定義異常，其主要緣由是Java提供的異常類在某些狀況下仍是不能知足實際需球。例如如下狀況：

• 一、系統中有些錯誤是符合Java語法，但不符合業務邏輯。
• 二、在分層的軟件結構中，一般是在表現層統一對系統其餘層次的異常進行捕獲處理。

失控的阿甘，樂於分享，記錄點滴