Mybatis SQL執行過程

一 Mybatis 的概括
mybatis是一個持久層框架 底層封裝了JDBC。是一個半自動的orm框架 是第一個支持自定義sql 存儲過程和高級映射的類持久層框架 mybatis能夠支持簡單的xml 和註解配置
二 mybatis 整體架構
在這裏插入圖片描述
1.mybatis最上面是接口層 接口層就是開發人員在mapper 或者dao 接口中的定義 是查詢 新增更新 還是刪除操作
2 中間層是數據處理層主要是配置:xml 層級之間的參數映射 sql解析 sql執行 結果集映射
3 基礎支持層包括連接管理 事務管理 配置加載 緩存處理 接口層進而數據處理層都依賴基礎支持層做提供功能支持
接口層:

在不與Spring 集成的情況下,使用 MyBatis 執行數據庫的操作主要如下:

InputStream is = Resources.getResourceAsStream(“myBatis-config.xml”);
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory factory = builder.build(is);
sqlSession = factory.openSession();
其中 sqlsessionfactory sqlsession是mybatis接口的核心類 尤其是sqlsession 這個接口是mybatis中最重要的接口 這個接口能讓你執行命令 獲取映射 管理事務
數據處理層:
2.1 配置解析:
在mybatis初始化 過程中 會加載mybatis-config。xml 配置文件 映射配置文件以及mapper 接口中的註解信息 解析後的配置信息會形成相應的對象並保持在configuration對象中 之後 根據對象創建sqlsessionfactory 對象待到mybatis初始化完成後 可以通過sqlsessionfactory 創建sqlsession對象並開始數據庫操作
2.2 sql執行
sql 執行涉及多個組件 包括mybatis四大核心 Excutor statementHandler parameterhandler resultsethandler SQL的執行過程可以用下面這幅圖描述
在這裏插入圖片描述
MyBatis 層級結構各個組件的介紹(這裏只是簡單介紹,具體介紹在後面):

SqlSession:,它是 MyBatis 核心 API,主要用來執行命令,獲取映射,管理事務。接收開發人員提供 Statement Id 和參數。並返回操作結果。
Executor :執行器,是 MyBatis 調度的核心,負責 SQL 語句的生成以及查詢緩存的維護。
StatementHandler : 封裝了JDBC Statement 操作,負責對 JDBC Statement 的操作,如設置參數、將Statement 結果集轉換成 List 集合。
ParameterHandler : 負責對用戶傳遞的參數轉換成 JDBC Statement 所需要的參數。
ResultSetHandler : 負責將 JDBC 返回的 ResultSet 結果集對象轉換成 List 類型的集合。
TypeHandler : 用於 Java 類型和 JDBC 類型之間的轉換。
MappedStatement : 動態 SQL 的封裝
SqlSource : 表示從 XML 文件或註釋讀取的映射語句的內容,它創建將從用戶接收的輸入參數傳遞給數據庫的 SQL。
Configuration: MyBatis 所有的配置信息都維持在 Configuration 對象之中。
基礎支持層

反射模塊
Mybatis 中的反射模塊,對 Java 反射進行了很好的封裝,提供了簡易的 API,方便上層調用,並且對反射操作進行了一系列的優化,比如,緩存了類的 元數據(MetaClass)和對象的元數據(MetaObject),提高了反射操作的性能。

類型轉換模塊
Mybatis 的別名機制,能夠簡化配置文件,該機制是類型轉換模塊的主要功能之一。類型轉換模塊的另一個功能是實現 JDBC 類型與 Java 類型的轉換。在 SQL 語句綁定參數時,會將數據由 Java 類型轉換成 JDBC 類型;在映射結果集時,會將數據由 JDBC 類型轉換成 Java 類型。

日誌模塊
在 Java 中,有很多優秀的日誌框架,如 Log4j、Log4j2、slf4j 等。Mybatis 除了提供了詳細的日誌輸出信息,還能夠集成多種日誌框架,其日誌模塊的主要功能就是集成第三方日誌框架。

資源加載模塊
該模塊主要封裝了類加載器,確定了類加載器的使用順序,並提供了加載類文件和其它資源文件的功能。

