Mybatis源碼的9種設計模式

雖然我們都知道有26個設計模式,但是大多停留在概念層面,真實開發中很少遇到,Mybatis源碼中使用了大量的設計模式,閱讀源碼並觀察設計模式在其中的應用,能夠更深入的理解設計模式。

Mybatis至少遇到了以下的設計模式的使用:

1、 Builder模式,例如SqlSessionFactoryBuilder、XMLConfigBuilder、XMLMapperBuilder、XMLStatementBuilder、CacheBuilder;

2、 工廠模式,例如SqlSessionFactory、ObjectFactory、MapperProxyFactory;

3、 單例模式,例如ErrorContext和LogFactory;

4、 代理模式,Mybatis實現的核心,比如MapperProxy、ConnectionLogger,用的jdk的動態代理;還有executor.loader包使用了cglib或者javassist達到延遲加載的效果;

5、 組合模式,例如SqlNode和各個子類ChooseSqlNode等;

6、 模板方法模式,例如BaseExecutor和SimpleExecutor,還有BaseTypeHandler和所有的子類例如IntegerTypeHandler;

7、 適配器模式,例如Log的Mybatis接口和它對jdbc、log4j等各種日誌框架的適配實現;

8、 裝飾者模式,例如Cache包中的cache.decorators子包中等各個裝飾者的實現;

9、 迭代器模式,例如迭代器模式PropertyTokenizer;

接下來挨個模式進行解讀,先介紹模式自身的知識,然後解讀在Mybatis中怎樣應用了該模式。

1、Builder模式

Builder模式的定義是“將一個複雜對象的構建與它的表示分離,使得同樣的構建過程可以創建不同的表示。”,它屬於創建類模式,一般來說,如果一個對象的構建比較複雜,超出了構造函數所能包含的範圍,就可以使用工廠模式和Builder模式,相對於工廠模式會產出一個完整的產品,Builder應用於更加複雜的對象的構建,甚至只會構建產品的一個部分。

在Mybatis環境的初始化過程中,SqlSessionFactoryBuilder會調用XMLConfigBuilder讀取所有的MybatisMapConfig.xml和所有的*Mapper.xml文件,構建Mybatis運行的核心對象Configuration對象,然後將該Configuration對象作爲參數構建一個SqlSessionFactory對象。

其中XMLConfigBuilder在構建Configuration對象時,也會調用XMLMapperBuilder用於讀取*Mapper文件,而XMLMapperBuilder會使用XMLStatementBuilder來讀取和build所有的SQL語句。

在這個過程中,有一個相似的特點,就是這些Builder會讀取文件或者配置,然後做大量的XpathParser解析、配置或語法的解析、反射生成對象、存入結果緩存等步驟,這麼多的工作都不是一個構造函數所能包括的,因此大量採用了Builder模式來解決。

對於builder的具體類,方法都大都用build*開頭,比如SqlSessionFactoryBuilder爲例,它包含以下方法:

即根據不同的輸入參數來構建SqlSessionFactory這個工廠對象。

2、工廠模式

在Mybatis中比如SqlSessionFactory使用的是工廠模式,該工廠沒有那麼複雜的邏輯,是一個簡單工廠模式。

簡單工廠模式(Simple Factory Pattern):又稱爲靜態工廠方法(Static Factory Method)模式,它屬於類創建型模式。在簡單工廠模式中,可以根據參數的不同返回不同類的實例。簡單工廠模式專門定義一個類來負責創建其他類的實例,被創建的實例通常都具有共同的父類。

SqlSession可以認爲是一個Mybatis工作的核心的接口,通過這個接口可以執行執行SQL語句、獲取Mappers、管理事務。類似於連接MySQL的Connection對象。

可以看到,該Factory的openSession方法重載了很多個,分別支持autoCommit、Executor、Transaction等參數的輸入,來構建核心的SqlSession對象。在DefaultSqlSessionFactory的默認工廠實現裏,有一個方法可以看出工廠怎麼產出一個產品:

這是一個openSession調用的底層方法,該方法先從configuration讀取對應的環境配置,然後初始化TransactionFactory獲得一個Transaction對象,然後通過Transaction獲取一個Executor對象,最後通過configuration、Executor、是否autoCommit三個參數構建了SqlSession。

在這裏其實也可以看到端倪,SqlSession的執行,其實是委託給對應的Executor來進行的。

而對於LogFactory,它的實現代碼:

這裏有個特別的地方,是Log變量的的類型是Constructorextends Log>,也就是說該工廠生產的不只是一個產品,而是具有Log公共接口的一系列產品,比如Log4jImpl、Slf4jImpl等很多具體的Log。

3、單例模式

單例模式(Singleton Pattern):單例模式確保某一個類只有一個實例,而且自行實例化並向整個系統提供這個實例,這個類稱爲單例類,它提供全局訪問的方法。

單例模式的要點有三個:一是某個類只能有一個實例;二是它必須自行創建這個實例;三是它必須自行向整個系統提供這個實例。單例模式是一種對象創建型模式。單例模式又名單件模式或單態模式。

