MyBatis - 日志 - 一二级缓存

日志：

a，Log4j（需要log4j.jar）：
b，开启日志；conf.xml

<settings>
<!--开启日志，并指定使用的具体日志-->
<setting name="logImpl" value="LOG4J"/>
</settings>

如果不指定，Mybatis就会根据以下顺序 寻找日志
SLF4J - Apache Commons Logging - Log4j 2 - Log4J - JDK logging

c，编写配置日志输出文件

log4j.properties
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

日志级别：

DEBUG<INFO<WARN<ERROR

如果设置DEBUG，则日志会输出4中类型的信息
如果设置为warn，则只输出WAEN，ERROR的信息

可以通过日志，详细的阅读Mybatis执行情况（观察mybatis实际执行sql语句 以及sql中的参数 和返回结果

缓存

MyBatis 包含一个非常强大的查询缓存特性,它可以非 常方便地配置和定制。缓存可以极大的提升查询效率。
• MyBatis系统中默认定义了两级缓存。

• 一级缓存和二级缓存。
– 1、默认情况下，只有一级缓存（SqlSession级别的缓存， 也称为本地缓存）开启。
– 2、二级缓存需要手动开启和配置，他是基于namespace级 别的缓存。
– 3、为了提高扩展性。MyBatis定义了缓存接口Cache。我们 可以通过实现Cache接口来自定义二级缓存

一级缓存(local cache),

即本地缓存, 作用域默认 为sqlSession。当 Session flush 或 close 后, 该 Session 中的所有 Cache 将被清空。
• 本地缓存不能被关闭, 但可以调用 clearCache() 来清空本地缓存, 或者改变缓存的作用域.
• 在mybatis3.1之后, 可以配置本地缓存的作用域. 在 mybatis.xml 中配置

失效情况

• 同一次会话期间只要查询过的数据都会保存在当 前SqlSession的一个Map中 • key:hashCode+查询的SqlId+编写的sql查询语句+参数

如果用同样的SqlSession对象查询同样的数据，则只会在第一次 查询时 向数据库发送SQL语句，并将查询的结果放入SQLSession中（一级缓存）；

后面访问时，直接从缓存中查询该对象即可（即省略了数据库的访问）

• 一级缓存失效的四种情况
– 1、不同的SqlSession对应不同的一级缓存
– 2、同一个SqlSession但是查询条件不同
– 3、同一个SqlSession两次查询期间执行了任何一次增 删改操作
– 4、同一个SqlSession两次查询期间手动清空了缓存

二级缓存

二级缓存(second level cache)，全局作用域缓存
• 二级缓存默认不开启，需要手动配置
• MyBatis提供二级缓存的接口以及实现，缓存实现要求 POJO实现Serializable接口
• 二级缓存在 SqlSession 关闭或提交之后才会生效

MyBatis自带二级缓存；【同一个namespace】生成的mapper对象
回顾：namespace的值就是接口的全类名（包名。类名），通过接口可以产生代理对象（xxxMaper对象）
–>namespace决定了xxxMapper对象的产生
结论：只要产生的xxxMapper对象 来自同一个namespace，则 这些对象 共享二级缓存
如果多个Mapper。xml的namespace相同，则他们共享二级缓存

• 使用步骤
– 1、全局配置文件中开启二级缓存

<!--开启二级缓存-->
<setting name="cacheEnabled" value="true"/>

• <setting name= "cacheEnabled" value="true"/> 

– 2、需要使用二级缓存的映射文件处使用cache配置缓存

  • <cache />

– 3、注意：POJO需要实现Serializable接口

缓存相关属性
• eviction=“FIFO”：缓存回收策略： 
	• LRU – 最近最少使用的：移除最长时间不被使用的对象。
 	• FIFO – 先进先出：按对象进入缓存的顺序来移除它们。 
 	• SOFT – 软引用：移除基于垃圾回收器状态和软引用规则的对象。 
 	• WEAK – 弱引用：更积极地移除基于垃圾收集器状态和弱引用规则的对象。 
 	• 默认的是 LRU。 
 • flushInterval：刷新间隔，单位毫秒 
 	• 默认情况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新 
 • size：引用数目，正整数 
 	• 代表缓存最多可以存储多少个对象，太大容易导致内存溢出 
 • readOnly：只读，true/false 
 	• true：只读缓存；会给所有调用者返回缓存对象的相同实例。因此这些对象 不能被修改。这提供了很重要的性能优势。 
 	• false：读写缓存；会返回缓存对象的拷贝（通过序列化）。这会慢一些， 但是安全，因此默认是false。
缓存有关设置
• 1、全局setting的cacheEnable： 
	– 配置二级缓存的开关。一级缓存一直是打开的。 
• 2、select标签的useCache属性： 
	– 配置这个select是否使用二级缓存。一级缓存一直是使用的 
• 3、sql标签的flushCache属性： 
	– 增删改默认flushCache=true。sql执行以后，会同时清空一级和二级缓存。 查询默认flushCache=false。 • 4、sqlSession.clearCache()： 
	– 只是用来清除一级缓存。 
