Mybatis

第二章，SQL映射文件

一，SQL映射的XML文件

• MyBatis 真正的强大在于映射语句，专注于SQL，功能强大，SQL映射的配置却是相当
• 简单SQL映射文件的几个顶级元素(按照定义的顺序)
  • mapper – namespace
  • cache – 配置给定命名空间的缓存
  • cache-ref – 从其他命名空间引用缓存配置
  • resultMap –用来描述数据库结果集和对象的对应关系
  • sql – 可以重用的SQL块，也可以被其他语句引用
  • insert – 映射插入语句
  • update – 映射更新语句
  • delete – 映射删除语句
  • select – 映射查询语句

二，重要元素

2.1，mapper元素

• namespace：命名空间
  • namespace和子元素的id联合保证唯一，区别不同的mapper
  • 绑定DAO接口
    • namespace的命名必须跟某个接口同名
    • 接口中的方法与映射文件中SQL语句id一一对应

2.2，select元素

• select是MyBatis中最常用的元素之一

• select语句有很多属性可以详细配置每一条语句

  • id：命名空间中唯一的标识符；接口中的方法与映射文件中的SQL语句id一一对应
  • parameterType：传入SQL语句的参数类型
    • 基础数据类型：int、String、Date等；只能传入一个，通过#{参数名}即可获取传入的值
    • 复杂数据类型：Java实体类、Map等；通过#{属性名}或者#{map的keyName}即可获取传入值
  • resultType：SQL语句返回值类型的完整类名或别名
  • resultMap ：对外部resultMap的引用
    • 应用场景：数据库字段信息与对象属性不一致；复杂的联合查询，自由控制映射结果
    • resultMap自动映射匹配前提：字段名与属性名一致
    • resultMap的自动映射级别-autoMappingBehavior
      • PARTIAL（默认）：自动匹配所有
  • 其中resultType，resultMap二者不能同时存在，本质上都是Map数据结构

  属性	描述
  id	在命名空间中唯一的标识符，可以被用来引用这条语句
  parameterType	将会传入这条语句的参数类的完全限定名或别名
  resultType	从这条语句中返回的期望类型的类的完全限定名或别名。注意集合情形，那应该是集合可以包含的类型，而不能是集合本身。使用resultType或resultMap，但不能同时使用
  resultMap	命名引用外部的resultMap
  flushCache	将其设置为true，不论语句什么时候被调用，都会导致缓存被清空。默认值：false
  useCache	将其设置为true，将会导致本条语句的结果被缓存。默认值：true
  timeout	这个设置驱动程序等待数据库返回请求结果，并抛出异常时间的最大等待值。默认不设置（驱动自行处理）
  fetchSize	这是暗示驱动程序每次批量返回的结果行数
  statementType	STATEMENT,PREPARED或CALLABLE的一种。让MyBatis选择使用Statement，PreparedStatement或CallableStatement。默认值：PREPARED
  resultSetType	FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE中的一种。默认是不设置（驱动自行处理）

2.3，insert元素

<insert  id="add" parameterType="User" >
 insert into  smbms_user (userCode,userName,userPassword) 
		values ( #{userCode},#{userName},#{userPassword})
</insert>

2.4，update元素

<update id ="modify" parameterType="User">
update smbms_user set userCode = #{userCode},
	         userName = #{userName},
              userPassword = #{userPassword}  where id = #{id}
</update>

2.5，delete元素

<delete id ="deleteUserById" parameterType="int">
	delete from smbms_user where id = #{id}
</delete>

• 注意：insert、update、delete元素均没有resultType属性

三，resultMap

3.1，resultMap属性

• id：resultMap的唯一标识；type：Java实体类

3.2，resultMap子元素

• id：一般对应数据库中该行的主键id，设置此项可提高MyBatis性能
• result：映射到JavaBean的某个“简单类型”属性
• association：映射到JavaBean的某个“复杂类型”属性，比如JavaBean类
  • 复杂的类型关联，一对一
  • 内部嵌套：映射一个嵌套JavaBean属性
  • 属性
    • property：映射数据库列的实体对象的属性；javaType：完整Java类名或者别名；resultMap：引用外部resultMap
  • 子元素
    • id
    • result
      • property：映射数据库列的实体对象的属性
      • column：数据库列名或者别名
• collection：映射到JavaBean的某个“复杂类型”属性，比如集合
  • 复杂类型集合，一对多
  • 内部嵌套：映射一个嵌套结果集到一个列表
  • 属性
    • property：映射数据库列的实体对象的属性；ofType：完整Java类名或者别名(集合所包括的类型)；resultMap：引用外部resultMap
  • 子元素
    • id
    • result
      • property：映射数据库列的实体对象的属性
      • column：数据库列名或者别名

四，缓存

4.1，MyBatis缓存

• 一级缓存
• 二级缓存

4.2，二级缓存的配置

• MyBatis的全局cache配置
• 在Mapper XML文件中设置缓存，默认情况下是没有开启缓存的
• 在Mapper XML文件配置支持cache后，如果需要对个别查询进行调整，可以单独设置cache