09、MyBatis - 结果集映射ResultMap

一、什么是结果集映射

这里我们直接看MyBatis官方文档给出的内容:

结果映射

resultMap 元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来,并在一些情形下允许你进行一些 JDBC 不支持的操作。实际上,在为一些比如连接的复杂语句编写映射代码的时候,一份 resultMap 能够代替实现同等功能的数千行代码。ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。

二、为什么需要结果集映射

解决属性名和字段名不一致的问题。

我们来看下面一个例子:

首先我们看数据库表中的列名:

 

然后我们将User.class的password属性改为pwd属性,对应的get、set方法也要改。

下面是其它的配置:

UserMapper接口

package com.jms.dao;

import com.jms.pojo.User;

public interface UserMapper {

    //根据id获取User信息
    User getUserbyid(int id);
}

UserMapper.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">
<!-- 命名空间namespace对应Mapper接口 -->
<mapper namespace="com.jms.dao.UserMapper">
<!-- id对应接口中的方法 -->
    <select id="getUserbyid" parameterType="_int" resultType="User">
        select * from mybaties.user where id=#{id}
    </select>
</mapper>

测试类

package com.jms.dao;

import com.jms.pojo.User;
import com.jms.utils.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;public class UserMapperTest {

    @Test
    public void test() {
        //利用工具类获取SqlSession
        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        //利用SqlSession获取UserMapper接口
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //调用方法
        User user = userMapper.getUserbyid(10001);
        System.out.println(user);

        sqlSession.close();
    }

}

测试结果如下:

 

pwd的返回值是null。

为什么会出现这种问题呢,很明显,这与我们属性名的修改有关。而且经过我的测试,准确的说是与set方法有关。

那么怎么解决这个问题呢?

1、 最简单的就是字段对应;

让数据库的列名与实体类的属性名相同,这也是前面一直做的。

2、 在SQL语句中起别名;

首先我们来看上面的UserMapper.xml中的SQL语句:

select * from mybaties.user where id=#{id}

它的另一种种写法应该是:

select id,username,password from mybaties.user where id=#{id}

我们password起一个别名为pwd:

select id,username,password as pwd from mybaties.user where id=#{id}

现在我们将SQL语句修改为以上这句再来测试:

 

成功得到结果。

3、 第三种方法就是进行结果映射,我们在下面进行详细的介绍;

三、怎样进行结果集映射

我们直接上一段代码:

<?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">
<!-- 命名空间namespace对应Mapper接口 -->
<mapper namespace="com.jms.dao.UserMapper">

<resultMap id="UserMap" type="User">
        <!--column对应数据库表的列名,property对应实体类属性-->
        <result column="id" property="id"/>
        <result column="username" property="username"/>
        <result column="password" property="pwd"/>
    </resultMap>
    <!-- id对应接口中的方法-->
    <select id="getUserbyid" parameterType="_int" resultMap="UserMap">
        select * from mybaties.user where id=#{id}
    </select>
</mapper>

可以看见在SQL语句原来的resultType变成了resultMap,并且多了一个id为UserMap的标签。SQL中的resultMap对应的就是resultMap标签的id,而resultMap标签中的type对应的就是需要映射的实体类,其中的内容则被result标签包括着,column对应数据库表的列名,prooerty对应实体类的属性。

我们进行测试试一下:

 

嗯,问题解决。

问题虽然得到了解决,但是很明显上面我们id和username其实是不需要映射的,那么可不可以不对他们进行映射呢。

我们可以直接去测试,但我们首先抱着问题去看官方给出的文档内容:

之前你已经见过简单映射语句的示例,它们没有显式指定 resultMap。比如:

<select id="selectUsers" resultType="map">
  select id, username, hashedPassword
  from some_table
  where id ={id}
</select>

上述语句只是简单地将所有的列映射到 HashMap 的键上,这由 resultType 属性指定。虽然在大部分情况下都够用,但是 HashMap 并不是一个很好的领域模型。你的程序更可能会使用 JavaBean 或 POJO(Plain Old Java Objects,普通老式 Java 对象)作为领域模型。MyBatis 对两者都提供了支持。

很明显,这就是我们前面用过的一个map的拓展,继续往下看。

package com.someapp.model;
public class User {
  private int id;
  private String username;
  private String hashedPassword;

  public int getId() {
    return id;
  }
  public void setId(int id) {
    this.id = id;
  }
  public String getUsername() {
    return username;
  }
  public void setUsername(String username) {
    this.username = username;
  }
  public String getHashedPassword() {
    return hashedPassword;
  }
  public void setHashedPassword(String hashedPassword) {
    this.hashedPassword = hashedPassword;
  }
}

基于 JavaBean 的规范,上面这个类有 3 个属性:id,username 和 hashedPassword。这些属性会对应到 select 语句中的列名。

这样的一个 JavaBean 可以被映射到 ResultSet,就像映射到 HashMap 一样简单。

<select id="selectUsers" resultType="com.someapp.model.User">
  select id, username, hashedPassword
  from some_table
  where id ={id}
</select>

这就是我们一直在用的javabean了,我们注意到其中一句话,他说没有指定显性的resultMap映射,意思也就是说有着隐性的resultMap映射,那么隐性的映射是怎样的呢,正如上面所说,属性会对应到select语句中的列名。对应不上的时候才需要显性的resultMap映射。

也就是说,resultMap映射其实是本来就存在的,它把列名和属性能对应的已经映射好了,我们只需要在显性映射中写出不能对应的即可。

<?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">
<!-- 命名空间namespace对应Mapper接口 -->
<mapper namespace="com.jms.dao.UserMapper">

    <resultMap id="UserMap" type="User">
        <!--column对应数据库表的列名,property对应实体类属性-->
        <result column="password" property="pwd"/>
    </resultMap>
    <!-- id对应接口中的方法-->
    <select id="getUserbyid" parameterType="_int" resultMap="UserMap">
        select * from mybaties.user where id=#{id}
    </select>
</mapper>

只留下为未对应的,进行测试:

 

测试结果没有问题。

但这只是简单的映射,后面会有更加复杂的情况,那个留在日后再进行深入学习。

在此再借用文档中的一句话进行结尾:

如果这个世界总是这么简单就好了。