解析器模塊
該模塊有兩個主要功能:一個是封裝了 XPath,爲 Mybatis 初始化時解析 mybatis-config.xml配置文件以及映射配置文件提供支持;另一個爲處理動態 SQL 語句中的佔位符提供支持。

數據源模塊
Mybatis 自身提供了相應的數據源實現,也提供了與第三方數據源集成的接口。數據源是開發中的常用組件之一,很多開源的數據源都提供了豐富的功能,如連接池、檢測連接狀態等,選擇性能優秀的數據源組件,對於提供ORM 框架以及整個應用的性能都是非常重要的。

事務管理模塊
一般地,Mybatis 與 Spring 框架集成,由 Spring 框架管理事務。但 Mybatis 自身對數據庫事務進行了抽象,提供了相應的事務接口和簡單實現。

緩存模塊
Mybatis 中有一級緩存和二級緩存,這兩級緩存都依賴於緩存模塊中的實現。但是需要注意,這兩級緩存與Mybatis 以及整個應用是運行在同一個 JVM 中的,共享同一塊內存,如果這兩級緩存中的數據量較大,則可能影響系統中其它功能,所以需要緩存大量數據時,優先考慮使用 Redis、Memcache 等緩存產品。

Binding 模塊
在調用 SqlSession 相應方法執行數據庫操作時,需要制定映射文件中定義的 SQL 節點,如果 SQL 中出現了拼寫錯誤,那就只能在運行時才能發現。爲了能儘早發現這種錯誤,Mybatis 通過 Binding 模塊將用戶自定義的Mapper 接口與映射文件關聯起來,系統可以通過調用自定義 Mapper 接口中的方法執行相應的 SQL 語句完成數據庫操作,從而避免上述問題。注意,在開發中,我們只是創建了 Mapper 接口,而並沒有編寫實現類,這是因爲 Mybatis 自動爲 Mapper 接口創建了動態代理對象。
mybatis核心組件
在認識了 MyBatis 並瞭解其基礎架構之後,下面我們來看一下 MyBatis 的核心組件,就是這些組件實現了從 SQL 語句到映射到 JDBC 再到數據庫字段之間的轉換,執行 SQL 語句並輸出結果集。首先來認識 MyBatis 的第一個核心組件

SqlSessionFactory

對於任何框架而言,在使用該框架之前都要經歷過一系列的初始化流程,MyBatis 也不例外。MyBatis 的初始化流程如下

String resource = “org/mybatis/example/mybatis-config.xml”;
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
sqlSessionFactory.openSession();
上述流程中比較重要的一個對象就是SqlSessionFactory,SqlSessionFactory 是 MyBatis 框架中的一個接口,它主要負責的是

MyBatis 框架初始化操作
爲開發人員提供SqlSession 對象
在這裏插入圖片描述
SqlSessionFactory 有兩個實現類,一個是 SqlSessionManager 類,一個是 DefaultSqlSessionFactory 類

DefaultSqlSessionFactory : SqlSessionFactory 的默認實現類,是真正生產會話的工廠類,這個類的實例的生命週期是全局的,它只會在首次調用時生成一個實例(單例模式),就一直存在直到服務器關閉。

SqlSessionManager :已被廢棄,原因大概是: SqlSessionManager 中需要維護一個自己的線程池,而使用MyBatis 更多的是要與 Spring 進行集成,並不會單獨使用,所以維護自己的 ThreadLocal 並沒有什麼意義,所以 SqlSessionManager 已經不再使用。

SqlSessionFactory 的執行流程

下面來對 SqlSessionFactory 的執行流程來做一個分析

首先第一步是 SqlSessionFactory 的創建

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
從這行代碼入手,首先創建了一個 SqlSessionFactoryBuilder 工廠,這是一個建造者模式的設計思想,由 builder 建造者來創建 SqlSessionFactory 工廠