• 5、当在某一个作用域 (一级缓存Session/二级缓存 Namespaces) 进行了 C/U/D 操作后，默认该作用域下所 有 select 中的缓存将被clear。

MyBatis是将缓存放入硬盘文件中，即被缓存的类必须实现序列化接口

触发将对象写入二级缓存的时机：SQL Session的close方法被调用

禁用某select的二级缓存：useCache（默认开启）

<!--禁用二级缓存-->
<select id="lazyloadSql1" parameterType="int" resultType="CardInfo" useCache="false">
SELECT * FROM cardinfo WHERE cardid = #{id}
</select>

清理：
a与清理一级缓存一样
执行commit：（执行增删改时 会清理缓存，防止脏数据产生）

b在select添加flushCache标签

<!--清理缓存-->
<select id="lazyloadSql1" parameterType="int" resultType="CardInfo" useCache="false" flushCache="true">
SELECT * FROM cardinfo WHERE cardid = #{id}
</select>

三方提供的二级缓存

EhCache 是一个纯Java的进程内缓存框架，具有快速、精 干等特点，是Hibernate中默认的CacheProvider。
想要整合三方提供的二级缓存（或自定义二级缓存）必须实现org.apache.ibatis.cache

a-整合ehcache二级缓存

Ehcache-core.jar
mybatis-Ehcahce.jar
slf4-api.jar

b-编写ehcache配置文件 Ehcache.xml

<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd"
         updateCheck="false">
    <!--
       diskStore：为缓存路径，ehcache分为内存和磁盘两级，此属性定义磁盘的缓存位置。参数解释如下：
       user.home – 用户主目录
       user.dir  – 用户当前工作目录
       java.io.tmpdir – 默认临时文件路径
     -->
    <diskStore path="java.io.tmpdir/Tmp_EhCache"/>
    <!--
       defaultCache：默认缓存策略，当ehcache找不到定义的缓存时，则使用这个缓存策略。只能定义一个。
     -->
    <!--
      name:缓存名称。
      maxElementsInMemory:缓存最大数目
      maxElementsOnDisk：硬盘最大缓存个数。
      eternal:对象是否永久有效，一但设置了，timeout将不起作用。
      overflowToDisk:是否保存到磁盘，当系统当机时
      timeToIdleSeconds:设置对象在失效前的允许闲置时间（单位：秒）。仅当eternal=false对象不是永久有效时使用，可选属性，默认值是0，也就是可闲置时间无穷大。
      timeToLiveSeconds:设置对象在失效前允许存活时间（单位：秒）。最大时间介于创建时间和失效时间之间。仅当eternal=false对象不是永久有效时使用，默认是0.，也就是对象存活时间无穷大。
      diskPersistent：是否缓存虚拟机重启期数据 Whether the disk store persists between restarts of the Virtual Machine. The default value is false.
      diskSpoolBufferSizeMB：这个参数设置DiskStore（磁盘缓存）的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区。
      diskExpiryThreadIntervalSeconds：磁盘失效线程运行时间间隔，默认是120秒。
      memoryStoreEvictionPolicy：当达到maxElementsInMemory限制时，Ehcache将会根据指定的策略去清理内存。默认策略是LRU（最近最少使用）。你可以设置为FIFO（先进先出）或是LFU（较少使用）。
      clearOnFlush：内存数量最大时是否清除。
      memoryStoreEvictionPolicy:可选策略有：LRU（最近最少使用，默认策略）、FIFO（先进先出）、LFU（最少访问次数）。
      FIFO，first in first out，这个是大家最熟的，先进先出。
      LFU， Less Frequently Used，就是上面例子中使用的策略，直白一点就是讲一直以来最少被使用的。如上面所讲，缓存的元素有一个hit属性，hit值最小的将会被清出缓存。
      LRU，Least Recently Used，最近最少使用的，缓存的元素有一个时间戳，当缓存容量满了，而又需要腾出地方来缓存新的元素的时候，那么现有缓存元素中时间戳离当前时间最远的元素将被清出缓存。
   -->
    <defaultCache
            eternal="false"
            maxElementsInMemory="10000"
            overflowToDisk="false"
            diskPersistent="false"
            timeToIdleSeconds="1800"
            timeToLiveSeconds="259200"
            memoryStoreEvictionPolicy="LRU"/>

    <cache
            name="cloud_user"
            eternal="false"
            maxElementsInMemory="5000"
            overflowToDisk="false"
            diskPersistent="false"
            timeToIdleSeconds="1800"
            timeToLiveSeconds="1800"
            memoryStoreEvictionPolicy="LRU"/>

</ehcache>

c-在mapper中声明

<!--开启二级缓存-->
<cache ty	pe="org.mybatis.caches.ehcache.EhcacheCache">
<property name="" value=""/>
</cache>

可为mapper文件单独配置属性（覆盖全局属性）