上一篇我們對SqlSession和SqlSessionFactory的創建過程有了一個詳細的了解,但上述的創建過程只是為SQL執行和SQL映射做了基礎的鋪墊而已,就和我們Spring源碼為Bean容器的加載進行許多初始化的工作相同,那么做好前期的准備工作接下來該做什么了?該做數據庫連接驅動管理和SQL解析工作了!那么本篇本章就來討論一下數據庫驅動連接管理和SQL解析的管理組件之 Executor執行器。
MyBatis四大組件之 Executor執行器
每一個SqlSession都會擁有一個Executor對象,這個對象負責增刪改查的具體操作,我們可以簡單的將它理解為JDBC中Statement的封裝版。
Executor的繼承結構
如圖所示,位於繼承體系最頂層的是Executor執行器,它有兩個實現類,分別是BaseExecutor
和 CachingExecutor
。
BaseExecutor
是一個抽象類,這種通過抽象的實現接口的方式是適配器設計模式之接口適配
的體現,是Executor的默認實現,實現了大部分Executor接口定義的功能,降低了接口實現的難度。BaseExecutor的子類有三個,分別是SimpleExecutor
、ReuseExecutor
和BatchExecutor
。
SimpleExecutor: 簡單執行器,是MyBatis中默認使用的執行器,每執行一次update或select,就開啟一個Statement對象,用完就直接關閉Statement對象(可以是Statement或者是PreparedStatment對象)
ReuseExecutor: 可重用執行器,這里的重用指的是重復使用Statement,它會在內部使用一個Map把創建的Statement都緩存起來,每次執行SQL命令的時候,都會去判斷是否存在基於該SQL的Statement對象,如果存在Statement對象並且對應的connection還沒有關閉的情況下就繼續使用之前的Statement對象,並將其緩存起來。因為每一個SqlSession都有一個新的Executor對象,所以我們緩存在ReuseExecutor上的Statement作用域是同一個SqlSession。
BatchExecutor: 批處理執行器,用於將多個SQL一次性輸出到數據庫
CachingExecutor
: 緩存執行器,先從緩存中查詢結果,如果存在,就返回;如果不存在,再委托給Executor delegate 去數據庫中取,delegate可以是上面任何一個執行器
Executor創建過程以及源碼分析
上面我們分析完SqlSessionFactory的創建過程的准備工作后,我們下面就開始分析會話的創建以及Executor的執行過程。
在創建完SqlSessionFactory之后,調用其openSession
方法:
SqlSession sqlSession = factory.openSession();
SqlSessionFactory的默認實現是DefaultSqlSessionFactory,所以我們需要關心的就是DefaultSqlSessionFactory中的openSession()方法
openSession調用的是openSessionFromDataSource
方法,傳遞執行器的類型,方法傳播級別,是否自動提交,然后在openSessionFromDataSource方法中會創建一個執行器
public SqlSession openSession() {
return openSessionFromDataSource(configuration.getDefaultExecutorType(), null, false);
}
private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {
Transaction tx = null;
try {
// 得到configuration 中的environment
final Environment environment = configuration.getEnvironment();
// 得到configuration 中的事務工廠
final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);
tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);
// 獲取執行器
final Executor executor = configuration.newExecutor(tx, execType);
// 返回默認的SqlSession
return new DefaultSqlSession(configuration, executor, autoCommit);
} catch (Exception e) {
closeTransaction(tx); // may have fetched a connection so lets call close()
throw ExceptionFactory.wrapException("Error opening session. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
調用newExecutor方法,根據傳入的ExecutorType類型來判斷是哪種執行器,然后執行相應的邏輯
public Executor newExecutor(Transaction transaction, ExecutorType executorType) {
// defaultExecutorType默認是簡單執行器, 如果不傳executorType的話,默認使用簡單執行器
executorType = executorType == null ? defaultExecutorType : executorType;
executorType = executorType == null ? ExecutorType.SIMPLE : executorType;
Executor executor;
// 根據執行器類型生成對應的執行器邏輯
if (ExecutorType.BATCH == executorType) {
executor = new BatchExecutor(this, transaction);
} else if (ExecutorType.REUSE == executorType) {
executor = new ReuseExecutor(this, transaction);
} else {
executor = new SimpleExecutor(this, transaction);
}
// 如果允許緩存,則使用緩存執行器
// 默認是true,如果不允許緩存的話,需要手動設置
if (cacheEnabled) {
executor = new CachingExecutor(executor);
}
// 插件開發。
executor = (Executor) interceptorChain.pluginAll(executor);
return executor;
}
ExecutorType的選擇:
ExecutorType來決定Configuration對象創建何種類型的執行器,它的賦值可以通過兩個地方進行賦值:
- 可以通過
標簽來設置當前工程中所有的SqlSession對象使用默認的Executor <settings> <!--取值范圍 SIMPLE, REUSE, BATCH --> <setting name="defaultExecutorType" value="SIMPLE"/> </settings>
- 另外一種直接通過Java對方法賦值的方式
session = factory.openSession(ExecutorType.BATCH);
ExecutorType是一個枚舉,它只有三個值SIMPLE, REUSE, BATCH
創建完成Executor之后,會把Executor執行器放入一個DefaultSqlSession對象中來對四個屬性進行賦值,他們分別是 configuration
、executor
、 dirty
、autoCommit
。
Executor接口的主要方法
Executor接口的方法還是比較多的,這里我們就幾個主要的方法和調用流程來做一個簡單的描述
大致流程
Executor中的大部分方法的調用鏈其實是差不多的,下面都是深入源碼分析執行過程,如果你沒有時間或者暫時不想深入研究的話,給你下面的執行流程圖作為參考。
query()方法
query方法有兩種形式,一種是直接查詢;一種是從緩存中查詢,下面來看一下源碼
<E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey cacheKey, BoundSql boundSql) throws SQLException;
<E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler) throws SQLException;
當有一個查詢請求訪問的時候,首先會經過Executor的實現類CachingExecutor,先從緩存中查詢SQL是否是第一次執行,如果是第一次執行的話,那么就直接執行SQL語句,並創建緩存,如果第二次訪問相同的SQL語句的話,那么就會直接從緩存中提取
CachingExecutor.j
// 第一次查詢,並創建緩存
public <E> List<E> query(MappedStatement ms, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler) throws SQLException {
BoundSql boundSql = ms.getBoundSql(parameterObject);
CacheKey key = createCacheKey(ms, parameterObject, rowBounds, boundSql);
return query(ms, parameterObject, rowBounds, resultHandler, key, boundSql);
}
MapperStatement
維護了一條<select|update|delete|insert>節點的封裝,包括資源(resource),配置(configuration),SqlSource(sql源文件)等。使用Configuration的getMappedStatement方法來獲取MappedStatement對象
BoundSql
這個類包括SQL的基本信息,基本的SQL語句,參數映射,參數類型等
上述的query方法會調用到CachingExecutor類中的query查詢緩存的方法
public <E> List<E> query(MappedStatement ms, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql)
throws SQLException {
// 得到緩存
Cache cache = ms.getCache();
if (cache != null) {
// 如果需要的話刷新緩存
flushCacheIfRequired(ms);
if (ms.isUseCache() && resultHandler == null) {
ensureNoOutParams(ms, boundSql);
@SuppressWarnings("unchecked")
List<E> list = (List<E>) tcm.getObject(cache, key);
if (list == null) {
list = delegate.<E> query(ms, parameterObject, rowBounds, resultHandler, key, boundSql);
tcm.putObject(cache, key, list);
}
return list;
}
}
// 委托模式,交給SimpleExecutor等實現類去實現方法。
return delegate.<E> query(ms, parameterObject, rowBounds, resultHandler, key, boundSql);
}
由delegate執行query方法,delegate即是BaseExecutor,然后由具體的執行器去真正執行query方法
注意:源碼中一般以do** 開頭的方法都是真正加載執行的方法
// 經過一系列的調用,會調用到下面的方法(與主流程無關,故省略)
// 以SimpleExecutor簡單執行器為例
public <E> List<E> doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException {
Statement stmt = null;
try {
// 獲取環境配置
Configuration configuration = ms.getConfiguration();
// 創建StatementHandler,解析SQL語句
StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql);
stmt = prepareStatement(handler, ms.getStatementLog());
// 由handler來對SQL語句執行解析工作
return handler.<E>query(stmt, resultHandler);
} finally {
closeStatement(stmt);
}
}
由上面的源碼可以看出,Executor執行器所起的作用相當於是管理StatementHandler 的整個生命周期的工作,包括創建、初始化、解析、關閉。
ReuseExecutor完成的doQuery 工作:幾乎和SimpleExecutor完成的工作一樣,其內部不過是使用一個Map來存儲每次執行的查詢語句,為后面的SQL重用作准備。
BatchExecutor完成的doQuery 工作:和SimpleExecutor完成的工作一樣。
update() 方法
在分析完上面的查詢方法后,我們再來聊一下update()方法,update()方法不僅僅指的是update()方法,它是一條update鏈,什么意思呢?就是*insert、update、delete在語義上其實都是更新的意思,而查詢在語義上僅僅只是表示的查詢,那么我們來偷窺一下update方法的執行流程,與select的主要執行流程很相似,所以一次性貼出。
// 首先在頂級接口中定義update 方法,交由子類或者抽象子類去實現
// 也是首先去緩存中查詢是否具有已經執行過的相同的update語句
public int update(MappedStatement ms, Object parameterObject) throws SQLException {
flushCacheIfRequired(ms);
return delegate.update(ms, parameterObject);
}
// 然后再交由BaseExecutor 執行update 方法
public int update(MappedStatement ms, Object parameter) throws SQLException {
ErrorContext.instance().resource(ms.getResource()).activity("executing an update").object(ms.getId());
if (closed) {
throw new ExecutorException("Executor was closed.");
}
clearLocalCache();
return doUpdate(ms, parameter);
}
// 往往do* 開頭的都是真正執行解析的方法,所以doUpdate 應該就是真正要執行update鏈的解析方法了
// 交給具體的執行器去執行
public int doUpdate(MappedStatement ms, Object parameter) throws SQLException {
Statement stmt = null;
try {
Configuration configuration = ms.getConfiguration();
StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null);
stmt = prepareStatement(handler, ms.getStatementLog());
return handler.update(stmt);
} finally {
closeStatement(stmt);
}
}
ReuseExecutor完成的doUpdate 工作:幾乎和SimpleExecutor完成的工作一樣,其內部不過是使用一個Map來存儲每次執行的更新語句,為后面的SQL重用作准備。
BatchExecutor完成的doUpdate 工作:和SimpleExecutor完成的工作相似,只是其內部有一個List列表來一次行的存儲多個Statement,用於將多個sql語句一次性輸送到數據庫執行.
queryCursor()方法
我們查閱其源碼的時候,在執行器的執行過程中並沒有發現其與query方法有任何不同之處,但是在doQueryCursor 方法中我們可以看到它返回了一個cursor對象,網上搜索cursor的相關資料並查閱其基本結構,得出來的結論是:用於逐條讀取SQL語句,應對數據量
// 查詢可以返回Cursor<T>類型的數據,類似於JDBC里的ResultSet類,
// 當查詢百萬級的數據的時候,使用游標可以節省內存的消耗,不需要一次性取出所有數據,可以進行逐條處理或逐條取出部分批量處理。
public interface Cursor<T> extends Closeable, Iterable<T> {
boolean isOpen();
boolean isConsumed();
int getCurrentIndex();
}
flushStatements() 方法
flushStatement()的主要執行流程和query,update 的執行流程差不多,我們這里就不再詳細貼代碼了,簡單說一下flushStatement()的主要作用,flushStatement()主要用來釋放statement,或者用於ReuseExecutor和BatchExecutor來刷新緩存
createCacheKey() 方法
createCacheKey()方法主要由BaseExecutor來執行並創建緩存,MyBatis中的緩存分為一級緩存和二級緩存,關於緩存的討論我們將在Mybatis系列的緩存章節
Executor 中的其他方法
Executor 中還有其他方法,提交commit,回滾rollback,判斷是否時候緩存isCached,關閉close,獲取事務getTransaction一級清除本地緩存clearLocalCache等
Executor 的現實抽象
在上面的分析過程中我們了解到,Executor執行器是MyBatis中很重要的一個組件,Executor相當於是外包的boss,它定義了甲方(SQL)需要干的活(Executor的主要方法),這個外包公司是個小公司,沒多少人,每個人都需要干很多工作,boss接到開發任務的話,一般都找項目經理(CachingExecutor),項目經理幾乎不懂技術,它主要和技術leader(BaseExecutor)打交道,技術leader主要負責框架的搭建,具體的工作都會交給下面的程序員來做,程序員的技術也有優劣,高級程序員(BatchExecutor)、中級程序員(ReuseExecutor)、初級程序員(SimpleExecutor),它們干的活也不一樣。一般有新的項目需求傳達到項目經理這里,項目經理先判斷自己手里有沒有現成的類庫或者項目直接套用(Cache),有的話就直接讓技術leader拿來直接套用就好,沒有的話就需要搭建框架,再把框架存入本地類庫中,再進行解析。