今天來(lái)分析Configuration初始化的最后一部分mapper的加載。​

加載方法mapperElement

XMLConfigBuilder配置Configuration的parseConfiguration方法還剩最后一行解析代碼：mapperElement(root.evalNode('mappers'));

mapperElement方法源碼與詳解如下圖：

從源碼可以得出一些結(jié)論：

mappers節(jié)點(diǎn)支持mapper和package兩種類(lèi)型子節(jié)點(diǎn)；

package子節(jié)點(diǎn)只需要name一個(gè)屬性；

一個(gè)mapper子節(jié)點(diǎn)有且只能有url、resource、class三個(gè)屬性中其中一個(gè)，否則會(huì)拋出異常；

mapperElement解析兩種mappers子節(jié)點(diǎn)，主要代碼我分成了4個(gè)部分，接下來(lái)逐一進(jìn)行深入解析。

解析包方法addMappers

首先來(lái)看解析包的方法使用的是configuration的addMappers方法，方法主要是涉及到一個(gè)MapperRegistry類(lèi)型的屬性mapperRegistry，addMappers主要流程如下圖：

addMappers方法主要涉及到的是MapperRegistry這個(gè)類(lèi)，這個(gè)類(lèi)有兩個(gè)屬性：config、knownMappers。 在config指向的是configuration，knownMappers存放這class文件對(duì)應(yīng)的MapperProxyFactory 。 MapperProxyFactory根據(jù)名字先猜測(cè)是創(chuàng)建mapper代理的工廠。

介紹完關(guān)鍵類(lèi)，再來(lái)看addMappers主要分4步：

調(diào)用mapperRegistry屬性的addMappers(String packageName)方法這個(gè)方法會(huì)調(diào)用另外一個(gè)addMappers；

addMappers(String packageName, Class<?> superType)方法會(huì)遍歷指定包下面所有屬于superType子類(lèi)的類(lèi)，上一步傳遞的是Object.class，所以這里是遍歷所有類(lèi)，然后調(diào)用addMapper(mapperClass)方法；

addMapper(mapperClass)方法首先需要判斷mapperClass必須是接口， 再判斷class是否已經(jīng)存在，存在會(huì)報(bào)異常 。不存在則實(shí)例化一個(gè)MapperProxyFactory對(duì)象并put進(jìn)knownMappers，最后根據(jù)class創(chuàng)建一個(gè)MapperAnnotationBuilder并調(diào)用parse方法。

最后是MapperAnnotationBuilder的parse方法，MapperAnnotationBuilder是解析mapper注解的，我們后面詳解。

加載package下的mapper總的流程看下來(lái)比較簡(jiǎn)單，實(shí)際上就是 找到對(duì)應(yīng)包下面所有的接口，然后根據(jù)接口創(chuàng)建一個(gè)MapperProxyFactory放到configuration屬性mapperRegistry的knownMappers中 。

解析單個(gè)mapper

從解析單個(gè)mapper有三種情況，但是分兩種情況，一種是有resource或者url屬性的是直接根據(jù)屬性值生成一個(gè)XMLMapperBuilder對(duì)象，然后執(zhí)行parse方法，如果是由class屬性值和加載包的最后一步方法相似，調(diào)用mapperRegistry的addMapper方法。

XMLMapperBuilder的初始化和parse簡(jiǎn)單介紹源碼如下圖：

解析mapper.xml的XMLMapperBuilder和最開(kāi)始解析mybatis-config.xml的XMLConfigBuilder一樣都是繼承至mybatis的BaseBuilder，并且初始化流程也差不多。

可以看出XMLMapperBuilder類(lèi)是解析mapper.xml最關(guān)鍵的類(lèi)，這個(gè)類(lèi)比較復(fù)雜，接下來(lái)的文章再來(lái)專(zhuān)門(mén)講解它。

總結(jié)

mapper的注入支持兩種方式，單個(gè)mapper注入或者整個(gè)包下面注入，也可以按加載class文件或者xml文件分成兩種。單個(gè)mapper注入如果是根據(jù)url或者xml則是通過(guò)加載xml文件注入，通過(guò)url獲取掃描整個(gè)包加載則是class方式進(jìn)行注入。

通過(guò)xml加載是直接根據(jù)xml生成XMLMapperBuilder，然后執(zhí)行parse方法。

通過(guò)class加載則是接口類(lèi)生成MapperProxyFactory，放到MapperRegistry的map屬性knownMappers中，最后通過(guò)MapperAnnotationBuilder執(zhí)行parse進(jìn)行解析,parse也會(huì)調(diào)用XMLMapperBuilder的parse方法。

后面的文章我們先解讀MapperAnnotationBuilder這個(gè)類(lèi)，最終再來(lái)看最重要的類(lèi)XMLMapperBuilder。

從目前源碼可以得出一些需要注意的點(diǎn)：

一個(gè)mapper子節(jié)點(diǎn)有且只能有url、resource、class三個(gè)屬性中其中一個(gè)，否則會(huì)拋出異常； 一個(gè)mapper只能被加載一次，重復(fù)加載會(huì)拋出異常。

到此這篇關(guān)于Mybatis對(duì)mapper的加載流程深入講解的文章就介紹到這了,更多相關(guān)Mybatis對(duì)mapper的加載流程內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)！