然後調用 SqlSessionFactoryBuilder 中的 build 方法傳遞一個InputStream 輸入流,Inputstream 輸入流中就是你傳過來的配置文件 mybatis-config.xml,SqlSessionFactoryBuilder 根據傳入的 InputStream 輸入流和environment、properties屬性創建一個XMLConfigBuilder對象。SqlSessionFactoryBuilder 對象調用XMLConfigBuilder 的parse()方法,流程如下。
在這裏插入圖片描述
XMLConfigBuilder 會解析/configuration標籤,configuration 是 MyBatis 中最重要的一個標籤,下面流程會介紹 Configuration 標籤。
MyBatis 默認使用 XPath 來解析標籤,關於 XPath 的使用,參見 https://www.w3school.com.cn/xpath/index.asp”在 parseConfiguration 方法中,會對各個在 /configuration 中的標籤進行解析
在這裏插入圖片描述
重要配置

說一下這些標籤都是什麼意思吧

properties,外部屬性,這些屬性都是可外部配置且可動態替換的,既可以在典型的 Java 屬性文件中配置,亦可通過 properties 元素的子元素來傳遞。






一般用來給 environment 標籤中的 dataSource 賦值

還可以通過外部屬性進行配置,但是我們這篇文章以原理爲主,不會介紹太多應用層面的操作。

settings ,MyBatis 中極其重要的配置,它們會改變 MyBatis 的運行時行爲。
settings 中配置有很多,具體可以參考 https://mybatis.org/mybatis-3/zh/configuration.html#settings 詳細瞭解。這裏介紹幾個平常使用過程中比較重要的配置
在這裏插入圖片描述




typeAliases,類型別名,類型別名是爲 Java 類型設置的一個名字。它只和 XML 配置有關。



當這樣配置時,Blog 可以用在任何使用 domain.blog.Blog 的地方。

typeHandlers,類型處理器,無論是 MyBatis 在預處理語句(PreparedStatement)中設置一個參數時,還是從結果集中取出一個值時, 都會用類型處理器將獲取的值以合適的方式轉換成 Java 類型。
在 org.apache.ibatis.type 包下有很多已經實現好的 TypeHandler,可以參考如下
在這裏插入圖片描述
你可以重寫類型處理器或創建你自己的類型處理器來處理不支持的或非標準的類型。

具體做法爲:實現 org.apache.ibatis.type.TypeHandler 接口, 或繼承一個很方便的類 org.apache.ibatis.type.BaseTypeHandler, 然後可以選擇性地將它映射到一個 JDBC 類型。

objectFactory,對象工廠,MyBatis 每次創建結果對象的新實例時,它都會使用一個對象工廠(ObjectFactory)實例來完成。默認的對象工廠需要做的僅僅是實例化目標類,要麼通過默認構造方法,要麼在參數映射存在的時候通過參數構造方法來實例化。如果想覆蓋對象工廠的默認行爲,則可以通過創建自己的對象工廠來實現。
public class ExampleObjectFactory extends DefaultObjectFactory {
public Object create(Class type) {
return super.create(type);
}
public Object create(Class type, List constructorArgTypes, List constructorArgs) {
return super.create(type, constructorArgTypes, constructorArgs);
}
public void setProperties(Properties properties) {
super.setProperties(properties);
}
public boolean isCollection(Class type) {
return Collection.class.isAssignableFrom(type);
}
}
然後需要在 XML 中配置此對象工廠

plugins,插件開發,插件開發是 MyBatis 設計人員給開發人員留給自行開發的接口,MyBatis 允許你在已映射語句執行過程中的某一點進行攔截調用。MyBatis 允許使用插件來攔截的方法調用包括:Executor、ParameterHandler、ResultSetHandler、StatementHandler 接口,這幾個接口也是 MyBatis 中非常重要的接口,我們下面會詳細介紹這幾個接口。

environments,MyBatis 環境配置,MyBatis 可以配置成適應多種環境,這種機制有助於將 SQL 映射應用於多種數據庫之中。例如,開發、測試和生產環境需要有不同的配置;或者想在具有相同 Schema 的多個生產數據庫中 使用相同的 SQL 映射。

這裏注意一點,雖然 environments 可以指定多個環境,但是 SqlSessionFactory 只能有一個,爲了指定創建哪種環境,只要將它作爲可選的參數傳遞給 SqlSessionFactoryBuilder 即可。

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, properties);
環境配置如下

