MyBatis的映射文件
映射文件指导着MyBatis如何进行数据库增删改查,有着非常重要的意义,标签有:
•cache –命名空间的二级缓存配置
•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类型,只不过是负责封装集合类型。
例子:
注意,association或者collection标签的fetchType=eager/lazy可以覆盖全局的延迟加载策略,指定立即加载(eager)或者延迟加载(lazy)。