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 這個工廠對象。
工廠模式
在 MyBatis 中比如 SqlSessionFactory 使用的是工廠模式,該工廠沒有那麼複雜的邏輯,是一個簡單工廠模式。
簡單工廠模式(Simple Factory Pattern):又稱爲靜態工廠方法(Static Factory Method)模式,它屬於類創建型模式。在簡單工廠模式中,可以根據參數的不同返回不同類的實例。簡單工廠模式專門定義一個類來負責創建其他類的實例,被創建的實例通常都具有共同的父類。
簡單工廠模式
SqlSession 可以認爲是一個 MyBatis 工作的核心的接口,通過這個接口可以執行執行 SQL 語句、獲取 Mappers 、管理事務。類似於連接 MySQL 的 Connection 對象。
可以看到,該 Factory 的 openSession 方法重載了很多個,分別支持 autoCommit 、Executor 、Transaction 等參數的輸入,來構建核心的 SqlSession 對象。在 DefaultSqlSessionFactory 的默認工廠實現裏,有一個方法可以看出工廠怎麼產出一個產品:
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, autoCommit);
return new DefaultSqlSession(configuration, executor);
} 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();
}
}
是一個 openSession 調用的底層方法,該方法先從 configuration 讀取對應的環境配置,然後初始化 TransactionFactory 獲得一個 Transaction 對象,然後通過 Transaction 獲取一個 Executor 對象,最後通過 configuration、Executor、是否 autoCommit 三個參數構建了 SqlSession。SqlSession 的執行,其實是委託給對應的 Executor 來進行的。
而對於LogFactory,它的實現代碼:
public final class LogFactory {
private static Constructor<? extends Log> logConstructor;
private LogFactory() {
// disable construction
}
public static Log getLog(Class<?> aClass) {
return getLog(aClass.getName());
這裏有個特別的地方,Log 變量的的類型是 Constructor<? extendsLog>,也就是說該工廠生產的不只是一個產品,而是具有 Log 公共接口的一系列產品,比如 Log4jImpl、Slf4jImpl 等很多具體的 Log。
單例模式
單例模式(Singleton Pattern):單例模式確保某一個類只有一個實例,而且自行實例化並向整個系統提供這個實例,這個類稱爲單例類,它提供全局訪問的方法。
單例模式的要點有三個:一是某個類只能有一個實例;二是它必須自行創建這個實例;三是它必須自行向整個系統提供這個實例。單例模式是一種對象創建型模式。單例模式又名單件模式或單態模式。
在 MyBatis 中有兩個地方用到單例模式,ErrorContext 和 LogFactory,其中 ErrorContext 是用在每個線程範圍內的單例,用於記錄該線程的執行環境錯誤信息,而 LogFactory 則是提供給整個 MyBatis 使用的日誌工廠,用於獲得針對項目配置好的日誌對象。
ErrorContext 的單例實現代碼:
private static final ThreadLocal<ErrorContext> LOCAL = new ThreadLocal<ErrorContext>();
private ErrorContext stored;
private String resource;
private String activity;
private String object;
private String message;
private String sql;
private Throwable cause;
private ErrorContext() {
}
public static ErrorContext instance() {
ErrorContext context = LOCAL.get();
if (context == null) {
context = new ErrorContext();
LOCAL.set(context);
}
return context;
}
構造函數是 private 修飾,具有一個 static 的局部 instance 變量和一個獲取 instance 變量的方法,在獲取實例的方法中,先判斷是否爲空如果是的話就先創建,然後返回構造好的對象。
需要注意的是是,LOCAL 的靜態實例變量使用了 ThreadLoca l修飾,也就是說它屬於每個線程各自的數據,而在 instance() 方法中,先獲取本線程的該實例,如果沒有就創建該線程獨有的 ErrorContext。
代理模式
代理模式(Proxy Pattern) :給某一個對象提供一個代理,並由代理對象控制對原對象的引用。代理模式的英 文叫做 Proxy 或 Surrogate,它是一種對象結構型模式。代理模式可以認爲是 MyBatis 的核心使用的模式,正是由於這個模式,我們只需要編寫 Mapper.java 接口,不需要實現,由 MyBatis 後臺幫我們完成具體 SQL 的執行。
代理模式包含如下角色:
-
Subject: 抽象主題角色
-
Proxy: 代理主題角色
-
RealSubject: 真實主題角色
這裏有兩個步驟,第一個是提前創建一個Proxy,第二個是使用的時候會自動請求Proxy,然後由Proxy來執行具體事務;
當我們使用 Configuration 的 getMapper 方法時,會調用 mapperRegistry.getMapper 方法,而該方法又會調用 mapperProxyFactory.newInstance(sqlSession) 來生成一個具體的代理:
public class MapperProxyFactory<T> {
private final Class<T> mapperInterface;
private Map<Method, MapperMethod> methodCache = new ConcurrentHashMap<Method, MapperMethod>();
public MapperProxyFactory(Class<T> mapperInterface) {
this.mapperInterface = mapperInterface;
}
public Class<T> getMapperInterface() {
return mapperInterface;
}
public Map<Method, MapperMethod> getMethodCache() {
return methodCache;
}
@SuppressWarnings("unchecked")
protected T newInstance(MapperProxy<T> mapperProxy) {
return (T) Proxy.newProxyInstance(mapperInterface.getClassLoader(), new Class[] { mapperInterface }, mapperProxy);
}
public T newInstance(SqlSession sqlSession) {
final MapperProxy<T> mapperProxy = new MapperProxy<T>(sqlSession, mapperInterface, methodCache);
return newInstance(mapperProxy);
}
}
在這裏,先通過 T newInstance(SqlSession sqlSession) 方法會得到一個 MapperProxy 對象,然後調用 T newInstance(MapperProxy mapperProxy) 生成代理對象然後返回。
而查看 MapperProxy 的代碼,可以看到如下內容:
public class MapperProxy<T> implements InvocationHandler, Serializable {
private static final long serialVersionUID = -6424540398559729838L;
private final SqlSession sqlSession;
private final Class<T> mapperInterface;
private final Map<Method, MapperMethod> methodCache;
public MapperProxy(SqlSession sqlSession, Class<T> mapperInterface, Map<Method, MapperMethod> methodCache) {
this.sqlSession = sqlSession;
this.mapperInterface = mapperInterface;
this.methodCache = methodCache;
}
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
if (Object.class.equals(method.getDeclaringClass())) {
try {
return method.invoke(this, args);
} catch (Throwable t) {
throw ExceptionUtil.unwrapThrowable(t);
}
}
final MapperMethod mapperMethod = cachedMapperMethod(method);
return mapperMethod.execute(sqlSession, args);
}
這是非常典型的,該 MapperProxy 類實現了 InvocationHandler 接口,並且實現了該接口的 invoke 方法。
通過這種方式,我們只需要編寫 Mapper.java 接口類,當真正執行一個 Mapper 接口的時候,就會轉發給 MapperProxy.invoke 方法,而該方法則會調用後續的 sqlSession.cud>executor.execute>prepareStatement 等一系列方法,完成 SQL 的執行和返回。
組合模式
組合模式組合多個對象形成樹形結構以表示“整體-部分”的結構層次。
組合模式對單個對象(葉子對象)和組合對象(組合對象)具有一致性,它將對象組織到樹結構中,可以用來描述整體與部分的關係。同時它也模糊了簡單元素(葉子對象)和複雜元素(容器對象)的概念,使得客戶能夠像處理簡單元素一樣來處理複雜元素,從而使客戶程序能夠與複雜元素的內部結構解耦。
在使用組合模式中需要注意一點也是組合模式最關鍵的地方:葉子對象和組合對象實現相同的接口。這就是組合模式能夠將葉子節點和對象節點進行一致處理的原因。
組合模式
MyBatis 支持動態 SQL 的強大功能,比如下面的這個SQL:
<update id="update" parameterType="org.format.dynamicproxy.mybatis.bean.User">
UPDATE users
<trim prefix="SET" prefixOverrides=",">
<if test="name != null and name != ''">
name = #{name}
</if>
<if test="age != null and age != ''">
, age = #{age}
</if>
<if test="birthday != null and birthday != ''">
, birthday = #{birthday}
</if>
</trim>
where id = ${id}
</update>
在這裏面使用到了 trim、i f等動態元素,可以根據條件來生成不同情況下的 SQL 。
在 DynamicSqlSource.getBoundSql 方法裏,調用了 rootSqlNode.apply(context) 方法,apply 方法是所有的動態節點都實現的接口:
public interface SqlNode {
boolean apply(DynamicContext context);
}
對於實現該 SqlSource 接口的所有節點,就是整個組合模式樹的各個節點:
SqlNode
組合模式的簡單之處在於,所有的子節點都是同一類節點,可以遞歸的向下執行,比如對於 TextSqlNode ,因爲它是最底層的葉子節點,所以直接將對應的內容 append 到 SQL 語句中:
public boolean apply(DynamicContext context) {
GenericTokenParser parser = createParser(new BindingTokenParser(context));
context.appendSql(parser.parse(text));
return true;
}
但是對於 IfSqlNode ,就需要先做判斷,如果判斷通過,仍然會調用子元素的 SqlNode ,即 contents.apply 方法,實現遞歸的解析。
public boolean apply(DynamicContext context) {
if (evaluator.evaluateBoolean(test, context.getBindings())) {
contents.apply(context);
return true;
}
return false;
}
}
模板方法模式
模板方法模式是所有模式中最爲常見的幾個模式之一,是基於繼承的代碼複用的基本技術。
模板方法模式需要開發抽象類和具體子類的設計師之間的協作。一個設計師負責給出一個算法的輪廓和骨架,另一些設計師則負責給出這個算法的各個邏輯步驟。代表這些具體邏輯步驟的方法稱做基本方法(primitive method);而將這些基本方法彙總起來的方法叫做模板方法(template method),這個設計模式的名字就是從此而來。
模板類定義一個操作中的算法的骨架,而將一些步驟延遲到子類中。使得子類可以不改變一個算法的結構即可重定義該算法的某些特定步驟。
模板方法模式
在 MyBatis 中,sqlSession 的 SQL 執行,都是委託給 Executor 實現的,Executor 包含以下結構:
Executor 接口
其中的 BaseExecutor 就採用了模板方法模式,它實現了大部分的 SQL 執行邏輯,然後把以下幾個方法交給子類定製化完成:
public boolean apply(DynamicContext context) {
if (evaluator.evaluateBoolean(test, context.getBindings())) {
contents.apply(context);
return true;
}
return false;
}
}
該模板方法類有幾個子類的具體實現,使用了不同的策略:
- 簡單 SimpleExecutor:每執行一次 update 或 select,就開啓一個 Statement 對象,用完立刻關閉 Statement 對象。(可以是 Statement 或 PrepareStatement 對象)
- 重用 ReuseExecutor:執行 update 或 select,以 sql 作爲 key 查找 Statement 對象,存在就使用,不存在就創建,用完後,不關閉 Statement 對象,而是放置於 Map 內,供下一次使用。(可以是 Statement 或 PrepareStatement 對象)
- 批量 BatchExecutor:執行 update (沒有 select,JDBC 批處理不支持 select ),將所有sql都添加到批處理中(addBatch()),等待統一執行(executeBatch()),它緩存了多個 Statement 對象,每個 Statement 對象都是 addBatch() 完畢後,等待逐一執行 executeBatch() 批處理的;BatchExecutor 相當於維護了多個桶,每個桶裏都裝了很多屬於自己的SQL,就像蘋果藍裏裝了很多蘋果,番茄藍裏裝了很多番茄,最後,再統一倒進倉庫。(可以是 Statement 或 PrepareStatement 對象)
比如在 SimpleExecutor 中這樣實現 update 方法:
public int doUpdate(MappedStatement ms, Object parameter) throws SQLException {
Statement stmt = null;
try {
Configuration configuration = ms.getConfiguration();
StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null);
stmt = prepareStatement(handler, ms.getStatementLog());
return handler.update(stmt);
} finally {
closeStatement(stmt);
}
}
適配器模式
適配器模式(Adapter Pattern)的定義是,將某個類的接口轉換爲接口客戶所需的類型。 換句話說, 適配器模式解決的問題是, 使得原本由於接口不兼容而不能一起工作、不能統一管理的那些類可以在一起工作、可以進行統一管理,其別名爲包裝器(Wrapper)。適配器模式既可以作爲類結構型模式,也可以作爲對象結構型模式。
在 MyBatsi 的 logging 包中,有一個 Log 接口:
public interface Log {
boolean isDebugEnabled();
boolean isTraceEnabled();
void error(String s, Throwable e);
void error(String s);
void debug(String s);
void trace(String s);
void warn(String s);
}
該接口定義了 MyBatis 直接使用的日誌方法,而 Log 接口具體由誰來實現呢?MyBatis 提供了多種日誌框架的實現,這些實現都匹配這個 Log 接口所定義的接口方法,最終實現了所有外部日誌框架到 MyBatis 日誌包的適配:
比如對於 Log4jImpl 的實現來說,該實現持有了 org.apache.log4j.Logger 的實例,然後所有的日誌方法,均委託該實例來實現。
public class Log4jImpl implements Log {
private static final String FQCN = Log4jImpl.class.getName();
private Logger log;
public Log4jImpl(String clazz) {
log = Logger.getLogger(clazz);
}
public boolean isDebugEnabled() {
return log.isDebugEnabled();
}
public boolean isTraceEnabled() {
return log.isTraceEnabled();
}
public void error(String s, Throwable e) {
log.log(FQCN, Level.ERROR, s, e);
}
public void error(String s) {
log.log(FQCN, Level.ERROR, s, null);
}
public void debug(String s) {
log.log(FQCN, Level.DEBUG, s, null);
}
public void trace(String s) {
log.log(FQCN, Level.TRACE, s, null);
}
public void warn(String s) {
log.log(FQCN, Level.WARN, s, null);
}
}
裝飾者模式
裝飾模式(Decorator Pattern) :動態地給一個對象增加一些額外的職責(Responsibility),就增加對象功能來說,裝飾模式比生成子類實現更爲靈活。其別名也可以稱爲包裝器(Wrapper),與適配器模式的別名相同,但它們適用於不同的場合。根據翻譯的不同,裝飾模式也有人稱之爲“油漆工模式”,它是一種對象結構型模式。
裝飾者模式
在 MyBatis 中,緩存的功能由根接口Cache(org.apache.ibatis.cache.Cache)定義。整個體系採用裝飾器設計模式,數據存儲和緩存的基本功能由 PerpetualCache(org.apache.ibatis.cache.impl.PerpetualCache)永久緩存實現,然後通過一系列的裝飾器來對 PerpetualCache 永久緩存進行緩存策略等方便的控制。如下圖:
Cache
用於裝飾 PerpetualCache 的標準裝飾器共有8個(全部在 org.apache.ibatis.cache.decorators 包中):
- FifoCache:先進先出算法,緩存回收策略
- LoggingCache:輸出緩存命中的日誌信息
- LruCache:最近最少使用算法,緩存回收策略
- ScheduledCache:調度緩存,負責定時清空緩存
- SerializedCache:緩存序列化和反序列化存儲
- SoftCache:基於軟引用實現的緩存管理策略
- SynchronizedCache:同步的緩存裝飾器,用於防止多線程併發訪問
- WeakCache:基於弱引用實現的緩存管理策略
另外,還有一個特殊的裝飾器 TransactionalCache:事務性的緩存
正如大多數持久層框架一樣,MyBatis 緩存同樣分爲一級緩存和二級緩存
- 一級緩存,又叫本地緩存,是 PerpetualCache 類型的永久緩存,保存在執行器中(BaseExecutor),而執行器又在 SqlSession(DefaultSqlSession) 中,所以一級緩存的生命週期與 SqlSession 是相同的。
- 二級緩存,又叫自定義緩存,實現了 Cache 接口的類都可以作爲二級緩存,所以可配置如 encache 等的第三方緩存。二級緩存以 namespace 名稱空間爲其唯一標識,被保存在 Configuration 核心配置對象中。
二級緩存對象的默認類型爲 PerpetualCache ,如果配置的緩存是默認類型,則 MyBatis 會根據配置自動追加一系列裝飾器。
Cache對象之間的引用順序爲:
SynchronizedCache–>LoggingCache–>SerializedCache–>ScheduledCache–>LruCache–>PerpetualCache
迭代器模式
迭代器(Iterator)模式,又叫做遊標(Cursor)模式。GOF 給出的定義爲:提供一種方法訪問一個容器(container)對象中各個元素,而又不需暴露該對象的內部細節。
Java 的 Iterator 就是迭代器模式的接口,只要實現了該接口,就相當於應用了迭代器模式:
比如 MyBatis 的 PropertyTokenizer 是 property 包中的重量級類,該類會被 reflection 包中其他的類頻繁的引用到。這個類實現了 Iterator 接口,在使用時經常被用到的是 Iterator 接口中的 hasNext 這個函數。
public class PropertyTokenizer implements Iterable<PropertyTokenizer>, Iterator<PropertyTokenizer> {
private String name;
private String indexedName;
private String index;
private String children;
public PropertyTokenizer(String fullname) {
int delim = fullname.indexOf('.');
if (delim > -1) {
name = fullname.substring(0, delim);
children = fullname.substring(delim + 1);
} else {
name = fullname;
children = null;
}
indexedName = name;
delim = name.indexOf('[');
if (delim > -1) {
index = name.substring(delim + 1, name.length() - 1);
name = name.substring(0, delim);
}
}
public String getName() {
return name;
}
public String getIndex() {
return index;
}
public String getIndexedName() {
return indexedName;
}
public String getChildren() {
return children;
}
public boolean hasNext() {
return children != null;
}
public PropertyTokenizer next() {
return new PropertyTokenizer(children);
}
public void remove() {
throw new UnsupportedOperationException("Remove is not supported, as it has no meaning in the context of properties.");
}
public Iterator<PropertyTokenizer> iterator() {
return this;
}
}
可以看到,這個類傳入一個字符串到構造函數,然後提供了 iterator 方法對解析後的子串進行遍歷,是一個很常用的方法類。