在Mybatis中有兩個地方用到單例模式,ErrorContext和LogFactory,其中ErrorContext是用在每個線程範圍內的單例,用於記錄該線程的執行環境錯誤信息,而LogFactory則是提供給整個Mybatis使用的日誌工廠,用於獲得針對項目配置好的日誌對象。

ErrorContext的單例實現代碼:

構造函數是private修飾,具有一個static的局部instance變量和一個獲取instance變量的方法,在獲取實例的方法中,先判斷是否爲空如果是的話就先創建,然後返回構造好的對象。

只是這裏有個有趣的地方是,LOCAL的靜態實例變量使用了ThreadLocal修飾,也就是說它屬於每個線程各自的數據,而在instance()方法中,先獲取本線程的該實例,如果沒有就創建該線程獨有的ErrorContext。

4、代理模式

代理模式可以認爲是Mybatis的核心使用的模式,正是由於這個模式,我們只需要編寫Mapper.java接口,不需要實現,由Mybatis後臺幫我們完成具體SQL的執行。

代理模式(Proxy Pattern) :給某一個對象提供一個代 理,並由代理對象控制對原對象的引用。代理模式的英 文叫做Proxy或Surrogate,它是一種對象結構型模式。

代理模式包含如下角色:

Subject: 抽象主題角色
Proxy: 代理主題角色
RealSubject: 真實主題角色

這裏有兩個步驟,第一個是提前創建一個Proxy,第二個是使用的時候會自動請求Proxy,然後由Proxy來執行具體事務;

當我們使用Configuration的getMapper方法時,會調用mapperRegistry.getMapper方法,而該方法又會調用mapperProxyFactory.newInstance(sqlSession)來生成一個具體的代理:

在這裏,先通過T newInstance(SqlSession sqlSession)方法會得到一個MapperProxy對象,然後調用T newInstance(MapperProxy mapperProxy)生成代理對象然後返回。

而查看MapperProxy的代碼,可以看到如下內容:

非常典型的,該MapperProxy類實現了InvocationHandler接口,並且實現了該接口的invoke方法。

通過這種方式,我們只需要編寫Mapper.java接口類,當真正執行一個Mapper接口的時候,就會轉發給MapperProxy.invoke方法,而該方法則會調用後續的sqlSession.cud>executor.execute>prepareStatement等一系列方法,完成SQL的執行和返回。

5、組合模式

組合模式組合多個對象形成樹形結構以表示“整體-部分”的結構層次。

組合模式對單個對象(葉子對象)和組合對象(組合對象)具有一致性,它將對象組織到樹結構中,可以用來描述整體與部分的關係。同時它也模糊了簡單元素(葉子對象)和複雜元素(容器對象)的概念,使得客戶能夠像處理簡單元素一樣來處理複雜元素,從而使客戶程序能夠與複雜元素的內部結構解耦。

在使用組合模式中需要注意一點也是組合模式最關鍵的地方:葉子對象和組合對象實現相同的接口。這就是組合模式能夠將葉子節點和對象節點進行一致處理的原因。

Mybatis支持動態SQL的強大功能,比如下面的這個SQL:

在這裏面使用到了trim、if等動態元素,可以根據條件來生成不同情況下的SQL;

在DynamicSqlSource.getBoundSql方法裏,調用了rootSqlNode.apply(context)方法,apply方法是所有的動態節點都實現的接口:

對於實現該SqlSource接口的所有節點,就是整個組合模式樹的各個節點:

組合模式的簡單之處在於,所有的子節點都是同一類節點,可以遞歸的向下執行,比如對於TextSqlNode,因爲它是最底層的葉子節點,所以直接將對應的內容append到SQL語句中:

但是對於IfSqlNode,就需要先做判斷,如果判斷通過,仍然會調用子元素的SqlNode,即contents.apply方法,實現遞歸的解析。

6、模板方法模式

模板方法模式是所有模式中最爲常見的幾個模式之一,是基於繼承的代碼複用的基本技術。

模板方法模式需要開發抽象類和具體子類的設計師之間的協作。一個設計師負責給出一個算法的輪廓和骨架,另一些設計師則負責給出這個算法的各個邏輯步驟。代表這些具體邏輯步驟的方法稱做基本方法(primitive method);而將這些基本方法彙總起來的方法叫做模板方法(template method),這個設計模式的名字就是從此而來。

模板類定義一個操作中的算法的骨架,而將一些步驟延遲到子類中。使得子類可以不改變一個算法的結構即可重定義該算法的某些特定步驟。

在Mybatis中,sqlSession的SQL執行,都是委託給Executor實現的,Executor包含以下結構:

其中的BaseExecutor就採用了模板方法模式,它實現了大部分的SQL執行邏輯,然後把以下幾個方法交給子類定製化完成:

該模板方法類有幾個子類的具體實現,使用了不同的策略:

1、簡單SimpleExecutor:每執行一次update或select,就開啓一個Statement對象,用完立刻關閉Statement對象。(可以是Statement或PrepareStatement對象)

2、重用ReuseExecutor:執行update或select,以sql作爲key查找Statement對象,存在就使用,不存在就創建,用完後,不關閉Statement對象,而是放置於Map 內,供下一次使用。(可以是Statement或PrepareStatement對象)

3、 批量BatchExecutor:執行update(沒有select,JDBC批處理不支持select),將所有sql都添加到批處理中(addBatch()),等待統一執行(executeBatch()),它緩存了多個Statement對象,每個Statement對象都是addBatch()完畢後,等待逐一執行executeBatch()批處理的;BatchExecutor相當於維護了多個桶,每個桶裏都裝了很多屬於自己的SQL,就像蘋果藍裏裝了很多蘋果,番茄藍裏裝了很多番茄,最後,再統一倒進倉庫。(可以是Statement或PrepareStatement對象)

比如在SimpleExecutor中這樣實現update方法:

7、適配器模式

適配器模式(Adapter Pattern) :將一個接口轉換成客戶希望的另一個接口,適配器模式使接口不兼容的那些類可以一起工作,其別名爲包裝器(Wrapper)。適配器模式既可以作爲類結構型模式,也可以作爲對象結構型模式。

在Mybatsi的logging包中,有一個Log接口:

該接口定義了Mybatis直接使用的日誌方法,而Log接口具體由誰來實現呢?Mybatis提供了多種日誌框架的實現,這些實現都匹配這個Log接口所定義的接口方法,最終實現了所有外部日誌框架到Mybatis日誌包的適配:

比如對於Log4jImpl的實現來說,該實現持有了org.apache.log4j.Logger的實例,然後所有的日誌方法,均委託該實例來實現。

8、裝飾者模式

裝飾模式(Decorator Pattern) :動態地給一個對象增加一些額外的職責(Responsibility),就增加對象功能來說,裝飾模式比生成子類實現更爲靈活。其別名也可以稱爲包裝器(Wrapper),與適配器模式的別名相同,但它們適用於不同的場合。根據翻譯的不同,裝飾模式也有人稱之爲“油漆工模式”,它是一種對象結構型模式。

在mybatis中,緩存的功能由根接口Cache(org.apache.ibatis.cache.Cache)定義。整個體系採用裝飾器設計模式,數據存儲和緩存的基本功能由PerpetualCache(org.apache.ibatis.cache.impl.PerpetualCache)永久緩存實現,然後通過一系列的裝飾器來對PerpetualCache永久緩存進行緩存策略等方便的控制。如下圖:

用於裝飾PerpetualCache的標準裝飾器共有8個(全部在org.apache.ibatis.cache.decorators包中):

1、FifoCache:先進先出算法,緩存回收策略

2、LoggingCache:輸出緩存命中的日誌信息

3、LruCache:最近最少使用算法,緩存回收策略

4、ScheduledCache:調度緩存,負責定時清空緩存

5、SerializedCache:緩存序列化和反序列化存儲

6、SoftCache:基於軟引用實現的緩存管理策略

7、SynchronizedCache:同步的緩存裝飾器,用於防止多線程併發訪問

8、WeakCache:基於弱引用實現的緩存管理策略

另外,還有一個特殊的裝飾器TransactionalCache:事務性的緩存

正如大多數持久層框架一樣,mybatis緩存同樣分爲一級緩存和二級緩存

一級緩存,又叫本地緩存,是PerpetualCache類型的永久緩存,保存在執行器中(BaseExecutor),而執行器又在SqlSession(DefaultSqlSession)中,所以一級緩存的生命週期與SqlSession是相同的。

二級緩存,又叫自定義緩存,實現了Cache接口的類都可以作爲二級緩存,所以可配置如encache等的第三方緩存。二級緩存以namespace名稱空間爲其唯一標識,被保存在Configuration核心配置對象中。

二級緩存對象的默認類型爲PerpetualCache,如果配置的緩存是默認類型,則mybatis會根據配置自動追加一系列裝飾器。

Cache對象之間的引用順序爲:

SynchronizedCache–>LoggingCache–>SerializedCache–>ScheduledCache–>LruCache–>PerpetualCache

9、迭代器模式

迭代器(Iterator)模式,又叫做遊標(Cursor)模式。GOF給出的定義爲:提供一種方法訪問一個容器(container)對象中各個元素,而又不需暴露該對象的內部細節。

Java的Iterator就是迭代器模式的接口,只要實現了該接口,就相當於應用了迭代器模式:

比如Mybatis的PropertyTokenizer是property包中的重量級類,該類會被reflection包中其他的類頻繁的引用到。這個類實現了Iterator接口,在使用時經常被用到的是Iterator接口中的hasNext這個函數。

可以看到,這個類傳入一個字符串到構造函數,然後提供了iterator方法對解析後的子串進行遍歷,是一個很常用的方法類。

需要java學習路線圖的私信筆者“java”領取哦!另外喜歡這篇文章的可以給筆者點個贊,關注一下,每天都會分享Java相關文章!還有不定時的福利贈送,包括整理的學習資料,面試題,源碼等~~

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