Mybatis框架学习(2)--结果集映射ResultMap

说明：本文档所需要解决的问题是：

1、实体类属性名和数据库表中字段名不一致的情形（一对一）；

2、数据库实体间的一对多和多对一的情形。

一、数据库实体间一对一关系

1、环境搭建--参考Mybatis框架学习（1）

• 搭建实验所需的数据库和表
• 在pom.xml文件中导入Mybatis的相关依赖
  • mybatis、mysql-connector-java（java连接MySql所需要的驱动）
• 编写Mybatis的核心配置文件--参考Mybatis的官方文档
  • environments
  • typeAliases
  • setting
  • properties
  • mappers
  • ...
• 编写Mybatis工具类
• 实体类以及操作数据库的Mapper接口--实体类中属性名称与数据库表中的字段名称不相同
• Mapper.xml配置文件的编写

2、单表查询详情

1、数据库中表中的字段名如下图所示：

 2、java实体类的设计--实体类的属性与表中的字段名称不一致

public class Books {

    private Integer id;
    private String name;
    private Integer counts;
    private String detail;

    public Books() {
    }

    public Books(Integer id, String name, Integer counts, String detail) {
        this.id = id;
        this.name = name;
        this.counts = counts;
        this.detail = detail;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getCounts() {
        return counts;
    }

    public void setCounts(Integer counts) {
        this.counts = counts;
    }

    public String getDetail() {
        return detail;
    }

    public void setDetail(String detail) {
        this.detail = detail;
    }

    @Override
    public String toString() {
        return "Books{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", counts=" + counts +
                ", detail='" + detail + '\'' +
                '}';
    }
}

3、Mapper接口

 public Books findBookByID(int id); 

4、Mapper映射文件--未添加结果集映射

<select id="findBookByID" resultMap="Books" parameterType="int">
        select * from books where bookID = #{id}
</select>

①由于实体类的属性与表中的字段名称不一致，因此查询出的书籍id、name以及counts将为空；

②分析：

[1]select * from books where bookID = #{id}可以看做是 select bookID,bookName,bookCounts,detail where bookID = #{id};

[2]Mybatis会根据查询语句中的列名(数据库不区分大小写)，去对应的实体类中找相应列名的set方法对属性进行设值，由于找不到setBookID,setBookName,setBookCounts，所以id、name以及counts的返回值将为空。

5、解决方案

方案一：

通过4中的结果分析知，可以采用表中的列名起别名的方式：别名和java实体类中的属性名称一致即可；

例如在本实例中，仅需将mapper映射文件中查询语句修改为

<select id="findBookByID" resultType="Books" parameterType="int">
         select bookId id,bookName name,bookCounts counts,detail from books where bookID = #{id}
</select>

方案二：【推荐使用】

使用结果集映射--resultMap，此时mapper映射文件的内容为： 

<!--由于实体类的属性名和数据库表中的字段名不一致，需要使用resultMap标签进行-->
    <resultMap id="BookMap" type="Books">
        <result property="id" column="bookID"></result>
        <result property="name" column="bookName"></result>
        <result property="counts" column="bookCounts"></result>
    </resultMap>

