快捷導(dǎo)航

詳解Java的MyBatis框架中的緩存與緩存的使用改進(jìn)

更新時(shí)間：2016年06月01日 18:42:10 作者：亦山

很多人在使用MyBatis的緩存后經(jīng)常會(huì)遇到MySQL分頁(yè)查詢的顯示問題,針對(duì)于此,這里我們就來詳解Java的MyBatis框架中的緩存與緩存的使用改進(jìn),首先來回顧一下MyBatis的緩存機(jī)制與執(zhí)行:

一級(jí)緩存與二級(jí)緩存
MyBatis將數(shù)據(jù)緩存設(shè)計(jì)成兩級(jí)結(jié)構(gòu)，分為一級(jí)緩存、二級(jí)緩存：
一級(jí)緩存是Session會(huì)話級(jí)別的緩存，位于表示一次數(shù)據(jù)庫(kù)會(huì)話的SqlSession對(duì)象之中，又被稱之為本地緩存。一級(jí)緩存是MyBatis內(nèi)部實(shí)現(xiàn)的一個(gè)特性，用戶不能配置，默認(rèn)情況下自動(dòng)支持的緩存，用戶沒有定制它的權(quán)利（不過這也不是絕對(duì)的，可以通過開發(fā)插件對(duì)它進(jìn)行修改）；
二級(jí)緩存是Application應(yīng)用級(jí)別的緩存，它的是生命周期很長(zhǎng)，跟Application的聲明周期一樣，也就是說它的作用范圍是整個(gè)Application應(yīng)用。
MyBatis中一級(jí)緩存和二級(jí)緩存的組織如下圖所示：

201661182830144.jpg (824×776)

一級(jí)緩存的工作機(jī)制：
一級(jí)緩存是Session會(huì)話級(jí)別的，一般而言，一個(gè)SqlSession對(duì)象會(huì)使用一個(gè)Executor對(duì)象來完成會(huì)話操作，Executor對(duì)象會(huì)維護(hù)一個(gè)Cache緩存，以提高查詢性能。
二級(jí)緩存的工作機(jī)制：
如上所言，一個(gè)SqlSession對(duì)象會(huì)使用一個(gè)Executor對(duì)象來完成會(huì)話操作，MyBatis的二級(jí)緩存機(jī)制的關(guān)鍵就是對(duì)這個(gè)Executor對(duì)象做文章。如果用戶配置了"cacheEnabled=true"，那么MyBatis在為SqlSession對(duì)象創(chuàng)建Executor對(duì)象時(shí)，會(huì)對(duì)Executor對(duì)象加上一個(gè)裝飾者：CachingExecutor，這時(shí)SqlSession使用CachingExecutor對(duì)象來完成操作請(qǐng)求。CachingExecutor對(duì)于查詢請(qǐng)求，會(huì)先判斷該查詢請(qǐng)求在Application級(jí)別的二級(jí)緩存中是否有緩存結(jié)果，如果有查詢結(jié)果，則直接返回緩存結(jié)果；如果緩存中沒有，再交給真正的Executor對(duì)象來完成查詢操作，之后CachingExecutor會(huì)將真正Executor返回的查詢結(jié)果放置到緩存中，然后在返回給用戶。
MyBatis的二級(jí)緩存設(shè)計(jì)得比較靈活，你可以使用MyBatis自己定義的二級(jí)緩存實(shí)現(xiàn)；你也可以通過實(shí)現(xiàn)org.apache.ibatis.cache.Cache接口自定義緩存；也可以使用第三方內(nèi)存緩存庫(kù)，如Memcached等。

201661182937460.jpg (755×407)

201661182952328.jpg (544×421)

緩存的改造
問題：
最容易出現(xiàn)的問題是開啟cache后，分頁(yè)查詢時(shí)無論查詢哪一頁(yè)都返回第一頁(yè)的數(shù)據(jù)。另外，使用sql自動(dòng)生成插件生成get方法的sql時(shí)，傳入的參數(shù)不起作用，無論傳入的參數(shù)是多少，都返回第一個(gè)參數(shù)的查詢結(jié)果。

為什么出現(xiàn)這些問題：
在之前講解Mybatis的執(zhí)行流程的時(shí)候提到，在開啟cache的前提下，Mybatis的executor會(huì)先從緩存里讀取數(shù)據(jù)，讀取不到才去數(shù)據(jù)庫(kù)查詢。問題就出在這里，sql自動(dòng)生成插件和分頁(yè)插件執(zhí)行的時(shí)機(jī)是在statementhandler里，而statementhandler是在executor之后執(zhí)行的，無論sql自動(dòng)生成插件和分頁(yè)插件都是通過改寫sql來實(shí)現(xiàn)的，executor在生成讀取cache的key（key由sql以及對(duì)應(yīng)的參數(shù)值構(gòu)成）時(shí)使用都是原始的sql，這樣當(dāng)然就出問題了。

解決問題：
找到問題的原因后，解決起來就方便了。只要通過攔截器改寫executor里生成key的方法，在生成可以時(shí)使用自動(dòng)生成的sql（對(duì)應(yīng)sql自動(dòng)生成插件）或加入分頁(yè)信息（對(duì)應(yīng)分頁(yè)插件）就可以了。

攔截器簽名：

@Intercepts({@Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})}) 
public class CacheInterceptor implements Interceptor { 
... 
}

從簽名里可以看出，要攔截的目標(biāo)類型是Executor（注意：type只能配置成接口類型），攔截的方法是名稱為query的方法。

