Mybatis 源碼探究 （3）創(chuàng)建 SqlSessionFactory對象

時(shí)隔許久，終于又能接著來搞他啦。Mybatis 一起來探究吧。

先笑會再進(jìn)入主題吧

開始啦

一、new SqlSessionFactoryBuilder().build(inputStream) 方法

String resource="mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream); public SqlSessionFactory build(InputStream inputStream) {//在這里又接著調(diào)用了重載方法build 我們接著往下走啊 return build(inputStream, null, null); }

二、SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) 方法

public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {try {//XMLConfigBuilder是對mybatis的配置文件進(jìn)行解析的類，會對myabtis解析后的信息存放在Configuration對象中XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);// 下面這句到重點(diǎn)啦return build(parser.parse());} catch (Exception e) {throw ExceptionFactory.wrapException("Error building SqlSession.", e);} finally {ErrorContext.instance().reset();try {inputStream.close();} catch (IOException e) {// Intentionally ignore. Prefer previous error.}} }

一個(gè)一個(gè)講啊，慢慢來。

1、 new XMLConfigBuilder(inputStream, environment, properties);

XMLConfigBuilder ： 翻譯過來就是XML配置器

XMLConfigBuilder是對mybatis的配置文件進(jìn)行解析的類，會對myabtis解析后的信息存放在Configuration對象中，Configuration對象

會貫穿整個(gè)mybatis的執(zhí)行流程，為mybatis的執(zhí)行過程提供各種需要的配置信息。

public XMLConfigBuilder(InputStream inputStream, String environment, Properties props) {this(new XPathParser(inputStream, true, props, new XMLMapperEntityResolver()), environment, props); }

XPathParser 和 XMLMapperEntityResolver 不是主要研究對象，我放在了文章最后，好奇的話，可以先滑到文末去看。

三、build(parser.parse()) 方法

先看parser.parse()方法 它的返回對象是核心配置對象Configuration

public Configuration parse() {if (parsed) {throw new BuilderException("Each XMLConfigBuilder can only be used once.");}parsed = true;parseConfiguration(parser.evalNode("/configuration"));return configuration; }

進(jìn)入到parseConfiguration(parser.evalNode("/configuration"))方法

可以看到 在這里就是將我們配置的好的文件 一步一步解析封裝到Configuration對象去。

private void parseConfiguration(XNode root) {try {// issue #117 read properties firstpropertiesElement(root.evalNode("properties"));Properties settings = settingsAsProperties(root.evalNode("settings"));loadCustomVfs(settings);loadCustomLogImpl(settings);typeAliasesElement(root.evalNode("typeAliases"));pluginElement(root.evalNode("plugins"));objectFactoryElement(root.evalNode("objectFactory"));objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));reflectorFactoryElement(root.evalNode("reflectorFactory"));settingsElement(settings);// read it after objectFactory and objectWrapperFactory issue #631environmentsElement(root.evalNode("environments"));databaseIdProviderElement(root.evalNode("databaseIdProvider"));typeHandlerElement(root.evalNode("typeHandlers"));mapperElement(root.evalNode("mappers"));} catch (Exception e) {throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);}}

這一段代碼主要作用就是將所有的配置文件加載到給定的對象。

我對于研究這個(gè)非常不熟練，結(jié)果就是走不出來。

mapperElement(root.evalNode("mappers"))里面要研究的東西不少，先略過哈。

四、return build(parser.parse()); 回到我們的入口處

我們可以知道 parser.parse() 構(gòu)建出了一個(gè) Configuration 對象，并成為了build（）方法的入?yún)ⅰ?/p>

這個(gè)build(parser.parse()); 是

public SqlSessionFactory build(Configuration config) {return new DefaultSqlSessionFactory(config);}

這個(gè)地方就是將之前已經(jīng)賦值好的Configuration 放在里面

public DefaultSqlSessionFactory(Configuration configuration) {this.configuration = configuration;}

課間休息

地點(diǎn)：長沙

五、SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

至此 我們獲得了 SqlSessionFactory 對象，我們可以通過這獲取到mybatis操作數(shù)據(jù)庫的 SqlSession 對象。

SqlSession sqlSession = sessionFactory.openSession();

openSession() 是SqlSessionFactory 接口下的方法

public interface SqlSessionFactory {SqlSession openSession();SqlSession openSession(boolean autoCommit);SqlSession openSession(Connection connection);SqlSession openSession(TransactionIsolationLevel level);SqlSession openSession(ExecutorType execType);SqlSession openSession(ExecutorType execType, boolean autoCommit);SqlSession openSession(ExecutorType execType, TransactionIsolationLevel level);SqlSession openSession(ExecutorType execType, Connection connection);Configuration getConfiguration(); }

我們這里調(diào)用的方法是這個(gè)哈

@Overridepublic SqlSession openSession() {// openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) return openSessionFromDataSource(configuration.getDefaultExecutorType(), null, false);}

最后一個(gè)參數(shù)就是是否提交，如果不為true，我們做了修改or刪除，數(shù)據(jù)庫并不會修改or刪除。

接著往下看：

private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {Transaction tx = null;try {final Environment environment = configuration.getEnvironment();final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);final Executor executor = configuration.newExecutor(tx, execType);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();}}

最后返回mybatis操作數(shù)據(jù)庫的 SqlSession 對象。

六、MyUserMapper mapper = sqlSession.getMapper(MyUserMapper.class);

/**檢索映射器。參數(shù)：type – 映射器接口類類型參數(shù)：<T> – 映射器類型返回：綁定到此 SqlSession 的映射器*/<T> T getMapper(Class<T> type);

接下來開始套娃哈

我們實(shí)際調(diào)用的是它的實(shí)現(xiàn)類里的方法：

@Override public <T> T getMapper(Class<T> type) {return configuration.getMapper(type, this); }

你看又牽扯到configuration對象了哈，知道它多重要了吧。

public <T> T getMapper(Class<T> type, SqlSession sqlSession) {return mapperRegistry.getMapper(type, sqlSession); }

到了mapperRegistry 這個(gè)對象拉。 mapperRegistry的翻譯就是映射器注冊表 這個(gè)地方我目前還沒有搞懂它是什么時(shí)候注冊進(jìn)去的哈。

public <T> T getMapper(Class<T> type, SqlSession sqlSession) {// 這里是去獲得 我們傳過來的 MyUserMapper.class的代理類的final MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory<T>) knownMappers.get(type);if (mapperProxyFactory == null) {throw new BindingException("Type " + type + " is not known to the MapperRegistry.");}try {return mapperProxyFactory.newInstance(sqlSession);} catch (Exception e) {throw new BindingException("Error getting mapper instance. Cause: " + e, e);}}

接下來繼續(xù)看這個(gè) mapperProxyFactory.newInstance(sqlSession) 方法

public T newInstance(SqlSession sqlSession) {final MapperProxy<T> mapperProxy = new MapperProxy<>(sqlSession, mapperInterface, methodCache);return newInstance(mapperProxy);}

接著套丫

protected T newInstance(MapperProxy<T> mapperProxy) {return (T) Proxy.newProxyInstance(mapperInterface.getClassLoader(), new Class[] { mapperInterface }, mapperProxy);}

當(dāng)我們看到這里的時(shí)候就知道m(xù)ybatis是通過反射和代理來進(jìn)行這些操作的哈。

真實(shí)執(zhí)行對象并不在，而是在 MapperProxy mapperProxy Mapper的代理對象中。

那個(gè)具體執(zhí)行的，等下一篇博客哈。我還有很多沒懂的。

七、XPathParser

public class XPathParser {private final Document document;private boolean validation;private EntityResolver entityResolver;private Properties variables;private XPath xpath; }

• Document（Document對象）

  Document 對象代表整個(gè) XML 文檔，是一棵文檔樹的根，可為我們提供對文檔數(shù)據(jù)的最初（或最頂層）的訪問入口。

• validation（是否開啟驗(yàn)證標(biāo)記）

  該標(biāo)記表示設(shè)置解析器在解析文檔的時(shí)候是否校驗(yàn)文檔，在創(chuàng)建DocumentBuilderFactory實(shí)例對象時(shí)進(jìn)行設(shè)置。

• EntityResolver （加載本地的DTD文件

  如果解析mybatis-config.xml 配置文件，默認(rèn)聯(lián)網(wǎng)加載http://mybatis.org/dtd/mybatis-3- config.dtd 這個(gè)DTD 文檔，當(dāng)網(wǎng)絡(luò)比較慢時(shí)會導(dǎo)致驗(yàn)證過程緩慢。在實(shí)踐中往往會提前設(shè)置EntityResolver 接口對象加載本地的DTD 文件，從而避免聯(lián)網(wǎng)加載DTD文件。

• XPath （XPath對象）

  XPath 是一種為查詢XML 文檔而設(shè)計(jì)的語言，它可以與DOM 解析方式配合使用，實(shí)現(xiàn)對XML 文檔的解析。

• variables（配置參數(shù)集合）。

  對應(yīng)配置文件中節(jié)點(diǎn)下定義的鍵值對集合，包括通過url或者resource讀取的鍵值對集合。

八、XMLMapperEntityResolver

對這個(gè)我沒有深究。doc注釋就是這么一句話：MyBatis DTD 的離線實(shí)體解析器 說實(shí)話DTD都是我第一次見 🤦?

當(dāng)然百度是強(qiáng)大的。

它是EntityResolver子類，xml 的解析會基于事件觸發(fā)對應(yīng)的 Resolver 或 Handler，當(dāng)解析到 dtd 等外部資源時(shí)會

EntityResolver的resolveEntity方法。在XMLMapperEntityResolver.resolveEntity中，當(dāng)解析到 mybatis-3-config.dtd、

mybatis-3-mapper.dtd 等資源時(shí)，會直接從 classpath 下的 org/apache/ibatis/builder/xml/ 路徑獲取資源，而不需要通過 url 獲取。

九、XMLMapperBuilder類

涉及到的類包括：

MapperBuilderAssistant：Mapper文件解析輔助類，包括了解析各種節(jié)點(diǎn)的方法。

BaseBuilder：XMLMapperBuilder與MapperBuilderAssistant的父類，保存了Configuration、TypeAliasRegistry、TypeHandlerRegistry三個(gè)屬性。

TypeAliasRegistry：別名對應(yīng)關(guān)系，保存了字符串與類的對應(yīng)信息，例如“String”字符串對應(yīng) String.class

TypeHandlerRegistry：注冊java.lang與java.sql類型對應(yīng)關(guān)系

Configuration：Mapper文件解析節(jié)點(diǎn)完成后，存儲解析后的屬性信息。

XMLStatementBuilder：解析SQL語句節(jié)點(diǎn)類，解析后存儲在Configuration下的mappedStatements屬性

XMLMapperBuilder用于解析Mapper文件，包括namespace、parameterMap、resultMap以及各種SQL（insert/uppdate/delete/select）

解析過程中主要是parse()方法，

解析Mapper文件后會存儲在MapperBuilderAssistant以及它父類BaseBuilder的實(shí)例下，主要是Configuration類

自言自語

我這算是自己的閱讀筆記哈，無聊讀著看看。

算是我第一次讀源碼的記錄。

大家一起加油哦。

總結(jié)

以上是生活随笔為你收集整理的Mybatis 源码探究 （3）创建 SqlSessionFactory对象 执行sqlSession.getMapper()方法的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。