databaseIdProvider ,數據庫廠商標示,MyBatis 可以根據不同的數據庫廠商執行不同的語句,這種多廠商的支持是基於映射語句中的 databaseId 屬性。 mappers,映射器,這是告訴 MyBatis 去哪裏找到這些 SQL 語句,mappers 映射配置有四種方式 上面的一個個屬性都對應着一個解析方法,都是使用 XPath 把標籤進行解析,解析完成後返回一個 DefaultSqlSessionFactory 對象,它是 SqlSessionFactory 的默認實現類。這就是 SqlSessionFactoryBuilder 的初始化流程,通過流程我們可以看到,初始化流程就是對一個個 /configuration 標籤下子標籤的解析過程。

SqlSession

在 MyBatis 初始化流程結束,也就是 SqlSessionFactoryBuilder -> SqlSessionFactory 的獲取流程後,我們就可以通過 SqlSessionFactory 對象得到 SqlSession 然後執行 SQL 語句了。具體來看一下這個過程
在這裏插入圖片描述
在 SqlSessionFactory.openSession 過程中我們可以看到,會調用到 DefaultSqlSessionFactory 中的 openSessionFromDataSource 方法,這個方法主要創建了兩個與我們分析執行流程重要的對象,一個是 Executor 執行器對象,一個是 SqlSession 對象。執行器我們下面會說,現在來說一下 SqlSession 對象

SqlSession 對象是 MyBatis 中最重要的一個對象,這個接口能夠讓你執行命令,獲取映射,管理事務。SqlSession 中定義了一系列模版方法,讓你能夠執行簡單的 CRUD 操作,也可以通過 getMapper 獲取 Mapper 層,執行自定義 SQL 語句,因爲 SqlSession 在執行 SQL 語句之前是需要先開啓一個會話,涉及到事務操作,所以還會有 commit、 rollback、close 等方法。這也是模版設計模式的一種應用。

MapperProxy

MapperProxy 是 Mapper 映射 SQL 語句的關鍵對象,我們寫的 Dao 層或者 Mapper 層都是通過 MapperProxy 來和對應的 SQL 語句進行綁定的。下面我們就來解釋一下綁定過程
在這裏插入圖片描述
這就是 MyBatis 的核心綁定流程,我們可以看到 SqlSession 首先調用 getMapper 方法,我們剛纔說到 SqlSession 是大哥級別的人物,只定義標準(有一句話是怎麼說的來着,一流的企業做標準,二流的企業做品牌,三流的企業做產品)。