    <select id="findBookByID" resultMap="BookMap" parameterType="int">
        select * from books where bookID = #{id}
    </select> 

【说明】

①column对应数据库表中的列名，property对应实体类中的属性名；

②与原始映射文件相比，select标签中的resultType变为resultMap。

 

数据库实体之间除了简单的一对一关系外，还存在一对多或多对一的情形，此时我们需要使用一些高级的结果集映射来实现相应的查询功能。

二、数据库实体间一对多（/多对一）关系

1、多对一的处理

1、关于”多对一“的理解（以老师、学生之间的关系为例说明） 

• 多个学生 vs 一个老师
• 如果从学生的角度出发，就是一个多对一的现象，即多个学生关联一个老师

2、数据库设计

-- 老师表
CREATE TABLE teacher(
    id INT(10) PRIMARY KEY AUTO_INCREMENT,
    NAME VARCHAR(30) DEFAULT NULL
);

INSERT INTO teacher VALUES(1,'江老师');

-- 学生表
CREATE TABLE student(
    id INT(10) PRIMARY KEY AUTO_INCREMENT,
    NAME VARCHAR(30) DEFAULT NULL,
    tid INT(10),
    CONSTRAINT fk_student_teacher FOREIGN KEY(tid) REFERENCES teacher(id)
);

INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('1', '小明', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('2', '小红', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('3', '小张', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('4', '小李', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('5', '小王', '1');

 3、环境搭建

• 在pom.xml文件中mybatis的相关依赖和lombok
• 编写mybatis的核心配置文件
• 编写mybatis工具类
• 编写实体类及对应的Mapper接口

【实体类】由于是从学生的角度看问题，此时Teacher可以看做Student类的一个属性

import lombok.Data;
@Data
public class Student {
    private int id;
    private String name;

    private Teacher teacher;
}

import lombok.Data;
@Data
public class Teacher {
    private int id;
    private String name;
}

【Mapper接口】

public interface StudentMapper {
    public List<Student> selectAll();
}

• 编写mapper接口对应的mapper.xml配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.yif.mapper.StudentMapper">

</mapper>

4、要求：查询所有学生及对应老师的信息

方案一：按查询嵌套处理

需求：获取所有学生及对应老师的信息
分析：
    1、获取所有学生的信息；
    2、根据获取的学生信息的老师id-->获取老师的信息
         2.1、做一个结果集映射：resultType=studentTeacher
         2.2、studentTeacher结果集的类型为Student
         2.3、在实体类Student中，老师的属性为teacher，对应数据库中的字段为tid
         2.4、使用association来处理多对一的复杂关联

<select id="selectAll" resultMap="StudentTeacher">
        select * from student
 </select>

<resultMap id="StudentTeacher" type="Student">
        <result property="id" column="id"></result>
        <result property="name" column="name"></result>
        <!--association关联属性  property属性名称 javaType属性类型 column在多的一方的表中的列名-->
        <association property="teacher" column="tid" javaType="Teacher" select="selectByID"></association>
</resultMap>


<select id="selectByID" resultType="Teacher">
        select * from teacher where id = #{tid}
</select>

【说明】

①当传递过来的id(即association中的column)只有一个属性的时候，此时查询teacher表中信息的#{id}可以任意写；

②当association中column有多个参数配置时：column="{k1= v1,k2=v2}"，此时k就是传给下个sql（查询teacher表）取值的名称，v是student表中的字段名。

例如：

...
<association ptoperty="teacher" column="{id=tid,name=tname}" javaType="Teachenr" select="getTeacher">
...

<select id="getTeacher" resultType="Teacher">
        select * from teacher where id = #{id},name=#{name}
</select>

【测试以及查询结果】

public void test1(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);
        List<Student> studentList = studentMapper.selectAll();
        for (Student student : studentList) {
            System.out.println(student);
        }
        sqlSession.close();
}

 

 方案二：按结果嵌套处理【推荐使用】

思路：直接使用sql语句查询出结果，然后进行结果集的映射

此时mapper.xml配置的如下：

<!--使用结果集嵌套完成多表查询-->
    <select id="selectAll" resultMap="StudentTeacher">
        select s.id sid, s.name sname, t.name tname
        from student s, teacher t
        where s.tid = t.id
    </select>

    <resultMap id="StudentTeacher" type="Student">
        <result property="id" column="sid"></result>    
        <result property="name" column="sname"></result>
        <association property="teacher" javaType="Teacher">
            <result property="name" column="tname"></result>
        </association>
    </resultMap>

【说明】

①此时的property是Student实体类中的属性，而column则是student和teacher表中字段名起别名后名称

2、一对多的处理

1、关于”一对多“的理解（以老师、学生之间的关系为例说明） 

• 多个学生 vs 一个老师
• 如果从老师的角度出发，就是一个一对多的现象，即一个老师下面集合多个学生

2、环境搭建与“多对一”的相同

3、实体类及Mapper接口的编写

【实体类】

@Data
public class Student {
    private int id;
    private String name;
    private int tid;
}

@Data
public class Teacher {
    private int id;
    private String name;

    List<Student> students;
}

【Mapper接口】

public interface TeacherMapper {

    public Teacher findTeacherByID(@Param("tid") int id);

}

4、要求：获取指定老师及其所有学生信息

 方案一：按结果嵌套处理【推荐使用】

<!--
    方式一：使用结果嵌套完成一对多的查询
    思路：
    1、从学生表和老师表中查询出学生id、学生姓名和老师姓名
    2、对查询出来的操作做结果集映射
        2.1、集合使用collection，其中，
            JavaType和ofType都是用来指定对象的类型，其中
            JavaType用来指定pojo中属性的类型，ofType指定的是映射到List属性中pojo的类型
    -->

    <select id="findTeacherByID" resultMap="TeacherStudent" parameterType="int">
        select s.id sid, s.name sname, t.name tname, t.id tid
        from student s, teacher t
        where s.tid = tid and tid = #{tid}
    </select>
    <!--TeacherStudent-->
    <resultMap id="TeacherStudent" type="Teacher">
        <result property="id" column="tid"></result>
        <result property="name" column="tname"></result>
        <collection property="students" ofType="Student">
            <result property="id" column="sid"></result>
            <result property="name" column="sname"></result>
            <result property="tid" column="tid"></result>
        </collection>
    </resultMap>

【说明】

①此时的property是Teacher实体类中的属性，而column则是student和teacher表中字段名起别名后名称

【测试以及查询结果】

public void test(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        TeacherMapper teacherMapper = sqlSession.getMapper(TeacherMapper.class);
        Teacher teacher = teacherMapper.findTeacherByID(1);
        System.out.println(teacher);
        sqlSession.close();
    }

 

  方案二：按查询嵌套处理

此时mapper.xml配置的如下：

<!--方式二：使用查询嵌套完成一对多的查询-->
    <select id="findTeacherByID" resultMap="TeacherStudent" parameterType="int">
        select * from teacher where id = #{tid}
    </select>

    <resultMap id="TeacherStudent" type="Teacher">
        <result property="id" column="id"></result>
        <result property="name" column="name"></result>
        <!--column是一对多的外键，写的是“一”的主键列名-->
        <collection property="students" javaType="ArrayList" ofType="Student" column="id" select="selectStudent"></collection>
    </resultMap>

    <select id="selectStudent" resultType="Student">
        select * from student where tid = #{id}
    </select>

三、小结

1、关联：association（多对一）

2、集合：collection（一对多）

3、javaType和ofType都是用来指定对象的类型

• javaType用来指定pojo中属性的类型
• ofType指定的是映射到list集合属性中的pojo类型

4、注意事项：

• 注意实体类属性名与数据库表字段名不一致的情形；
• 注意一对多/多对一中字段和属性的对应问题：查询嵌套处理和结果嵌套处理(推荐)；
• 尽量使用Log4j，通过日志可以用来分析运行是出现的错误；

 

（未完待续...）