MyBatis 功能架構(gòu)設(shè)計(jì)
不點(diǎn)藍(lán)字關(guān)注，我們哪來故事？
正文如下
來源：jianshu.com/p/15781ec742f2
MyBatis功能架構(gòu)設(shè)計(jì) 框架架構(gòu) MyBatis核心類 MyBatis成員層次&職責(zé)
MyBatis功能架構(gòu)設(shè)計(jì)
功能架構(gòu)講解：
我們把Mybatis的功能架構(gòu)分為三層：
(1)API接口層：提供給外部使用的接口API，開發(fā)人員通過這些本地API來操縱數(shù)據(jù)庫。接口層一接收到調(diào)用請(qǐng)求就會(huì)調(diào)用數(shù)據(jù)處理層來完成具體的數(shù)據(jù)處理。
(2)數(shù)據(jù)處理層：負(fù)責(zé)具體的SQL查找、SQL解析、SQL執(zhí)行和執(zhí)行結(jié)果映射處理等。它主要的目的是根據(jù)調(diào)用的請(qǐng)求完成一次數(shù)據(jù)庫操作。
(3)基礎(chǔ)支撐層：負(fù)責(zé)最基礎(chǔ)的功能支撐，包括連接管理、事務(wù)管理、配置加載和緩存處理，這些都是共用的東西，將他們抽取出來作為最基礎(chǔ)的組件。為上層的數(shù)據(jù)處理層提供最基礎(chǔ)的支撐。
框架架構(gòu)
框架架構(gòu)講解：
這張圖從上往下看。MyBatis的初始化，會(huì)從mybatis-config.xml配置文件，解析構(gòu)造成Configuration這個(gè)類，就是圖中的紅框。
(1)加載配置：配置來源于兩個(gè)地方，一處是配置文件，一處是Java代碼的注解，將SQL的配置信息加載成為一個(gè)個(gè)MappedStatement對(duì)象（包括了傳入?yún)?shù)映射配置、執(zhí)行的SQL語句、結(jié)果映射配置），存儲(chǔ)在內(nèi)存中。
(2)SQL解析：當(dāng)API接口層接收到調(diào)用請(qǐng)求時(shí)，會(huì)接收到傳入SQL的ID和傳入對(duì)象（可以是Map、JavaBean或者基本數(shù)據(jù)類型），Mybatis會(huì)根據(jù)SQL的ID找到對(duì)應(yīng)的MappedStatement，然后根據(jù)傳入?yún)?shù)對(duì)象對(duì)MappedStatement進(jìn)行解析，解析后可以得到最終要執(zhí)行的SQL語句和參數(shù)。
(3)SQL執(zhí)行：將最終得到的SQL和參數(shù)拿到數(shù)據(jù)庫進(jìn)行執(zhí)行，得到操作數(shù)據(jù)庫的結(jié)果。
(4)結(jié)果映射：將操作數(shù)據(jù)庫的結(jié)果按照映射的配置進(jìn)行轉(zhuǎn)換，可以轉(zhuǎn)換成HashMap、JavaBean或者基本數(shù)據(jù)類型，并將最終結(jié)果返回。
MyBatis核心類
1、SqlSessionFactoryBuilder
每一個(gè)MyBatis的應(yīng)用程序的入口是SqlSessionFactoryBuilder。
它的作用是通過XML配置文件創(chuàng)建Configuration對(duì)象（當(dāng)然也可以在程序中自行創(chuàng)建），然后通過build方法創(chuàng)建SqlSessionFactory對(duì)象。沒有必要每次訪問Mybatis就創(chuàng)建一次SqlSessionFactoryBuilder，通常的做法是創(chuàng)建一個(gè)全局的對(duì)象就可以了。示例程序如下：
private?static?SqlSessionFactoryBuilder?sqlSessionFactoryBuilder;
private?static?SqlSessionFactory?sqlSessionFactory;
private?static?void?init()?throws?IOException?{
????????String?resource?=?"mybatis-config.xml";
????????Reader?reader?=?Resources.getResourceAsReader(resource);
????????sqlSessionFactoryBuilder?=?new?SqlSessionFactoryBuilder();
????????sqlSessionFactory?=?sqlSessionFactoryBuilder.build(reader);
????????}
??????? org.apache.ibatis.session.Configuration 是mybatis初始化的核心。
mybatis-config.xml中的配置，最后會(huì)解析xml成Configuration這個(gè)類。
SqlSessionFactoryBuilder根據(jù)傳入的數(shù)據(jù)流(XML)生成Configuration對(duì)象，然后根據(jù)Configuration對(duì)象創(chuàng)建默認(rèn)的SqlSessionFactory實(shí)例。
2、SqlSessionFactory對(duì)象由SqlSessionFactoryBuilder創(chuàng)建：
它的主要功能是創(chuàng)建SqlSession對(duì)象，和SqlSessionFactoryBuilder對(duì)象一樣，沒有必要每次訪問Mybatis就創(chuàng)建一次SqlSessionFactory，通常的做法是創(chuàng)建一個(gè)全局的對(duì)象就可以了。SqlSessionFactory對(duì)象一個(gè)必要的屬性是Configuration對(duì)象，它是保存Mybatis全局配置的一個(gè)配置對(duì)象，通常由SqlSessionFactoryBuilder從XML配置文件創(chuàng)建。這里給出一個(gè)簡單的示例：
configuration?PUBLIC
????????"-//mybatis.org//DTD?Config?3.0//EN"
????????"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
????
????<typeAliases>
????????<typeAlias?type="org.iMybatis.abc.dao.UserDao"?alias="UserDao"?/>
????????<typeAlias?type="org.iMybatis.abc.dto.UserDto"?alias="UserDto"?/>
????typeAliases>
????
????<environments?default="development">
????????<environment?id="development">
????????????<transactionManager?type="JDBC"?/>
????????????<dataSource?type="POOLED">
????????????????<property?name="driver"?value="com.mysql.jdbc.Driver"?/>
????????????????<property?name="url"?value="jdbc:mysql://127.0.0.1:3306/iMybatis?characterEncoding=GBK"?/>
????????????????<property?name="username"?value="iMybatis"?/>
????????????????<property?name="password"?value="iMybatis"?/>
????????????dataSource>
????????environment>
????environments>
????
????<mappers>
????????<mapper?resource="org/iMybatis/abc/dao/UserDao.xml"?/>
????mappers>
configuration>
3、SqlSession
SqlSession對(duì)象的主要功能是完成一次數(shù)據(jù)庫的訪問和結(jié)果的映射，它類似于數(shù)據(jù)庫的session概念，由于不是線程安全的，所以SqlSession對(duì)象的作用域需限制方法內(nèi)。SqlSession的默認(rèn)實(shí)現(xiàn)類是DefaultSqlSession，它有兩個(gè)必須配置的屬性：Configuration和Executor。Configuration前文已經(jīng)描述這里不再多說。SqlSession對(duì)數(shù)據(jù)庫的操作都是通過Executor來完成的。
SqlSession ：默認(rèn)創(chuàng)建DefaultSqlSession 并且開啟一級(jí)緩存，創(chuàng)建執(zhí)行器 、賦值。
SqlSession有一個(gè)重要的方法getMapper，顧名思義，這個(gè)方式是用來獲取Mapper對(duì)象的。什么是Mapper對(duì)象？根據(jù)Mybatis的官方手冊(cè)，應(yīng)用程序除了要初始并啟動(dòng)Mybatis之外，還需要定義一些接口，接口里定義訪問數(shù)據(jù)庫的方法，存放接口的包路徑下需要放置同名的XML配置文件。
SqlSession的getMapper方法是聯(lián)系應(yīng)用程序和Mybatis紐帶，應(yīng)用程序訪問getMapper時(shí)，Mybatis會(huì)根據(jù)傳入的接口類型和對(duì)應(yīng)的XML配置文件生成一個(gè)代理對(duì)象，這個(gè)代理對(duì)象就叫Mapper對(duì)象。應(yīng)用程序獲得Mapper對(duì)象后，就應(yīng)該通過這個(gè)Mapper對(duì)象來訪問Mybatis的SqlSession對(duì)象，這樣就達(dá)到里插入到Mybatis流程的目的。
SqlSession?session=?sqlSessionFactory.openSession();
????????UserDao?userDao?=?session.getMapper(UserDao.class);
????????UserDto?user?=?new?UserDto();
????????user.setUsername("iMybatis");
????????List<UserDto>?users?=?userDao.queryUsers(user);
????public?interface?UserDao?{
????public?List<UserDto>?queryUsers(UserDto?user)?throws?Exception;
????????}
????????
????????mapper?PUBLIC?"-//mybatis.org//DTD?Mapper?3.0//EN"?"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
????????<mapper?namespace="org.iMybatis.abc.dao.UserDao">
????????????<select?id="queryUsers"?parameterType="UserDto"?resultType="UserDto"
????????????????????useCache="false">
????????????????????????select?*?from?t_user?t?where?t.username?=?#{username}
????????]]>
????????????select>
????????mapper>
4、Executor
Executor對(duì)象在創(chuàng)建Configuration對(duì)象的時(shí)候創(chuàng)建，并且緩存在Configuration對(duì)象里。Executor對(duì)象的主要功能是調(diào)用StatementHandler訪問數(shù)據(jù)庫，并將查詢結(jié)果存入緩存中（如果配置了緩存的話）。
5、StatementHandler
StatementHandler是真正訪問數(shù)據(jù)庫的地方，并調(diào)用ResultSetHandler處理查詢結(jié)果。
6、ResultSetHandler
處理查詢結(jié)果。
MyBatis成員層次&職責(zé)
SqlSession 作為MyBatis工作的主要頂層API，表示和數(shù)據(jù)庫交互的會(huì)話，完成必要數(shù)據(jù)庫增刪改查功能 Executor MyBatis執(zhí)行器，是MyBatis 調(diào)度的核心，負(fù)責(zé)SQL語句的生成和查詢緩存的維護(hù) StatementHandler 封裝了JDBC Statement操作，負(fù)責(zé)對(duì)JDBCstatement的操作，如設(shè)置參數(shù)、將Statement結(jié)果集轉(zhuǎn)換成List集合。 ParameterHandler 負(fù)責(zé)對(duì)用戶傳遞的參數(shù)轉(zhuǎn)換成JDBC Statement 所需要的參數(shù) ResultSetHandler *負(fù)責(zé)將JDBC返回的ResultSet結(jié)果集對(duì)象轉(zhuǎn)換成List類型的集合； TypeHandler 負(fù)責(zé)java數(shù)據(jù)類型和jdbc數(shù)據(jù)類型之間的映射和轉(zhuǎn)換 MappedStatement MappedStatement維護(hù)了一條 SqlSource 負(fù)責(zé)根據(jù)用戶傳遞的parameterObject，動(dòng)態(tài)地生成SQL語句，將信息封裝到BoundSql對(duì)象中，并返回 BoundSql 表示動(dòng)態(tài)生成的SQL語句以及相應(yīng)的參數(shù)信息 Configuration MyBatis所有的配置信息都維持在Configuration對(duì)象之中
title: Mybatis架構(gòu)與原理 date: 2021-05-23 tags: categories: 精進(jìn) permalink: Fight/Mybatis-architecture-and-principle author: 消失er from_url: jianshu.com/p/15781ec742f2 wechat_url:
MyBatis功能架構(gòu)設(shè)計(jì)
功能架構(gòu)講解：
我們把Mybatis的功能架構(gòu)分為三層：
(1)API接口層：提供給外部使用的接口API，開發(fā)人員通過這些本地API來操縱數(shù)據(jù)庫。接口層一接收到調(diào)用請(qǐng)求就會(huì)調(diào)用數(shù)據(jù)處理層來完成具體的數(shù)據(jù)處理。
(2)數(shù)據(jù)處理層：負(fù)責(zé)具體的SQL查找、SQL解析、SQL執(zhí)行和執(zhí)行結(jié)果映射處理等。它主要的目的是根據(jù)調(diào)用的請(qǐng)求完成一次數(shù)據(jù)庫操作。
(3)基礎(chǔ)支撐層：負(fù)責(zé)最基礎(chǔ)的功能支撐，包括連接管理、事務(wù)管理、配置加載和緩存處理，這些都是共用的東西，將他們抽取出來作為最基礎(chǔ)的組件。為上層的數(shù)據(jù)處理層提供最基礎(chǔ)的支撐。
框架架構(gòu)
框架架構(gòu)講解：
這張圖從上往下看。MyBatis的初始化，會(huì)從mybatis-config.xml配置文件，解析構(gòu)造成Configuration這個(gè)類，就是圖中的紅框。
(1)加載配置：配置來源于兩個(gè)地方，一處是配置文件，一處是Java代碼的注解，將SQL的配置信息加載成為一個(gè)個(gè)MappedStatement對(duì)象（包括了傳入?yún)?shù)映射配置、執(zhí)行的SQL語句、結(jié)果映射配置），存儲(chǔ)在內(nèi)存中。
(2)SQL解析：當(dāng)API接口層接收到調(diào)用請(qǐng)求時(shí)，會(huì)接收到傳入SQL的ID和傳入對(duì)象（可以是Map、JavaBean或者基本數(shù)據(jù)類型），Mybatis會(huì)根據(jù)SQL的ID找到對(duì)應(yīng)的MappedStatement，然后根據(jù)傳入?yún)?shù)對(duì)象對(duì)MappedStatement進(jìn)行解析，解析后可以得到最終要執(zhí)行的SQL語句和參數(shù)。
(3)SQL執(zhí)行：將最終得到的SQL和參數(shù)拿到數(shù)據(jù)庫進(jìn)行執(zhí)行，得到操作數(shù)據(jù)庫的結(jié)果。
(4)結(jié)果映射：將操作數(shù)據(jù)庫的結(jié)果按照映射的配置進(jìn)行轉(zhuǎn)換，可以轉(zhuǎn)換成HashMap、JavaBean或者基本數(shù)據(jù)類型，并將最終結(jié)果返回。
MyBatis核心類
1、SqlSessionFactoryBuilder
每一個(gè)MyBatis的應(yīng)用程序的入口是SqlSessionFactoryBuilder。
它的作用是通過XML配置文件創(chuàng)建Configuration對(duì)象（當(dāng)然也可以在程序中自行創(chuàng)建），然后通過build方法創(chuàng)建SqlSessionFactory對(duì)象。沒有必要每次訪問Mybatis就創(chuàng)建一次SqlSessionFactoryBuilder，通常的做法是創(chuàng)建一個(gè)全局的對(duì)象就可以了。示例程序如下：
private?static?SqlSessionFactoryBuilder?sqlSessionFactoryBuilder;
private?static?SqlSessionFactory?sqlSessionFactory;
private?static?void?init()?throws?IOException?{
????????String?resource?=?"mybatis-config.xml";
????????Reader?reader?=?Resources.getResourceAsReader(resource);
????????sqlSessionFactoryBuilder?=?new?SqlSessionFactoryBuilder();
????????sqlSessionFactory?=?sqlSessionFactoryBuilder.build(reader);
????????}
??????? org.apache.ibatis.session.Configuration 是mybatis初始化的核心。
mybatis-config.xml中的配置，最后會(huì)解析xml成Configuration這個(gè)類。
SqlSessionFactoryBuilder根據(jù)傳入的數(shù)據(jù)流(XML)生成Configuration對(duì)象，然后根據(jù)Configuration對(duì)象創(chuàng)建默認(rèn)的SqlSessionFactory實(shí)例。
2、SqlSessionFactory對(duì)象由SqlSessionFactoryBuilder創(chuàng)建：
它的主要功能是創(chuàng)建SqlSession對(duì)象，和SqlSessionFactoryBuilder對(duì)象一樣，沒有必要每次訪問Mybatis就創(chuàng)建一次SqlSessionFactory，通常的做法是創(chuàng)建一個(gè)全局的對(duì)象就可以了。SqlSessionFactory對(duì)象一個(gè)必要的屬性是Configuration對(duì)象，它是保存Mybatis全局配置的一個(gè)配置對(duì)象，通常由SqlSessionFactoryBuilder從XML配置文件創(chuàng)建。這里給出一個(gè)簡單的示例：
configuration?PUBLIC
????????"-//mybatis.org//DTD?Config?3.0//EN"
????????"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
????
????<typeAliases>
????????<typeAlias?type="org.iMybatis.abc.dao.UserDao"?alias="UserDao"?/>
????????<typeAlias?type="org.iMybatis.abc.dto.UserDto"?alias="UserDto"?/>
????typeAliases>
????
????<environments?default="development">
????????<environment?id="development">
????????????<transactionManager?type="JDBC"?/>
????????????<dataSource?type="POOLED">
????????????????<property?name="driver"?value="com.mysql.jdbc.Driver"?/>
????????????????<property?name="url"?value="jdbc:mysql://127.0.0.1:3306/iMybatis?characterEncoding=GBK"?/>
????????????????<property?name="username"?value="iMybatis"?/>
????????????????<property?name="password"?value="iMybatis"?/>
????????????dataSource>
????????environment>
????environments>
????
????<mappers>
????????<mapper?resource="org/iMybatis/abc/dao/UserDao.xml"?/>
????mappers>
configuration>
3、SqlSession
SqlSession對(duì)象的主要功能是完成一次數(shù)據(jù)庫的訪問和結(jié)果的映射，它類似于數(shù)據(jù)庫的session概念，由于不是線程安全的，所以SqlSession對(duì)象的作用域需限制方法內(nèi)。SqlSession的默認(rèn)實(shí)現(xiàn)類是DefaultSqlSession，它有兩個(gè)必須配置的屬性：Configuration和Executor。Configuration前文已經(jīng)描述這里不再多說。SqlSession對(duì)數(shù)據(jù)庫的操作都是通過Executor來完成的。
SqlSession ：默認(rèn)創(chuàng)建DefaultSqlSession 并且開啟一級(jí)緩存，創(chuàng)建執(zhí)行器 、賦值。
SqlSession有一個(gè)重要的方法getMapper，顧名思義，這個(gè)方式是用來獲取Mapper對(duì)象的。什么是Mapper對(duì)象？根據(jù)Mybatis的官方手冊(cè)，應(yīng)用程序除了要初始并啟動(dòng)Mybatis之外，還需要定義一些接口，接口里定義訪問數(shù)據(jù)庫的方法，存放接口的包路徑下需要放置同名的XML配置文件。
SqlSession的getMapper方法是聯(lián)系應(yīng)用程序和Mybatis紐帶，應(yīng)用程序訪問getMapper時(shí)，Mybatis會(huì)根據(jù)傳入的接口類型和對(duì)應(yīng)的XML配置文件生成一個(gè)代理對(duì)象，這個(gè)代理對(duì)象就叫Mapper對(duì)象。應(yīng)用程序獲得Mapper對(duì)象后，就應(yīng)該通過這個(gè)Mapper對(duì)象來訪問Mybatis的SqlSession對(duì)象，這樣就達(dá)到里插入到Mybatis流程的目的。
SqlSession?session=?sqlSessionFactory.openSession();
????????UserDao?userDao?=?session.getMapper(UserDao.class);
????????UserDto?user?=?new?UserDto();
????????user.setUsername("iMybatis");
????????List<UserDto>?users?=?userDao.queryUsers(user);
????public?interface?UserDao?{
????public?List<UserDto>?queryUsers(UserDto?user)?throws?Exception;
????????}
????????
????????mapper?PUBLIC?"-//mybatis.org//DTD?Mapper?3.0//EN"?"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
????????<mapper?namespace="org.iMybatis.abc.dao.UserDao">
????????????<select?id="queryUsers"?parameterType="UserDto"?resultType="UserDto"
????????????????????useCache="false">
????????????????????????select?*?from?t_user?t?where?t.username?=?#{username}
????????]]>
????????????select>
????????mapper>
4、Executor
Executor對(duì)象在創(chuàng)建Configuration對(duì)象的時(shí)候創(chuàng)建，并且緩存在Configuration對(duì)象里。Executor對(duì)象的主要功能是調(diào)用StatementHandler訪問數(shù)據(jù)庫，并將查詢結(jié)果存入緩存中（如果配置了緩存的話）。
5、StatementHandler
StatementHandler是真正訪問數(shù)據(jù)庫的地方，并調(diào)用ResultSetHandler處理查詢結(jié)果。
6、ResultSetHandler
處理查詢結(jié)果。
MyBatis成員層次&職責(zé)
SqlSession 作為MyBatis工作的主要頂層API，表示和數(shù)據(jù)庫交互的會(huì)話，完成必要數(shù)據(jù)庫增刪改查功能 Executor MyBatis執(zhí)行器，是MyBatis 調(diào)度的核心，負(fù)責(zé)SQL語句的生成和查詢緩存的維護(hù) StatementHandler 封裝了JDBC Statement操作，負(fù)責(zé)對(duì)JDBCstatement的操作，如設(shè)置參數(shù)、將Statement結(jié)果集轉(zhuǎn)換成List集合。 ParameterHandler 負(fù)責(zé)對(duì)用戶傳遞的參數(shù)轉(zhuǎn)換成JDBC Statement 所需要的參數(shù) ResultSetHandler *負(fù)責(zé)將JDBC返回的ResultSet結(jié)果集對(duì)象轉(zhuǎn)換成List類型的集合； TypeHandler 負(fù)責(zé)java數(shù)據(jù)類型和jdbc數(shù)據(jù)類型之間的映射和轉(zhuǎn)換 MappedStatement MappedStatement維護(hù)了一條 SqlSource 負(fù)責(zé)根據(jù)用戶傳遞的parameterObject，動(dòng)態(tài)地生成SQL語句，將信息封裝到BoundSql對(duì)象中，并返回 BoundSql 表示動(dòng)態(tài)生成的SQL語句以及相應(yīng)的參數(shù)信息 Configuration MyBatis所有的配置信息都維持在Configuration對(duì)象之中
往期推薦
-END-
↑ 點(diǎn)擊上方關(guān)注我公號(hào)?↑?
我是 Socket，堅(jiān)持分享編程，算法，Java 等干貨教程
一枚醫(yī)科大本科生，開源小作者，半吊子創(chuàng)業(yè)愛好者...
半吊子的自己在試錯(cuò)，不知道以后會(huì)干什么，但享受現(xiàn)在的試錯(cuò)，試錯(cuò)給我驚訝的生活
喜歡公號(hào)的互動(dòng)分享，感謝關(guān)注，路上遇見了你，同一小段時(shí)間之路，相伴 ~
長按識(shí)別，加我微信
點(diǎn)個(gè)在看結(jié)對(duì)編程一把