SqlSession 不願意做的事情交給 Configuration 這個手下去做,但是 Configuration 也是有小弟的,它不願意做的事情直接甩給小弟去做,這個小弟是誰呢?它就是 MapperRegistry,馬上就到核心部分了。MapperRegistry 相當於項目經理,項目經理只從大面上把握項目進度,不需要知道手下的小弟是如何工作的,把任務完成了就好。最終真正幹活的還是 MapperProxyFactory。看到這段代碼 Proxy.newProxyInstance ,你是不是有一種恍然大悟的感覺,如果你沒有的話,建議查閱一下動態代理的文章,這裏推薦一篇 (https://www.jianshu.com/p/95970b089360)

也就是說,MyBatis 中 Mapper 和 SQL 語句的綁定正是通過動態代理來完成的。

通過動態代理,我們就可以方便的在 Dao 層或者 Mapper 層定義接口,實現自定義的增刪改查操作了。那麼具體的執行過程是怎麼樣呢?上面只是綁定過程,彆着急,下面就來探討一下 SQL 語句的執行過程。

在這裏插入圖片描述
有一部分代碼被遮擋,代碼有些多,不過不影響我們看主要流程”
MapperProxyFactory 會生成代理對象,這個對象就是 MapperProxy,最終會調用到 mapperMethod.execute 方法,execute 方法比較長,其實邏輯比較簡單,就是判斷是 插入、更新、刪除 還是 查詢 語句,其中如果是查詢的話,還會判斷返回值的類型,我們可以點進去看一下都是怎麼設計的。

在這裏插入圖片描述
很多代碼其實可以忽略,只看我標出來的重點就好了,我們可以看到,不管你前面經過多少道關卡處理,最終都逃不過 SqlSession 這個老大制定的標準。

我們以 selectList 爲例,來看一下下面的執行過程。
在這裏插入圖片描述
Executor

還記得我們之前的流程中提到了 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 的創建和選擇

我們上面提到 Executor 是由 Configuration 創建的,Configuration 會根據執行器的類型創建,如下
在這裏插入圖片描述
這一步就是執行器的創建過程,根據傳入的 ExecutorType 類型來判斷是哪種執行器,如果不指定 ExecutorType ,默認創建的是簡單執行器。它的賦值可以通過兩個地方進行賦值:

可以通過標籤來設置當前工程中所有的 SqlSession 對象使用默認的 Executor

<setting name="defaultExecutorType" value="SIMPLE"/>
另外一種直接通過Java對方法賦值的方式 session = factory.openSession(ExecutorType.BATCH); Executor 的具體執行過程

Executor 中的大部分方法的調用鏈其實是差不多的,下面是深入源碼分析執行過程,如果你沒有時間或者暫時不想深入研究的話,給你下面的執行流程圖作爲參考。
在這裏插入圖片描述
我們緊跟着上面的 selectList 繼續分析,它會調用到 executor.query 方法。

當有一個查詢請求訪問的時候,首先會經過 Executor 的實現類 CachingExecutor ,先從緩存中查詢 SQL 是否是第一次執行,如果是第一次執行的話,那麼就直接執行 SQL 語句,並創建緩存,如果第二次訪問相同的 SQL 語句的話,那麼就會直接從緩存中提取。
在這裏插入圖片描述
上面這段代碼是從 selectList -> 從緩存中 query 的具體過程。可能你看到這裏有些覺得類都是什麼東西,我想鼓勵你一下,把握重點,不用每段代碼都看,從找到 SQL 的調用鏈路,其他代碼想看的時候在看,看源碼就是很容易發矇,容易煩躁,但是切記一點,把握重點。
在這裏插入圖片描述
上面代碼會判斷緩存中是否有這條 SQL 語句的執行結果,如果沒有的話,就再重新創建 Executor 執行器執行 SQL 語句,注意, list = doQuery 是真正執行 SQL 語句的過程,這個過程中會創建我們上面提到的三種執行器,這裏我們使用的是簡單執行器。

到這裏,執行器所做的工作就完事了,Executor 會把後續的工作交給 StatementHandler 繼續執行。下面我們來認識一下 StatementHandler

StatementHandler

StatementHandler 是四大組件中最重要的一個對象,負責操作 Statement 對象與數據庫進行交互,在工作時還會使用 ParameterHandler 和 ResultSetHandler對參數進行映射,對結果進行實體類的綁定,這兩個組件我們後面說。

我們在搭建原生 JDBC 的時候,會有這樣一行代碼

Statement stmt = conn.createStatement(); //也可以使用PreparedStatement來做
這行代碼創建的 Statement 對象或者是 PreparedStatement 對象就是由 StatementHandler 進行管理的。

StatementHandler 的繼承結構
在這裏插入圖片描述
有沒有感覺和 Executor 的繼承體系很相似呢?最頂級接口是四大組件對象,分別有兩個實現類 BaseStatementHandler 和 RoutingStatementHandler,BaseStatementHandler 有三個實現類, 他們分別是 SimpleStatementHandler、PreparedStatementHandler 和 CallableStatementHandler。

RoutingStatementHandler : RoutingStatementHandler 並沒有對 Statement 對象進行使用,只是根據StatementType 來創建一個代理,代理的就是對應Handler的三種實現類。在MyBatis工作時,使用的StatementHandler 接口對象實際上就是 RoutingStatementHandler 對象。

BaseStatementHandler : 是 StatementHandler 接口的另一個實現類,它本身是一個抽象類,用於簡化StatementHandler 接口實現的難度,屬於適配器設計模式體現,它主要有三個實現類

SimpleStatementHandler: 管理 Statement 對象並向數據庫中推送不需要預編譯的SQL語句。
PreparedStatementHandler: 管理 Statement 對象並向數據中推送需要預編譯的SQL語句。
CallableStatementHandler:管理 Statement 對象並調用數據庫中的存儲過程。
這裏注意一下,SimpleStatementHandler 和 PreparedStatementHandler 的區別是 SQL 語句是否包含變量,是否通過外部進行參數傳入。SimpleStatementHandler 用於執行沒有任何參數傳入的 SQLPreparedStatementHandler 需要對外部傳入的變量和參數進行提前參數綁定和賦值。”
StatementHandler 的創建和源碼分析

我們繼續來分析上面 query 的調用鏈路,StatementHandler 的創建過程如下
在這裏插入圖片描述
MyBatis 會根據 SQL 語句的類型進行對應 StatementHandler 的創建。我們以預處理 StatementHandler 爲例來講解一下
在這裏插入圖片描述
執行器不僅掌管着 StatementHandler 的創建,還掌管着創建 Statement 對象,設置參數等,在創建完 PreparedStatement 之後,我們需要對參數進行處理了。

如果用一副圖來表示一下這個執行流程的話我想是這樣
在這裏插入圖片描述
ParameterHandler

ParameterHandler 介紹

ParameterHandler 相比於其他的組件就簡單很多了,ParameterHandler 譯爲參數處理器,負責爲 PreparedStatement 的 sql 語句參數動態賦值,這個接口很簡單隻有兩個方法
在這裏插入圖片描述
ParameterHandler 只有一個實現類 DefaultParameterHandler , 它實現了這兩個方法。

getParameterObject:用於讀取參數
setParameters: 用於對 PreparedStatement 的參數賦值
ParameterHandler 的解析過程

上面我們討論過了 ParameterHandler 的創建過程,下面我們繼續上面 parameterSize 流程
在這裏插入圖片描述
這就是具體參數的解析過程了,下面我們來描述一下

public void setParameters(PreparedStatement ps) {
ErrorContext.instance().activity(“setting parameters”).object(mappedStatement.getParameterMap().getId());
// parameterMappings 就是對 #{} 或者 ${} 裏面參數的封裝
List parameterMappings = boundSql.getParameterMappings();
if (parameterMappings != null) {
// 如果是參數化的SQL,便需要循環取出並設置參數的值
for (int i = 0; i < parameterMappings.size(); i++) {
ParameterMapping parameterMapping = parameterMappings.get(i);
// 如果參數類型不是 OUT ,這個類型與 CallableStatementHandler 有關
// 因爲存儲過程不存在輸出參數,所以參數不是輸出參數的時候,就需要設置。
if (parameterMapping.getMode() != ParameterMode.OUT) {
Object value;
// 得到 #{} 中的屬性名
String propertyName = parameterMapping.getProperty();
// 如果 propertyName 是 Map 中的key
if (boundSql.hasAdditionalParameter(propertyName)) { // issue #448 ask first for additional params
// 通過key 來得到 additionalParameter 中的value值
value = boundSql.getAdditionalParameter(propertyName);
}
// 如果不是 additionalParameters 中的key,而且傳入參數是 null, 則value 就是null
else if (parameterObject == null) {
value = null;
}
// 如果 typeHandlerRegistry 中已經註冊了這個參數的 Class 對象,即它是 Primitive 或者是String 的話
else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) {
value = parameterObject;
} else {
// 否則就是 Map
MetaObject metaObject = configuration.newMetaObject(parameterObject);
value = metaObject.getValue(propertyName);
}
// 在通過 SqlSource 的parse 方法得到parameterMappings 的具體實現中,我們會得到parameterMappings 的 typeHandler
TypeHandler typeHandler = parameterMapping.getTypeHandler();
// 獲取 typeHandler 的jdbc type
JdbcType jdbcType = parameterMapping.getJdbcType();
if (value == null && jdbcType == null) {
jdbcType = configuration.getJdbcTypeForNull();
}
try {
typeHandler.setParameter(ps, i + 1, value, jdbcType);
} catch (TypeException e) {
throw new TypeException("Could not set parameters for mapping: " + parameterMapping + ". Cause: " + e, e);
} catch (SQLException e) {
throw new TypeException("Could not set parameters for mapping: " + parameterMapping + ". Cause: " + e, e);
}
}
}
}
}
下面用一個流程圖表示一下 ParameterHandler 的解析過程,以簡單執行器爲例
在這裏插入圖片描述
在這裏插入圖片描述
ResultSetHandler

