MyBatis-基础知识

HelloWorld

<?xml version="1.0" encoding="UTF-8" ?>


    
        
            
            
                
                
                
                
            
        
    
    
        
        
    

<?xml version="1.0" encoding="UTF-8"?>


    
        select *
        from t_employee
        where id = #{id}
    

// 实体类
@Data
public class Employee {
    private Integer id;
    private String empName;
    private Integer gender;
    private String email;
}

// DAO层接口
public interface EmployeeDao {
    public Employee getEmpById(Integer id);
}

// 测试方法
@Test
public void getEmpById() throws IOException {
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
    SqlSession sqlSession = sqlSessionFactory.openSession();
    EmployeeDao mapper = sqlSession.getMapper(EmployeeDao.class);
    Employee emp = mapper.getEmpById(2);
    System.out.println(emp);
}

全局配置文件

properties

如果属性在不只一个地方进行了配置，那么 MyBatis 将按照下面的顺序来加载：

• 在 properties 元素体内指定的属性首先被读取
• 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件，并覆盖已读取的同名属性
• 最后读取作为方法参数传递的属性，并覆盖已读取的同名属性
  因此，通过方法参数传递的属性具有最高优先级，resource/url 属性中指定的配置文件次之，最低优先级的是 properties 属性中指定的属性

settings

typeAliases

类型别名是为常用的类型（JavaBean）起别名，别名默认就是类名，不区分大小写；也可以指定别名。它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余

    




    select * from t_employee where id = #{id}




  

已经为许多常见的 Java 类型内建了相应的类型别名。它们都是大小写不敏感的，需要注意的是由基本类型名称重复导致的特殊处理

typeHandlers

无论是MyBatis在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时， 都会用类型处理器将获取的值以合适的方式转换成Java类型。下表描述了一些默认的类型处理器

你可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型。 具体做法为：实现 org.apache.ibatis.type.TypeHandler 接口， 或继承一个很便利的类org.apache.ibatis.type.BaseTypeHandler， 然后可以选择性地将它映射到一个 JDBC 类型。比如：

plugins

environments

databaseIdProvider

databaseIdProvider用来考虑数据库移植性问题

• name：数据库产商标识
• value：给这个标识起一个好用的名字

    
    
    




    select * from t_employee where id = #{id}

mappers

• url：可以从磁盘或者网络路径引用
• resource：在类路径下找SQL映射文件
• class：直接引用接口的全类名，但需要将XML和DAO接口同目录存放，而且文件名和接口名需一致
• package：批量注册，但需要将XML和DAO接口同目录存放，也可将配置文件放在resource/同包名/下

SQL映射文件

• cache –命名空间的二级缓存配置
• cache-ref – 其他命名空间缓存配置的引用
• resultMap – 自定义结果集映射
• parameterMap – 已废弃！老式风格的参数映射
• sql –抽取可重用语句块
• insert – 映射插入语句
• update – 映射更新语句
• delete – 映射删除语句
• select – 映射查询语句

增删改标签

• 若数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server），则可以设置 useGeneratedKeys=”true”，然后再把 keyProperty 设置到目标属性上
• 而对于不支持自增型主键的数据库（例如 Oracle），则可以使用 selectKey 子元素：selectKey 元素将会首先运行，id 会被设置，然后插入语句会被调用

    insert into t_employee(empname, gender, email) value (#{empName}, #{gender}, #{email});



    
        select max(id) + 1 from t_employee
    
    insert into t_employee(id, empname, gender, email) value (#{id}, #{empName}, #{gender}, #{email});

select标签

参数传递

• 传入单个参数：可以接受基本类型，对象类型，集合类型的值。这种情况MyBatis可直接使用这个参数，不需要经过任何处理
• 传入多个参数：任意多个参数，都会被MyBatis重新包装成一个Map传入。Map的key是param1，param2，0，1…，值就是参数的值
• 传入命名参数：为参数使用@Param起一个名字，MyBatis就会将这些参数封装进map中，key就是我们自己指定的名字
• 传入POJO：当这些参数属于我们业务POJO时，我们直接传递POJO
• 传入Map：我们也可以封装多个参数为map，直接传递

参数处理：参数也可以指定一个特殊的数据类型

• javaType 通常可以从参数对象中来去确定
• 如果 null 被当作值来传递，对于所有可能为空的列，jdbcType 需要被设置（Oracle就需要，MySQL不需要）
• 对于数值类型，还可以设置小数点后保留的位数
• mode 属性允许指定 IN，OUT 或 INOUT 参数。如果参数为 OUT 或 INOUT，参数对象属性的真实值将会被改变，就像在获取输出参数时所期望的那样

#{key}：获取参数的值，预编译到SQL中。安全
${key}：获取参数的值，拼接到SQL中。有SQL注入问题。ORDER BY ${name}

    select * from t_employee where id=#{id}



    select * from t_employee

// 查询单个结果对象的Map结构
Map getEmpReturnMap(Integer id);

// 查询多个结果对象的Map结构
@MapKey("id")
Map getEmpsReturnMap();

@Test
public void testReturnMap() {
    Map map = mapper.getEmpReturnMap(1);
    // {empname=zhangsan, gender=1, id=2, login_account=zhangsan, email=zhangsan@qq.com}
    Map maps = mapper.getEmpsReturnMap();
    System.out.println(map);
    System.out.println(maps);
}

resultMap自定义封装规则

自定义结果集:自定义数据库列名和JavaBean属性之间的映射规则

association或者collection标签的fetchType=eager/lazy可以覆盖全局的延迟加载策略，指定立即加载（eager）或者延迟加载（lazy）

    
    
    
    
    



    select * from cat where id = #{id}

    
    
    
    


    select k.id,k.key_name keyname,k.lockid,l.id lid,l.lock_name
    from `key` k left join `lock` l on k.lockid=l.id
    where k.id=#{id}

    
    
    
        
    
    


    select k.id,k.key_name keyname,k.lockid,l.id lid,l.lock_name
    from `key` k left join `lock` l on k.lockid=l.id
    where k.id=#{id}

动态SQL

• where
• if
• choose(when,otherwise)
• trim(where,set)
• foreach
• bind
• include

缓存

MyBatis系统中默认定义了两级缓存:一级缓存和二级缓存

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

一级缓存

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

同一次会话期间只要查询过的数据都会保存在当前SqlSession的一个Map中

一级缓存失效情况

• 不同的SqlSession对应不同的一级缓存
• 同一个SqlSession但是查询条件不同
• 同一个SqlSession两次查询期间执行了任何一次增删改操作
• 同一个SqlSession两次查询期间手动清空了缓存

二级缓存

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

使用步骤

1. 全局配置文件中开启二级缓存
2. 需要使用二级缓存的映射文件处使用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

第三方缓存整合

EhCache 是一个纯Java的进程内缓存框架，具有快速、精干等特点，是Hibernate中默认的CacheProvider

使用步骤：

• 导入ehcache包，以及整合包，日志包
  • ehcache-core-2.6.8.jar、mybatis-ehcache-1.0.3.jar
  • slf4j-api-1.6.1.jar、slf4j-log4j12-1.6.2.jar
• 编写ehcache.xml配置文件
• 配置cache标签
• 参照缓存：若想在命名空间中共享相同的缓存配置和实例。可以使用 cache-ref 元素来引用另外一个缓存