MyBatis的映射文件

映射文件指导着MyBatis 如何进行数据库增删改查，有着非常重要的 意义，标签有:

• c ache –命名空间的 二级缓存配置

• cache-ref – 其他命名空间缓存配置的引用。

• resultMap – 自定义结果集映射

• parameterMap – 已废弃！老式风格的参数 映射

• sql – 抽取 可重用语句块。

• insert – 映射插入语句

• update – 映射更新语句

• delete – 映射删除语句

• select – 映射查询语句

 

insert、update、delete元素 

 

主键生成方式 

若数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server），则可以设置 useGeneratedKeys=”true”，然后再把 keyProperty 设置到目标属性上。 

 而对于不支持自增型主键的数据库（例如 Oracle），则可以使用 selectKey 子元素：selectKey  元素将会首先运行，id  会被设置，然后插入语句会被调用。

关于selectKey的属性： 

 参数（Parameters）传递（重要）

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

 参数处理（重要） 

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

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

•参数位置支持的属性：

javaType、jdbcType、mode、numericScale、resultMap、typeHandler、jdbcTypeName、expression

 •实际上通常被设置的是：可能为空的列名指定 jdbcType。（与上面所说的内容一致）

•#{key}：获取参数的值，预编译到SQL中。安全。（重要）

•${key}：获取参数的值，拼接到SQL中。有SQL注入问题。ORDER BY ${name}。（重要）

 

select元素 

• Select 元素来定义查询操作。

• Id ：唯一 标识符。

– 用来 引用这条语句，需要和接口的方法名一致

• parameterType ：参数类型 。

– 可以不传，MyBatis会根据TypeHandler自动推断。（基本不写）

• resultType ： 返回值类型 。

– 别名或者全类名，如果返回的是 集合，定义 集合中元素的类型。不能和 resultMap 同时使用

 

自动映射 

•1、全局setting设置

– autoMappingBehavior 默认是 PARTIAL ，开启自动映射的功能。唯一的要求是列名和 javaBean 属性名 一致

– 如果 autoMappingBehavior 设置为 null 则会取消自动 映射

– 数据库字段命名规范， POJO 属性符合驼峰命名法，如 A_COLUMN à aColumn ，我们可以 开启自动驼峰命名规则映射功能 ， mapUnderscoreToCamelCase=true 。

 •2、自定义resultMap，实现高级结果集映射。

 resultMap

• constructor - 类在实例化时 , 用来注入结果到构造方法中

– idArg - ID 参数 ; 标记结果作为 ID 可以帮助提高整体效能

– arg - 注入到构造方法的一个普通结果

• id  – 一个 ID 结果 ; 标记结果作为 ID 可以帮助提高整体效能

• result  – 注入到字段或 JavaBean 属性的普通结果

• association  – 一个复杂的类型关联 ; 许多结果将包成这种类型

– 嵌入结果映射 – 结果映射自身的关联 , 或者参考一个

• collection  – 复杂类型的 集

– 嵌入结果映射 – 结果映射自身的集 , 或者参考一个

• discriminator – 使用结果值来决定使用哪个结果映射

– case – 基于某些值的结果映射

• 嵌入结果映射 – 这种情形结果也映射它本身 , 因此可以包含很多 相同 的元素 , 或者它可以参照一个外部的结果映射。

id & result：id 和 result 映射一个单独列的值到简单数据类型(字符串,整型,双精度浮点数,日期等)的属性或字段。 

 resultMap的association标签

• 复杂对象映射

• POJO 中的属性可能会是一个对象

• 我们可以使用联合查询，并以级联属性的方式封装对象。

•也可以 使用 association 标签定义对象的封装规则。

 

使用级联属性的例子：

 

 使用association标签的例子：

 resultMap的collection标签

这个标签其实与association类型，只不过是负责封装集合类型。注意，要使用到collection的情况，通常都是sql语句会查出多行的，但是这些行中，肯定会有几列是一样的，然后剩下的列就是对应于collection里面的对象属性。而这一样的几列数据只会在javaBean中存储一次，因为只会返回一个javaBean对象。

例子：

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