ResultSetHandler 簡介

ResultSetHandler 也是一個非常簡單的接口
在這裏插入圖片描述
ResultSetHandler 解析過程

MyBatis 只有一個默認的實現類就是 DefaultResultSetHandler,DefaultResultSetHandler 主要負責處理兩件事

處理 Statement 執行後產生的結果集,生成結果列表

處理存儲過程執行後的輸出參數

按照 Mapper 文件中配置的 ResultType 或 ResultMap 來封裝成對應的對象,最後將封裝的對象返回即可。

public List handleResultSets(Statement stmt) throws SQLException {
ErrorContext.instance().activity(“handling results”).object(mappedStatement.getId());

final List multipleResults = new ArrayList();

int resultSetCount = 0;
// 獲取第一個結果集
ResultSetWrapper rsw = getFirstResultSet(stmt);
// 獲取結果映射
List resultMaps = mappedStatement.getResultMaps();
// 結果映射的大小
int resultMapCount = resultMaps.size();
// 校驗結果映射的數量
validateResultMapsCount(rsw, resultMapCount);
// 如果ResultSet 包裝器不是null, 並且 resultmap 的數量 > resultSet 的數量的話
// 因爲 resultSetCount 第一次肯定是0,所以直接判斷 ResultSetWrapper 是否爲 0 即可
while (rsw != null && resultMapCount > resultSetCount) {
// 從 resultMap 中取出 resultSet 數量
ResultMap resultMap = resultMaps.get(resultSetCount);
// 處理結果集, 關閉結果集
handleResultSet(rsw, resultMap, multipleResults, null);
rsw = getNextResultSet(stmt);
cleanUpAfterHandlingResultSet();
resultSetCount++;
}

// 從 mappedStatement 取出結果集
String[] resultSets = mappedStatement.getResultSets();
if (resultSets != null) {
while (rsw != null && resultSetCount < resultSets.length) {
ResultMapping parentMapping = nextResultMaps.get(resultSets[resultSetCount]);
if (parentMapping != null) {
String nestedResultMapId = parentMapping.getNestedResultMapId();
ResultMap resultMap = configuration.getResultMap(nestedResultMapId);
handleResultSet(rsw, resultMap, null, parentMapping);
}
rsw = getNextResultSet(stmt);
cleanUpAfterHandlingResultSet();
resultSetCount++;
}
}

return collapseSingleResultList(multipleResults);
}
其中涉及的主要對象有:

