映射器是MyBatis最强大的工具，也是我们使用MyBatis时用得最多的工具，因此熟练掌握它十分必要。
1.映射器的主要元素
- 1.cache
给定命名空间的缓存配置
- 2.cache-ref
其他命名空间缓存配置的引用
- 3.resultMap
用来描述从数据库结果集中来加载对象，也是最复杂最强大的
- 4.sql
可被其他语句引用的可重用语句块
- 5.增删改查
insert\delete\update\select
6.parameterMap（参数映射关系）
2.select元素
select元素帮助我们从数据库中读出数据，把结果集组装成我们需要的pojo对象。
2.1 select元素的配置属性
- 1.id（必填）
命名空间的唯一标识，可以在通过此id来引用它。并且与mapper的namespace进行组合成包中唯一的标识，提供给MyBatis调用，如果不唯一，则会报错。
-
2.parameterMap（废弃）
- 3.parameterType（可选）
传入SQL语句的参数类型。可以是类型的完全限定名，也可以是自定义的typeAliases别名。
- 4.resultType
定义类的全路径，在允许自动匹配的情况下，结果集将通过JavaBean的规范映射。也可以使用别名。但是不能与resultMap一起使用。
- 5.resultMap
它是映射集的引用，将执行强大的映射功能，我们可以使用resultType或者resultMap其中的一个。但是通过resultMap我们可以自定义映射规范。
- 6.flushCache
boolean属性，默认值为false。它的作用是在调用SQL后，要求MyBatis清空之前查询的本地缓存和二级缓存。
- 7.useCache
boolean属性，默认值为true。启动二级缓存的开关，要求MyBatis将此次结果缓存。
- 8.timeout
设置超时时间，等超时的时候将抛出异常。单位为秒。
- 9.fetchSize
获取记录总条数设定
- 10.statementType
枚举属性，三个枚举值：statement、preparedstatement、callablestatement。默认值为preparedstatement。告诉MyBatis使用哪个JDBC的statement工作。
- 11.resultSetType
这是对JDBC的resultSet接口而言。两个属性：Forward_only(游标允许向前访问)、Scroll_sensitive(双向滚动，但是不及时更新，就是如果数据库里的数据修改过，并不在resultSet总反应出来)、Scroll_insensitive(双向滚动，及时跟踪数据库的更新，以便更新resultSet数据)
- 12.databseId
设置数据库厂商的标识。
- 13.resultOrdered
boolean属性，默认值为false。这个设置仅仅适用嵌套结果集select语句。
- 14.resultSets（很少使用）
适合于多个结果集的情况，它将列出执行SQL后每个结果集的名称，每个名称之间用逗号分隔。
2.2 小例子
- 1.创建表
CREATE TABLE `user` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`name` varchar(45) DEFAULT NULL,
`age` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
- 2.创建POJO
public class User {
private int id;
private String name;
private int age;
//省略getter、setter
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", age=" + age +
'}';
}
}
- 3.定义Dao接口定义
package dao;
import model.User;
public interface IUserDao {
/**
* 通过主键查询用户
* @param id
* @return
*/
User getUserById(int id);
}
- 4.定义User对应的Mapper文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<select id="getUserById" parameterType="int" resultType="model.User">
select * from user where id=#{id};
</select>
</mapper>
这个语句被称作getUserById，接受一个int或者Integer类型参数。返回model.User类型对象。
2.3 自动映射POJO属性
从上面的小例子，可以看到，我们数据库定义的列名与POJO的属性名称是一样的。那么，MyBatis会帮助我们自动将数据库的列名与POJO属性映射起来。（PS:因为MyBatis.xml里面的setting属性里面的autoMappingBehavior的默认值是Partial）
2.4 传递多个参数方式
上面的例子，我们的查询的参数只有一个，我们可以在select标签内定义查询参数类型。但是如果超过2个以及2个以上，就需要换种方式处理。
- 1.使用注解方式传参
使用MyBatis的参数注解@Param(org.apache.ibatis.annotations.Param)来实现。使用此方式的好处就是无需在mapper的select标签内定义请求参数的类型。
public interface IUserDao {
/**
* 通过主键查询用户
* @param id
* @return
*/
User getUserById(@Param("id") int id);
}
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<select id="getUserById" resultType="model.User">
select * from user where id=#{id};
</select>
</mapper>
缺点：如果参数超过5个，甚至以上。这时候，就显的比较麻烦，就可以换成JavaBean传递参数
- 2.使用JavaBean传递参数
MyBatis允许组织一个JavaBean，通过简单的setter和getter方法设置参数，这样就可以提高的代码的可读性。
以重写上面的例子。请求参数还是User类型
public interface IUserDao {
/**
* 通过主键查询用户
* @param user
* @return
*/
User getUserById(User user);
}
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<select id="getUserById" parameterType="model.User" resultType="model.User">
select * from user where id=#{id};
</select>
</mapper>
2.5 resultMap映射结果集
有些时候，我们通过resultType不能完全处理一些复杂的映射属性。这时候就需要手动设置映射关系。那么就通过resultMap设置。
注意：resultType与resultMap不能一起使用。
只需要修改mapper.xml的代码
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<resultMap id="userResultMap" type="model.User">
<id property="id" column="id"></id>
<result property="name" column="name"></result>
<result property="age" column="age"></result>
</resultMap>
<select id="getUserById" parameterType="model.User" resultMap="userResultMap">
select * from user where id=#{id};
</select>
</mapper>
resultMap标签的id，代表定义了唯一一个的resultMap。
resultMap标签的type，代表最终数据库需要映射到哪个POJO上。
id元素，代表的使用哪个属性作为其主键。
result元素，定义普通的列的映射关系。
