【Mybatis从0到1-008】MyBatis之映射文件（输入映射、输出映射）

   在上一章中，介绍了mybatis的配置文件，在本章中，我们将介绍mybatis的映射文件，MyBatis之所以强大，真正原因在于它的映射语句。

   这里主要介绍输入映射和输出映射。

【1】输入映射

   通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型。这里以传递pojo的包装对象为例，还是通过用户表的查询来完成。

需求：完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单的）

操作：

1.定义包装类型。针对上边需求，建议使用自定义的包装类型的pojo。在包装类型的pojo中将复杂的查询条件包装进去。新建UserQUeryVo.java文件（路径：src\main\java\po\UserQueryVo.java），代码如下：

public class UserQueryVo {

    //用户查询条件
    private UserCustom userCustom;

    public UserCustom getUserCustom() {
        return userCustom;
    }

    public void setUserCustom(UserCustom userCustom) {
        this.userCustom = userCustom;
    }
    //可以包装其它的查询条件，订单、商品
    //....
}

在上面代码中，private UserCustom userCustom；表示定义一个用户查询的属性，UserCustom是自定义类，是User的扩展。UserCustom.java文件路径：src\main\java\po\User.java。代码如下：

public class UserCustom extends User {



}

2.修改配置文件UserMapper.xml。在UserMapper.xml中定义用户信息综合查询（查询条件复杂，通过高级查询进行复杂关联查询）。代码：

   <!-- 用户信息综合查询
#{userCustom.sex}:取出pojo包装对象中性别值
${userCustom.username}：取出pojo包装对象中用户名称-->
   <select id="findUserList" parameterType="po.UserQueryVo" resultType="po.UserCustom">
       SELECT *FROM user WHERE user.sex = #{userCustom.sex} AND user.username LIKE '%${userCustom.username}%'
   </select>

      3.在接口文件UserMapper中，加入如下代码：

List<UserCustom> findUserList(UserQueryVo userQueryVo) throws Exception;

4.在之前测试文件中，路径为：src\test\java\mapper\UserMapperTest.java加入如下代码：

  //用户信息的综合 查询
  @Test
  public void testFindUserList() throws Exception {

      SqlSession sqlSession = sqlSessionFactory.openSession();

      //创建UserMapper对象，mybatis自动生成mapper代理对象
      UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

      //创建包装对象，设置查询条件
      UserQueryVo userQueryVo = new UserQueryVo();
      UserCustom userCustom = new UserCustom();

userCustom.setSex("1");
      userCustom.setUsername("小明");
      userQueryVo.setUserCustom(userCustom);
      //调用userMapper的方法

      List<UserCustom> list = userMapper.findUserList(userQueryVo);
      System.out.println(list);
  }

5.运行测试文件，显示如下结果集：

【2】输出映射（resultType和resultMap）

resultType：

   使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。
如果查询出来的列名和pojo中的属性名全部不一致，没有创建pojo对象。
只要查询出来的列名和pojo中的属性有一个一致，就会创建pojo对象。

2.1 输出简单类型

Demo：对综合查询的用户信息的列表，进行计算总记录数，通过查询总数和用户综合查询列表可实现分页。

[1]修改映射文件UserMapper.xml

   <!-- 用户信息综合查询总数
parameterType：指定输入类型和findUserList一样
resultType：输出结果类型 -->
   <select id="findUserCount" parameterType="po.UserQueryVo" resultType="int">
       SELECT count(*) FROM USER WHERE user.sex = #{userCustom.sex} AND user.username LIKE '%${userCustom.username}%'
   </select>

[2]修改UserMapper.java接口文件，添加代码：

//用户信息综合查询的记录总数
int findUserCount(UserQueryVo userQueryVo) throws Exception;

[3]测试代码：(结果为：1条记录)

//用户信息查询记录的总数
@Test
public void findUserCount() throws Exception {
    SqlSession sqlSession = sqlSessionFactory.openSession();

    //创建UserMapper对象，mybatis自动生成mapper代理对象
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

    //创建包装对象，设置查询条件
    UserQueryVo userQueryVo = new UserQueryVo();
    UserCustom userCustom = new UserCustom();
    userCustom.setSex("1");
    userCustom.setUsername("张三丰");
    userQueryVo.setUserCustom(userCustom);
    //调用userMapper的方法

    int count = userMapper.findUserCount(userQueryVo);

    System.out.println(count);
}

resultMap：

2.2 输出pojo对象和pojo列表

不管是输出的pojo单个对象还是一个列表（list中包括pojo），在mapper.xml中resultType指定的类型是一样的。
在mapper.java指定的方法返回值类型不一样：

1、输出单个pojo对象，方法返回值是单个对象类型

//根据id查询用户基本信息
User findUserById(int id) throws Exception;

2、输出pojo对象list，方法返回值是List<Pojo>

//根据用户名查用户基本信息
List<User> findUserByName(int id) throws Exception;

生成的动态代理对象中是根据mapper方法的返回值类型确定是调用selectOne(返回单个对象调用)还是selectList （返回集合对象调用 ）。

mybatis中使用resultMap完成高级输出结果映射。

使用方法：

如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。
1、定义resultMap
2、使用resultMap作为statement的输出映射类型

Demo：

SELECT id id_,username username_ FROM USERWHERE id=#{value}，User类中属性名和上边查询列名不一致。

操作流程：

[1]定义reusltMap,在映射文件UserMapper.xml定义。

<!-- 定义resultMap
将SELECT id id_,username username_ FROM USER 和User类中的属性作一个映射关系
type：resultMap最终映射的java对象类型,可以使用别名
id：对resultMap的唯一标识 -->
   <resultMap type="user" id="userResultMap">
       <!-- id表示查询结果集中唯一标识 
       column：查询出来的列名（自定义的）
       property：type指定的pojo类型中的属性名
       最终resultMap对column和property作一个映射关系 （对应关系） -->
       <id column="id_" property="id"/>
       <!-- result：对普通名映射定义
           column：查询出来的列名
           property：type指定的pojo类型中的属性名
           最终resultMap对column和property作一个映射关系 （对应关系）-->
       <result column="username_" property="username"/>
   </resultMap>

[2]使用resultMap作为statement的输出映射类型，修改映射文件UserMapper.xml

<!--根据resultMap进行输出映射
resultMap：指定定义的resultMap的id，如果这个resultMap在其他的mapper文件中，前面需要加上namespace-->
<select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap">
    SELECT id,id_ username username_ FROM user WHERE id=#{value}
</select>

[3]修改接口文件UserMapper.java

//根据id查用户基本信息，使用resultMap输出
User findUserByIdResultMap(int id) throws Exception;

[4]测试结果

【小结】

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。
如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。