ResultSetWrapper : 結果集的包裝器,主要針對結果集進行的一層包裝,它的主要屬性有

ResultSet : Java JDBC ResultSet 接口表示數據庫查詢的結果。有關查詢的文本顯示瞭如何將查詢結果作爲java.sql.ResultSet 返回。然後迭代此ResultSet以檢查結果。

TypeHandlerRegistry: 類型註冊器,TypeHandlerRegistry 在初始化的時候會把所有的 Java類型和類型轉換器進行註冊。

ColumnNames: 字段的名稱,也就是查詢操作需要返回的字段名稱

ClassNames: 字段的類型名稱,也就是 ColumnNames 每個字段名稱的類型

JdbcTypes: JDBC 的類型,也就是 java.sql.Types 類型

ResultMap: 負責處理更復雜的映射關係

在 DefaultResultSetHandler 中處理完結果映射,並把上述結構返回給調用的客戶端,從而執行完成一條完整的SQL語句。

文章參考:

MyBatis的優缺點以及特點

mybatis基礎,mybatis核心配置文件properties元素

https://mybatis.org/mybatis-3/zh/configuration.html#properties

深入淺出Mybatis系列(十)—SQL執行流程分析(源碼篇)

https://www.jianshu.com/p/19686af69b0d

http://www.mybatis.org/mybatis-3/getting-started.html

https://www.cnblogs.com/virgosnail/p/10067964.html

https://blog.csdn.net/Roger_CoderLife/article/details/88707076

https://blog.csdn.net/qq924862077/article/details/52704191

[mybatis 源碼分析(八)ResultSetHandler 詳解](

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章