intercept的實(shí)現(xiàn)：

public Object intercept(Invocation invocation) throws Throwable { 
    Executor executorProxy = (Executor) invocation.getTarget(); 
    MetaObject metaExecutor = MetaObject.forObject(executorProxy, DEFAULT_OBJECT_FACTORY, DEFAULT_OBJECT_WRAPPER_FACTORY); 
    // 分離代理對(duì)象鏈 
    while (metaExecutor.hasGetter("h")) { 
      Object object = metaExecutor.getValue("h"); 
      metaExecutor = MetaObject.forObject(object, DEFAULT_OBJECT_FACTORY, DEFAULT_OBJECT_WRAPPER_FACTORY); 
    } 
    // 分離最后一個(gè)代理對(duì)象的目標(biāo)類 
    while (metaExecutor.hasGetter("target")) { 
      Object object = metaExecutor.getValue("target"); 
      metaExecutor = MetaObject.forObject(object, DEFAULT_OBJECT_FACTORY, DEFAULT_OBJECT_WRAPPER_FACTORY); 
    } 
    Object[] args = invocation.getArgs(); 
    return this.query(metaExecutor, args); 
  } 
 
  public <E> List<E> query(MetaObject metaExecutor, Object[] args) throws SQLException { 
    MappedStatement ms = (MappedStatement) args[0]; 
    Object parameterObject = args[1]; 
    RowBounds rowBounds = (RowBounds) args[2]; 
    ResultHandler resultHandler = (ResultHandler) args[3]; 
    BoundSql boundSql = ms.getBoundSql(parameterObject); 
    // 改寫key的生成 
    CacheKey cacheKey = createCacheKey(ms, parameterObject, rowBounds, boundSql); 
    Executor executor = (Executor) metaExecutor.getOriginalObject(); 
    return executor.query(ms, parameterObject, rowBounds, resultHandler, cacheKey, boundSql); 
  } 
 
  private CacheKey createCacheKey(MappedStatement ms, Object parameterObject, RowBounds rowBounds, BoundSql boundSql) { 
    Configuration configuration = ms.getConfiguration(); 
    pageSqlId = configuration.getVariables().getProperty("pageSqlId"); 
    if (null == pageSqlId || "".equals(pageSqlId)) { 
      logger.warn("Property pageSqlId is not setted,use default '.*Page$' "); 
      pageSqlId = defaultPageSqlId; 
    } 
    CacheKey cacheKey = new CacheKey(); 
    cacheKey.update(ms.getId()); 
    cacheKey.update(rowBounds.getOffset()); 
    cacheKey.update(rowBounds.getLimit()); 
    List<ParameterMapping> parameterMappings = boundSql.getParameterMappings(); 
    // 解決自動(dòng)生成SQL，SQL語(yǔ)句為空導(dǎo)致key生成錯(cuò)誤的bug 
    if (null == boundSql.getSql() || "".equals(boundSql.getSql())) { 
      String id = ms.getId(); 
      id = id.substring(id.lastIndexOf(".") + 1); 
      String newSql = null; 
      try { 
        if ("select".equals(id)) { 
          newSql = SqlBuilder.buildSelectSql(parameterObject); 
        } 
        SqlSource sqlSource = buildSqlSource(configuration, newSql, parameterObject.getClass()); 
        parameterMappings = sqlSource.getBoundSql(parameterObject).getParameterMappings(); 
        cacheKey.update(newSql); 
      } catch (Exception e) { 
        logger.error("Update cacheKey error.", e); 
      } 
    } else { 
      cacheKey.update(boundSql.getSql()); 
    } 
 
    MetaObject metaObject = MetaObject.forObject(parameterObject, DEFAULT_OBJECT_FACTORY, DEFAULT_OBJECT_WRAPPER_FACTORY); 
 
    if (parameterMappings.size() > 0 && parameterObject != null) { 
      TypeHandlerRegistry typeHandlerRegistry = ms.getConfiguration().getTypeHandlerRegistry(); 
      if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) { 
        cacheKey.update(parameterObject); 
      } else { 
        for (ParameterMapping parameterMapping : parameterMappings) { 
          String propertyName = parameterMapping.getProperty(); 
          if (metaObject.hasGetter(propertyName)) { 
            cacheKey.update(metaObject.getValue(propertyName)); 
          } else if (boundSql.hasAdditionalParameter(propertyName)) { 
            cacheKey.update(boundSql.getAdditionalParameter(propertyName)); 
          } 
        } 
      } 
    } 
    // 當(dāng)需要分頁(yè)查詢時(shí)，將page參數(shù)里的當(dāng)前頁(yè)和每頁(yè)數(shù)加到cachekey里 
    if (ms.getId().matches(pageSqlId) && metaObject.hasGetter("page")) { 
      PageParameter page = (PageParameter) metaObject.getValue("page"); 
      if (null != page) { 
        cacheKey.update(page.getCurrentPage()); 
        cacheKey.update(page.getPageSize()); 
      } 
    } 
    return cacheKey; 
}

plugin的實(shí)現(xiàn)：

public Object plugin(Object target) { 
  // 當(dāng)目標(biāo)類是CachingExecutor類型時(shí)，才包裝目標(biāo)類，否者直接返回目標(biāo)本身,減少目標(biāo)被代理的 
  // 次數(shù) 
  if (target instanceof CachingExecutor) { 
    return Plugin.wrap(target, this); 
  } else { 
    return target; 
  } 
}

您可能感興趣的文章: