05-Mybatis之ResultMap结果集映射

ResultMap结果集映射

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

1. 首先在mave父工程中新建模块：mybatis-study-03子项目，将之前的项目内容拷贝至该项目中；

2. 数据库中的字段名称如下所示：
   

3. 新建一个数据库对应的实体类pojo：并且将实体类中的部分属性设置成与数据库字段名不一致：

package com.kevin.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * @author : kevin ding
 * @date : 2022/1/12 22:42
 * @description : 数据库对应的实体类 字段名部分不一致
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Users {
    private int id;
    private String username;
    private int age;
    private String sex;
    // 设置实体类的字段名字，和数据库中的字段名不一致
    private String pwd;
    private String addr;
}

3. UserMapper接口中的抽象方法：List getAllUsers();

// 获取数据库表中的所有User
List<Users> getAllUsers();

4. 对应Mapper.xml中映射文件：

<!--select 标签中的id值填写需要实现接口中的方法名，resultType为返回值类型-->
<select id="getAllUsers" resultType="Users">
    select * from mybatis01.users;
</select>

5. 测试类：

@Test
public void getAllUsers(){
    // 1. 通过创建的Mybatis工具类中的方法 获取sqlSession
    SqlSession sqlSession = MybatisUtils.getSqlSession();
    // 2. 获取mapper操作对象
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    // 3. 通过mapper调用所要测试的方法
    List<Users> allUsers = mapper.getAllUsers();
    // 对获取的结果进行处理（遍历显示数据）
    for (Users allUser : allUsers) {
        System.out.println(allUser);
    }
    // 4. 关闭sqlSession
    sqlSession.close();

}

6. 测试结果：
   

发现username, pwd,addr的值均为null;

分析：

• select * from mybatis01.users; 可以看做

  select id,name,age, sex, password, address from mybatis01.users;

• Mybatis会根据这些查询的列名(会将列名转化为小写,数据库不区分大小写) , 去对应的实体类中查找相应列名的set方法设值 , 由于找不到setUsername() , setPwd(), setAddr()， 所以username, pwd和addr 的返回值为null ; 【自动映射】

解决方法：

方法1：为列名指定别名，并且别名和java的实体类中属性名一致

<!--select 标签中的id值填写需要实现接口中的方法名，resultType为返回值类型-->
<select id="getAllUsers" resultType="Users">
    select id, name as username, age, sex, password as pwd, address as addr from mybatis01.users;
</select

再次进行测试，即可正确输出数据库中的查询结果！

方法2：使用结果集映射->ResultMap【强烈推荐使用】

在UserMapper.xml中添加：

<resultMap id="UserMap" type="Users">
    <!--id为主键-->
    <id column="id" property="id"/>
    <!--column属性中的值为数据库表中的字段名，property属性值为实体类的属性值-->
    <result column="name" property="username"/>
    <result column="age" property="age"/>
    <result column="sex" property="sex"/>
    <result column="password" property="pwd"/>
    <result column="address" property="addr"/>
</resultMap>

注意：resultMap标签中column值为数据表的字段名，property值为实体类的属性，二者需要一一对应，当二者名字一样时可以不写，不一样时完成通过resultMap完成映射。 id属性值UserMap相当于为对该resultMap起的名字。

在下方sql语句中的resultType属性直接替换程resultMap内容：此时SQL语句无需改变。

<!--select 标签中的id值填写需要实现接口中的方法名，resultType为返回值类型-->
    <select id="getAllUsers" resultMap="UserMap">
        select * from mybatis01.users;
    </select>

进行测试，正确输入查询结果！

自动映射

• resultMap元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来。
• 实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的长达数千行的代码。
• ResultMap 的设计思想是，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了。

你已经见过简单映射语句的示例了，但并没有显式指定 resultMap。比如：

<select id="getAllUsers" resultType="map">
	select * from mybatis01.users;
</select>

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

ResultMap 最优秀的地方在于，虽然你已经对它相当了解了，但是根本就不需要显式地用到他们。

手动映射

1、返回值类型为resultMap

<select id="selectUserById" resultMap="UserMap">
  select * from Mybatis01.users where id = #{id};
</select>

2、编写resultMap，实现手动映射！

<resultMap id="UserMap" type="User">
   <!-- id为主键 -->
   <id column="id" property="id"/>
   <!-- column是数据库表的列名 , property是对应实体类的属性名 -->
   <result column="name" property="username"/>
   <result column="age" property="age"/>
   <result column="sex" property="sex"/>
   <result column="password" property="pwd"/>
   <result column="address" property="addr"/>
</resultMap>

如果世界总是这么简单就好了。但是肯定不是的，数据库中，存在一对多，多对一的情况，之后的学习会使用到一些高级的结果集映射，association，collection。