详解MyBatis中的结果映射resultMap

比眉伴天荒 2024-03-26 22:06 97阅读 0赞

### 前言 ###

查询是数据库中使用频率最高的功能，在**MyBatis**中想要执行查询，需要在映射文件中配置<**select**>标签来编写查询**SQL**。光有查询还不够，还得完成查询结果与实体对象的映射，**MyBatis**提供了<**resultMap**>标签来提供强大的**结果映射**功能。

本篇文章将结合示例对<**select**>和<**resultMap**>标签进行学习，并对**N+1**问题进行分析。

**MyBatis**版本：**3.5.6**

### 正文 ###

#### 一. 示例工程搭建 ####

首先通过如下**SQL**语句创建表，并插入数据。

CREATE TABLE people (
        id INT(11) PRIMARY KEY AUTO_INCREMENT,
        p_name VARCHAR(255) NOT NULL,
        p_age INT(11) NOT NULL
    );
    
    INSERT INTO people(p_name, p_age) VALUES ("Lee", 20);
    INSERT INTO people(p_name, p_age) VALUES ("Arm", 25);
    
    CREATE TABLE bookstore(
        id INT(11) PRIMARY KEY AUTO_INCREMENT,
        bs_name VARCHAR(255) NOT NULL,
        p_id INT(11) NOT NULL,
        FOREIGN KEY bookstore(p_id) REFERENCES people(id)
    );
    
    INSERT INTO bookstore (bs_name, p_id) VALUES ("XinHua", 1);
    INSERT INTO bookstore (bs_name, p_id) VALUES ("SanYou", 2);
    
    CREATE TABLE book(
        id INT(11) PRIMARY KEY AUTO_INCREMENT,
        b_name VARCHAR(255) NOT NULL,
        b_price FLOAT NOT NULL,
        bs_id INT(11) NOT NULL,
        FOREIGN KEY book(bs_id) REFERENCES bookstore(id)
    );
    
    INSERT INTO book (b_name, b_price, bs_id) VALUES ("Math", 20.5, 1);
    INSERT INTO book (b_name, b_price, bs_id) VALUES ("English", 21.5, 1);
    INSERT INTO book (b_name, b_price, bs_id) VALUES ("Water Margin", 30.5, 2)
    复制代码

工程结构如下所示。

![format_png][]

**MAVEN**的**pom**文件内容如下所示。

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.lee.learn.mybatis</groupId>
        <artifactId>mybatis-select</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        <properties>
            <maven.compiler.source>8</maven.compiler.source>
            <maven.compiler.target>8</maven.compiler.target>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.6</version>
            </dependency>
    
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>8.0.16</version>
            </dependency>
    
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.13.2</version>
                <scope>test</scope>
            </dependency>
    
            <dependency>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-lang3</artifactId>
                <version>3.8.1</version>
            </dependency>
    
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-core</artifactId>
                <version>2.9.0</version>
            </dependency>
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-databind</artifactId>
                <version>2.9.0</version>
            </dependency>
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-annotations</artifactId>
                <version>2.9.0</version>
            </dependency>
        </dependencies>
    
        <build>
            <resources>
                <resource>
                    <directory>src/main/java</directory>
                    <includes>
                        <include>**/*.xml</include>
                    </includes>
                    <filtering>false</filtering>
                </resource>
            </resources>
        </build>
    
    </project>
    复制代码

配置文件**mybatis-config.xml**如下所示。

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-config.dtd">
    <configuration>
        <settings>
            <setting name="logImpl" value="STDOUT_LOGGING"/>
            <setting name="lazyLoadingEnabled" value="true"/>
        </settings>
    
        <environments default="development">
            <environment id="development">
                <transactionManager type="JDBC"/>
                <dataSource type="POOLED">
                    <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                    <property name="url" value="jdbc:mysql://192.168.101.7:3306/test?characterEncoding=utf-8&serverTimezone=UTC&useSSL=false"/>
                    <property name="username" value="somdbdev"/>
                    <property name="password" value="Km7HZP#aB"/>
                </dataSource>
            </environment>
        </environments>
    
        <mappers>
            <package name="com.lee.learn.mybatis.dao"/>
        </mappers>
    </configuration>
    复制代码

实体对象如下所示。

public class Book {
    
        private int id;
        private String bookName;
        private float bookPrice;
        private int bookStoreId;
    
        // 省略get和set
    
    }
    
    public class BookStore {
    
        private int id;
        private String bookStoreName;
        private int peopleId;
    
        // 省略get和set
    
    }
    
    public class People {
    
        private int id;
        private String peopleName;
        private int peopleAge;
    
        // 省略get和set
    
    }
    
    public class BsBookCombine {
    
        private int id;
        private String bookStoreName;
    
        private List<Book> books;
    
        // 省略get和set
    
    }
    
    public class BsPeopleCombine {
    
        private int id;
        private String bookStoreName;
    
        private People boss;
    
        // 省略get和set
    
    }
    
    public class BsBkPeopleCombine {
    
        private int id;
        private String bookStoreName;
    
        private People boss;
    
        private List<Book> books;
    
        // 省略get和set
    
    }
    复制代码

映射接口**BookMapper**如下所示。

public interface BookMapper {
    
        /**
         * 根据书Id查询一本书。
         *
         * @param bookId 书Id。
         * @return {@link Book}。
         */
        Book queryBookByBookId(int bookId);
    
        /**
         * 根据书店Id查询多本书。
         *
         * @param bsId 书店Id。
         * @return {@link Book}。
         */
        List<Book> queryBooksByBsId(int bsId);
    
    }
    复制代码

映射文件**BookMapper.xml**如下所示。

映射接口**PeopleMapper**如下所示。

public interface PeopleMapper {
    
        /**
         * 根据人Id查询一个人。
         *
         * @param peopleId 人Id。
         * @return 以Map的形式返回。
         */
        Map<String, Object> simpleQueryPeopleByPeopleId(int peopleId);
    
        /**
         * 根据人Id查询一个人。
         *
         * @param peopleId 人id。
         * @return {@link People}。
         */
        People queryPeopleByPeopleId(int peopleId);
    
    }
    复制代码

映射文件**PeopleMapper.xml**如下所示。

映射接口**AssociatedMapper**如下所示。

public interface AssociatedMapper {
    
        /**
         * 根据书店Id 关联的嵌套Select 查询{@link BsPeopleCombine}。
         *
         * @param bsId 书店Id。
         * @return {@link BsPeopleCombine}。
         */
        BsPeopleCombine queryBsPeopleCombineByBsIdAssociatedNestSelect(int bsId);
    
        /**
         * 根据书店Id 关联的嵌套结果 查询{@link BsPeopleCombine}。
         *
         * @param bsId 书店Id。
         * @return {@link BsPeopleCombine}。
         */
        BsPeopleCombine queryBsPeopleCombineByBsIdAssociatedNestResult(int bsId);
    
        /**
         * 根据书店Id 集合的嵌套Select 查询{@link BsBookCombine}。
         *
         * @param bsId 书店Id。
         * @return {@link BsBookCombine}。
         */
        BsBookCombine queryBsBookCombineByBsIdCollectionNestSelect(int bsId);
    
        /**
         * 根据书店Id 集合的嵌套结果 查询{@link BsBookCombine}。
         *
         * @param bsId 书店Id。
         * @return {@link BsBookCombine}。
         */
        BsBookCombine queryBsBookCombineByBsIdCollectionNestResult(int bsId);
    
        /**
         * 根据书店Id 嵌套Select 查询{@link BsBkPeopleCombine}。
         *
         * @param bsIs 书店Id。
         * @return {@link BsBkPeopleCombine}。
         */
        BsBkPeopleCombine queryBsBkPeopleCombineByBsIdNestSelect(int bsIs);
    
        /**
         * 根据书店Id 嵌套结果 查询{@link BsBkPeopleCombine}。
         *
         * @param bsIs 书店Id。
         * @return {@link BsBkPeopleCombine}。
         */
        BsBkPeopleCombine queryBsBkPeopleCombineByBsIdNestResult(int bsIs);
    
    }
    复制代码

映射文件**AssociatedMapper.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="com.lee.learn.mybatis.dao.AssociatedMapper">
        <resultMap id="bsPeopleCombineQueryMap" type="com.lee.learn.mybatis.entity.BsPeopleCombine">
            <id property="id" column="id"/>
            <result property="bookStoreName" column="bs_name"/>
            <association property="boss" column="p_id"
                         javaType="com.lee.learn.mybatis.entity.People"
                         select="com.lee.learn.mybatis.dao.PeopleMapper.queryPeopleByPeopleId"/>
        </resultMap>
    
        <resultMap id="bsPeopleCombineResultMap" type="com.lee.learn.mybatis.entity.BsPeopleCombine">
            <id property="id" column="bs_id"/>
            <result property="bookStoreName" column="bs_name"/>
            <association property="boss" javaType="com.lee.learn.mybatis.entity.People">
                <id property="id" column="p_id"/>
                <result property="peopleName" column="p_name"/>
                <result property="peopleAge" column="p_age"/>
            </association>
        </resultMap>
    
        <resultMap id="bsBookCombineQueryMap" type="com.lee.learn.mybatis.entity.BsBookCombine">
            <id property="id" column="id"/>
            <result property="bookStoreName" column="bs_name"/>
            <collection property="books" column="id"
                        javaType="ArrayList" ofType="com.lee.learn.mybatis.entity.Book"
                        select="com.lee.learn.mybatis.dao.BookMapper.queryBooksByBsId"/>
        </resultMap>
    
        <resultMap id="bsBookCombineResultMap" type="com.lee.learn.mybatis.entity.BsBookCombine">
            <id property="id" column="bs_Id"/>
            <result property="bookStoreName" column="bs_name"/>
            <collection property="books" ofType="com.lee.learn.mybatis.entity.Book">
                <id property="id" column="b_id"/>
                <result property="bookName" column="b_name"/>
                <result property="bookPrice" column="b_price"/>
                <result property="bookStoreId" column="bbs_id"/>
            </collection>
        </resultMap>
    
        <resultMap id="BsBkPeopleCombineQueryMap" type="com.lee.learn.mybatis.entity.BsBkPeopleCombine">
            <id property="id" column="id"/>
            <result property="bookStoreName" column="bs_name"/>
            <association property="boss" column="p_id"
                         javaType="com.lee.learn.mybatis.entity.People"
                         select="com.lee.learn.mybatis.dao.PeopleMapper.queryPeopleByPeopleId"/>
            <collection property="books" column="id"
                        ofType="com.lee.learn.mybatis.entity.Book"
                        select="com.lee.learn.mybatis.dao.BookMapper.queryBooksByBsId"/>
        </resultMap>
        
        <resultMap id="BsBkPeopleCombineResultMap" type="com.lee.learn.mybatis.entity.BsBkPeopleCombine">
            <id property="id" column="bs_id"/>
            <result property="bookStoreName" column="bs_name"/>
            <association property="boss" javaType="com.lee.learn.mybatis.entity.People">
                <id property="id" column="p_id"/>
                <result property="peopleName" column="p_name"/>
                <result property="peopleAge" column="p_age"/>
            </association>
            <collection property="books" ofType="com.lee.learn.mybatis.entity.Book">
                <id property="id" column="b_id"/>
                <result property="bookName" column="b_name"/>
                <result property="bookPrice" column="b_price"/>
                <result property="bookStoreId" column="bbs_id"/>
            </collection>
        </resultMap>
    
        <select id="queryBsPeopleCombineByBsIdAssociatedNestSelect" resultMap="bsPeopleCombineQueryMap">
            SELECT
                id,
                bs_name,
                p_id
            FROM bookstore
            WHERE id=#{bsId}
        </select>
    
        <select id="queryBsPeopleCombineByBsIdAssociatedNestResult" resultMap="bsPeopleCombineResultMap">
            SELECT
                bs.id AS bs_id,
                bs.bs_name AS bs_name,
                p.id AS p_id,
                p.p_name AS p_name,
                p.p_age AS p_age
            FROM bookstore bs
                LEFT OUTER JOIN people p ON bs.p_id=p.id
            WHERE bs.id=#{bsId}
        </select>
    
        <select id="queryBsBookCombineByBsIdCollectionNestSelect" resultMap="bsBookCombineQueryMap">
            SELECT
                id,
                bs_name
            FROM bookstore
            WHERE id=#{bsId}
        </select>
    
        <select id="queryBsBookCombineByBsIdCollectionNestResult" resultMap="bsBookCombineResultMap">
            SELECT
                bs.id AS bs_Id,
                bs.bs_name AS bs_name,
                b.id AS b_id,
                b.b_name AS b_name,
                b.b_price AS b_price,
                b.bs_id AS bbs_id
            FROM bookstore bs
                LEFT OUTER JOIN book b ON bs.id=b.bs_id
            WHERE bs.id=#{bsId}
        </select>
    
        <select id="queryBsBkPeopleCombineByBsIdNestSelect" resultMap="BsBkPeopleCombineQueryMap">
            SELECT
                id,
                bs_name,
                p_id
            FROM bookstore
            WHERE id=#{bsId}
        </select>
    
        <select id="queryBsBkPeopleCombineByBsIdNestResult" resultMap="BsBkPeopleCombineResultMap">
            SELECT
                bs.id AS bs_id,
                bs.bs_name AS bs_name,
                p.id AS p_id,
                p.p_name AS p_name,
                p.p_age AS p_age,
                b.id AS b_id,
                b.b_name AS b_name,
                b.b_price AS b_price,
                b.bs_id AS bbs_id
            FROM bookstore bs
                LEFT OUTER JOIN people p ON bs.p_id=p.id
                LEFT OUTER JOIN book b ON bs.id=b.bs_id
            WHERE bs.id=#{bsId}
        </select>
    
    </mapper>
    复制代码

最后就是单元测试类**MybatisTest**如下所示。

public class MybatisTest {
    
        private ObjectMapper objectMapper;
    
        private SqlSession sqlSession;
    
        @Before
        public void setUp() throws Exception {
            objectMapper = new ObjectMapper();
    
            String resource = "mybatis-config.xml";
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
                    .build(Resources.getResourceAsStream(resource));
            sqlSession = sqlSessionFactory.openSession();
        }
    
        @After
        public void tearDown() {
            sqlSession.close();
        }
    
        @Test
        public void 根据人Id查询一个人并映射成Map() throws Exception {
            PeopleMapper peopleMapper = sqlSession.getMapper(PeopleMapper.class);
            Map<String, Object> peopleMap = peopleMapper.simpleQueryPeopleByPeopleId(1);
            System.out.println(objectMapper.writeValueAsString(peopleMap));
        }
    
        @Test
        public void 根据书Id查询一本书() throws Exception {
            BookMapper bookMapper = sqlSession.getMapper(BookMapper.class);
            Book book = bookMapper.queryBookByBookId(1);
            System.out.println(objectMapper.writeValueAsString(book));
        }
    
        @Test
        public void 根据人Id查询一个人() throws Exception {
            PeopleMapper peopleMapper = sqlSession.getMapper(PeopleMapper.class);
            People people = peopleMapper.queryPeopleByPeopleId(1);
            System.out.println(objectMapper.writeValueAsString(people));
        }
    
        @Test
        public void 关联的嵌套SELECT查询() throws Exception {
            AssociatedMapper associatedMapper = sqlSession
                    .getMapper(AssociatedMapper.class);
            BsPeopleCombine bsPeopleCombine = associatedMapper
                    .queryBsPeopleCombineByBsIdAssociatedNestSelect(1);
            System.out.println(bsPeopleCombine.getBookStoreName());
            People boss = bsPeopleCombine.getBoss();
            System.out.println(objectMapper.writeValueAsString(boss));
        }
    
        @Test
        public void 关联的嵌套结果查询() throws Exception {
            AssociatedMapper associatedMapper = sqlSession
                    .getMapper(AssociatedMapper.class);
            BsPeopleCombine bsPeopleCombine = associatedMapper
                    .queryBsPeopleCombineByBsIdAssociatedNestResult(1);
            System.out.println(objectMapper.writeValueAsString(bsPeopleCombine));
        }
    
        @Test
        public void 集合的嵌套SELECT查询() {
            AssociatedMapper associatedMapper = sqlSession
                    .getMapper(AssociatedMapper.class);
            BsBookCombine bsBookCombine = associatedMapper
                    .queryBsBookCombineByBsIdCollectionNestSelect(1);
            System.out.println(bsBookCombine.getBookStoreName());
            List<Book> books = bsBookCombine.getBooks();
            books.forEach(book -> System.out.println(book.getBookName()));
        }
    
        @Test
        public void 集合的嵌套结果查询() {
            AssociatedMapper associatedMapper = sqlSession
                    .getMapper(AssociatedMapper.class);
            BsBookCombine bsBookCombine = associatedMapper
                    .queryBsBookCombineByBsIdCollectionNestResult(1);
            System.out.println(bsBookCombine.getBookStoreName());
            List<Book> books = bsBookCombine.getBooks();
            books.forEach(book -> System.out.println(book.getBookName()));
        }
    
        @Test
        public void 关联和集合的嵌套SELECT查询() {
            AssociatedMapper associatedMapper = sqlSession
                    .getMapper(AssociatedMapper.class);
            BsBkPeopleCombine bsBkPeopleCombine = associatedMapper
                    .queryBsBkPeopleCombineByBsIdNestSelect(1);
            System.out.println(bsBkPeopleCombine.getBookStoreName());
            People boss = bsBkPeopleCombine.getBoss();
            System.out.println(boss.getPeopleName());
            List<Book> books = bsBkPeopleCombine.getBooks();
            books.forEach(book -> System.out.println(book.getBookName()));
        }
    
        @Test
        public void 关联和集合的嵌套结果查询() {
            AssociatedMapper associatedMapper = sqlSession
                    .getMapper(AssociatedMapper.class);
            BsBkPeopleCombine bsBkPeopleCombine = associatedMapper
                    .queryBsBkPeopleCombineByBsIdNestResult(1);
            System.out.println(bsBkPeopleCombine.getBookStoreName());
            People boss = bsBkPeopleCombine.getBoss();
            System.out.println(boss.getPeopleName());
            List<Book> books = bsBkPeopleCombine.getBooks();
            books.forEach(book -> System.out.println(book.getBookName()));
        }
    
    }
    复制代码

#### 二. select标签 ####

通过<**select**>标签，可以在映射文件中编写查询**SQL**语句，例如示例工程中，映射接口**PeopleMapper**的**simpleQueryPeopleByPeopleId()** 方法对应的查询语句，如下所示。

<select id="simpleQueryPeopleByPeopleId" resultType="Map">
        SELECT
            id,
            p_name,
            p_age
        FROM people
        WHERE id=#{id}
    </select>
    复制代码

<**select**>标签的**id**属性是该查询语句在当前映射文件下的唯一标识，通常需要与映射接口中的方法名一样，而**resultType**属性告诉**MyBatis**应该将查询结果映射成什么对象类型，这里的对象类型需要与映射接口中的方法的返回类型一致，示例中是**Map**类型，那么表示需要将查询结果映射成一个**Map**对象，**Map**的**key**就是列名，**value**就是记录值。

如果将<**select**>标签的**resultType**属性设置为某一个实体对象类型，只要列名与对象属性名一样或者满足驼峰命名规则且开启了自动映射机制（<**setting name="mapUnderscoreToCamelCase" value="true"/**>），**MyBatis**也能够完成查询结果到实体对象的映射。

但如果列名与对象属性名不一样，并且也不满足驼峰命名规则，此时要完成查询结果与实体对象的映射，需要借助<**resultMap**>标签，这里后面会详细说明。

<**select**>标签的常用属性配置可以参考[select标签属性][select]。 这里对一些常用的属性配置进行说明。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>配置</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>id</strong></td> 
   <td>当前&lt;<strong>select</strong>&gt;标签在映射文件下的唯一标识。需要与映射接口的方法名一致</td> 
  </tr> 
  <tr> 
   <td><strong>parameterType</strong></td> 
   <td>传入<strong>SQL</strong>的参数的类型。例如上面例子中，就可以设置<strong>parameterType="int"</strong>，但通常不需要设置，<strong>MyBatis</strong>能够自行推断出入参类型</td> 
  </tr> 
  <tr> 
   <td><strong>resultType</strong></td> 
   <td>告诉<strong>MyBatis</strong>需要将查询结果映射成什么类型。如果需要映射成集合类型，则<strong>resultType</strong>应该设置为集合的泛型类型。注意：<strong>resultType</strong>与<strong>resultMap</strong>只能同时配置一个</td> 
  </tr> 
  <tr> 
   <td><strong>resultMap</strong></td> 
   <td>告诉<strong>MyBatis</strong>需要使用那个&lt;<strong>resultMap</strong>&gt;来做结果映射。需要配置为&lt;<strong>resultMap</strong>&gt;标签的<strong>id</strong>值</td> 
  </tr> 
  <tr> 
   <td><strong>flushCache</strong></td> 
   <td>如果配置为<strong>true</strong>，则语句执行时清空一级缓存和二级缓存。&lt;<strong>select</strong>&gt;标签默认为<strong>false</strong></td> 
  </tr> 
  <tr> 
   <td><strong>useCache</strong></td> 
   <td>如果配置为<strong>true</strong>，则语句执行结果会被缓存到二级缓存。&lt;<strong>select</strong>&gt;标签默认为<strong>true</strong></td> 
  </tr> 
 </tbody> 
</table>

#### 三. resultMap标签 ####

1. 认识标签和属性

如下是一个示例。

<resultMap id="BsBkPeopleCombineResultMap" type="com.lee.learn.mybatis.entity.BsBkPeopleCombine">
        
        <id property="id" column="bs_id"/>
        
        <result property="bookStoreName" column="bs_name"/>
        
        <association property="boss" javaType="com.lee.learn.mybatis.entity.People">
            <id property="id" column="p_id"/>
            <result property="peopleName" column="p_name"/>
            <result property="peopleAge" column="p_age"/>
        </association>
        
        <collection property="books" ofType="com.lee.learn.mybatis.entity.Book">
            <id property="id" column="b_id"/>
            <result property="bookName" column="b_name"/>
            <result property="bookPrice" column="b_price"/>
            <result property="bookStoreId" column="bbs_id"/>
        </collection>
    </resultMap>
    复制代码

首先是<**resultMap**>标签，该标签会定义一种查询结果到实体对象的映射关系，通过**namespace.id**就可以引用。标签上的重要属性，说明如下。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>id</strong></td> 
   <td>表示<strong>resultMap</strong>在当前映射文件下的唯一标识，当前映射文件中通过<strong>id</strong>就可以引用该<strong>resultMap</strong>，其它映射文件中要引用该<strong>resultMap</strong>，需要通过当前映射文件的命名空间和<strong>resultMap</strong>的<strong>id</strong>来引用，即<strong>namesapce.id</strong></td> 
  </tr> 
  <tr> 
   <td><strong>type</strong></td> 
   <td>标识<strong>resultMap</strong>需要映射到哪个实体对象</td> 
  </tr> 
 </tbody> 
</table>

然后是<**id**>和<**result**>标签，这两个标签作用一样：可以完成将一个列映射到实体对象的一个简单类型的属性上。唯一的区别就是<**id**>标签标记的属性可以作为对象的唯一标识符，用于对象的快速比较。标签上的重要属性，说明如下。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>property</strong></td> 
   <td>实体对象的属性名</td> 
  </tr> 
  <tr> 
   <td><strong>column</strong></td> 
   <td>表的列名</td> 
  </tr> 
  <tr> 
   <td><strong>javaType</strong></td> 
   <td>指定实体对象的属性的<strong>Java</strong>类型，用于<strong>TypeHandler</strong>的推断。通常可以不指定，<strong>MyBatis</strong>能够通过&lt;<strong>resultMap</strong>&gt;标签的<strong>type</strong>属性拿到实体对象对应的属性的<strong>Java</strong>类型</td> 
  </tr> 
  <tr> 
   <td><strong>jdbcType</strong></td> 
   <td>指定列的<strong>Jdbc</strong>类型，用于<strong>TypeHandler</strong>的推断</td> 
  </tr> 
  <tr> 
   <td><strong>typeHandler</strong></td> 
   <td>直接指定使用的<strong>TypeHandler</strong></td> 
  </tr> 
 </tbody> 
</table>

再然后是<**association**>标签，该标签用于映射结果时，映射的对象具有关联关系，例如下面的对象。

public class BsPeopleCombine {
    
        private int id;
        private String bookStoreName;
    
        private People boss;
    
        // 省略get和set
    
    }
    复制代码

书店关联一个老板，查询书店时需要将书店关联的老板也查询出来，通常有两种关联方式。

*  先查询出书店，然后再根据书店的查询结果查询出老板，最后组装两次查询的结果；
 *  通过关联查询一次查询出书店以及和书店关联的老板，关联查询的结果直接完成组装。

所以在**MyBatis**中，就可以通过<**association**>标签，完成上述的功能。<**association**>标签有两种使用方式，分别对应上面的两种关联方式。

*  **嵌套SELECT**。将另外一个**SELECT**查询的结果映射为实体对象的某一个对象属性。也就是示例中的**BsPeopleCombine**的**boss**属性的值由一个查询**People**的查询语句的查询结果来完成映射。这种方式很简单，但会带来**N+1**问题，这点后面再分析；
 *  **嵌套结果**。将关联查询（**内连接**，**左右外连**）出来的若干列映射为实体对象的某一个对象属性。这种方式能规避**N+1**问题，但会增加**SQL**的复杂度。

<**association**>标签的重要属性如下所示。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>property</strong></td> 
   <td>实体对象的属性名</td> 
  </tr> 
  <tr> 
   <td><strong>javaType</strong></td> 
   <td>实体对象的属性的<strong>Java</strong>类型</td> 
  </tr> 
  <tr> 
   <td><strong>column</strong></td> 
   <td>（<strong>嵌套SELECT</strong>）通过列名或者列别名指定列，指定列的值会作为参数传递给嵌套的<strong>select</strong>语句</td> 
  </tr> 
  <tr> 
   <td><strong>select</strong></td> 
   <td>（<strong>嵌套SELECT</strong>）通过<strong>namespace.id</strong>的形式引用<strong>select</strong>语句</td> 
  </tr> 
  <tr> 
   <td><strong>fetchType</strong></td> 
   <td>（<strong>嵌套SELECT</strong>）指定为<strong>lazy</strong>会让<strong>select</strong>引用的查询语句延迟执行，指定为<strong>eager</strong>会让<strong>select</strong>引用的查询语句随着当前查询语句的执行而执行</td> 
  </tr> 
 </tbody> 
</table>

如果对上述的标签作用和属性还是不清楚，可以先有个印象，下面的小节会以实际的例子进行说明。

最后是<**collection**>标签，作用与<**association**>标签相似，不过适用于和集合关联的情况。示例如下。

public class BsBookCombine {
    
        private int id;
        private String bookStoreName;
    
        private List<Book> books;
    
        // 省略get和set
    	
    }
    复制代码

书店关联多本书，查询书店时需要将书店关联的所有书也查询出来，通常也有两种关联方式。

*  先查询出书店，然后再根据书店的查询结果查询出所有书，最后组装两次查询的结果；
 *  通过关联查询一次查询出书店以及和书店关联的所有书，关联查询的结果直接完成组装。

那么到这里也就知道了<**collection**>标签和<**association**>标签极其相似，两个标签的属性也是近乎一样，不同点在于<**collection**>标签比<**association**>标签多了一个**ofType**属性，该属性用于配置集合的泛型的类型。

2. 简单查询的结果映射

**book**表列信息如下。

<table> 
 <thead> 
  <tr> 
   <th>列名</th> 
   <th>JDBC类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>id</strong></td> 
   <td><strong>INT</strong></td> 
  </tr> 
  <tr> 
   <td><strong>b_name</strong></td> 
   <td><strong>VARCHAR</strong></td> 
  </tr> 
  <tr> 
   <td><strong>b_price</strong></td> 
   <td><strong>FLOAT</strong></td> 
  </tr> 
  <tr> 
   <td><strong>bs_id</strong></td> 
   <td><strong>INT</strong></td> 
  </tr> 
 </tbody> 
</table>

**Book**实体对象如下。

public class Book {
    
        private int id;
        private String bookName;
        private float bookPrice;
        private int bookStoreId;
    	
        // 省略get和set
    	
    }
    复制代码

那么映射文件中对应的查询语句的<**select**>标签如下所示。

<select id="queryBookByBookId" resultMap="bookResultMap">
        SELECT
            id,
            b_name,
            b_price,
            bs_id
        FROM book
        WHERE id=#{bookId}
    </select>
    复制代码

在<**select**>标签中通过**resultMap**属性设置<**resultMap**>标签的**id**来引用**resultMap**。

那么对应的<**resultMap**>如下所示。

<resultMap id="bookResultMap" type="com.lee.learn.mybatis.entity.Book">
        <id property="id" column="id"/>
        <result property="bookName" column="b_name"/>
        <result property="bookPrice" column="b_price"/>
        <result property="bookStoreId" column="bs_id"/>
    </resultMap>
    复制代码

3. 关联的嵌套SELECT查询的结果映射

本小节演示使用<**association**>标签来完成嵌套**SELECT**查询结果的映射。

关联的两张表分别为**bookstore**和**people**。**bookstore**表列信息如下。

<table> 
 <thead> 
  <tr> 
   <th>列名</th> 
   <th>JDBC类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>id</strong></td> 
   <td><strong>INT</strong></td> 
  </tr> 
  <tr> 
   <td><strong>bs_name</strong></td> 
   <td><strong>VARCHAR</strong></td> 
  </tr> 
  <tr> 
   <td><strong>p_id</strong></td> 
   <td><strong>INT</strong></td> 
  </tr> 
 </tbody> 
</table>

**people**表列信息如下。

<table> 
 <thead> 
  <tr> 
   <th>列名</th> 
   <th>JDBC类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>id</strong></td> 
   <td><strong>INT</strong></td> 
  </tr> 
  <tr> 
   <td><strong>p_name</strong></td> 
   <td><strong>VARCHAR</strong></td> 
  </tr> 
  <tr> 
   <td><strong>p_age</strong></td> 
   <td><strong>INT</strong></td> 
  </tr> 
 </tbody> 
</table>

关联查询结果的实体对象为**BsPeopleCombine**，如下所示。

public class BsPeopleCombine {
    
        private int id;
        private String bookStoreName;
    
        private People boss;
    
        // 省略get和set
    	
    }
    复制代码

映射文件中对应的查询语句的<**select**>标签如下所示。

<select id="queryBsPeopleCombineByBsIdAssociatedNestSelect" resultMap="bsPeopleCombineQueryMap">
        SELECT
            id,
            bs_name,
            p_id
        FROM bookstore
        WHERE id=#{bsId}
    </select>
    复制代码

引用的<**resultMap**>如下所示。

**select**属性引用的<**select**>标签在映射文件**PeopleMapper.xml**文件中，其**namespace**是**com.lee.learn.mybatis.dao.PeopleMapper**，**PeopleMapper.xml**中的**id**为**queryPeopleByPeopleId**的<**select**>标签如下所示。

<select id="queryPeopleByPeopleId" resultMap="peopleResultMap">
        SELECT
            id,
            p_name,
            p_age
        FROM people
        WHERE id=#{id}
    </select>
    复制代码

上述查询语句的入参，就取<**association**>标签中通过**column**指定的列的值，也就是**id**为**queryBsPeopleCombineByBsIdAssociatedNestSelect**的<**select**>标签查询回来的**p\_id**会作为入参传入到**id**为**queryPeopleByPeopleId**的<**select**>标签中。

测试程序如下。

@Test
    public void 关联的嵌套SELECT查询() throws Exception {
        AssociatedMapper associatedMapper = sqlSession
                .getMapper(AssociatedMapper.class);
        BsPeopleCombine bsPeopleCombine = associatedMapper
                .queryBsPeopleCombineByBsIdAssociatedNestSelect(1);
        System.out.println(bsPeopleCombine.getBookStoreName());
        People boss = bsPeopleCombine.getBoss();
        System.out.println(objectMapper.writeValueAsString(boss));
    }
    复制代码

运行测试程序，打印如下。

Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@38e79ae3]
    ==>  Preparing: SELECT id, bs_name, p_id FROM bookstore WHERE id=?
    ==> Parameters: 1(Integer)
    <==    Columns: id, bs_name, p_id
    <==        Row: 1, XinHua, 1
    <==      Total: 1
    XinHua
    ==>  Preparing: SELECT id, p_name, p_age FROM people WHERE id=?
    ==> Parameters: 1(Integer)
    <==    Columns: id, p_name, p_age
    <==        Row: 1, Lee, 20
    <==      Total: 1
    {"id":1,"peopleName":"Lee","peopleAge":20}
    复制代码

由于在配置文件中添加了如下设置。

<setting name="lazyLoadingEnabled" value="true"/>
    复制代码

表示所有的嵌套查询都延迟执行，即用到对应的属性时才执行对应的查询语句，也就是测试程序中执行到**bsPeopleCombine.getBoss()** 时才会触发**id**为**queryPeopleByPeopleId**的<**select**>标签的语句的执行。

4. 关联的嵌套结果查询的结果映射

本小节演示使用<**association**>标签来完成嵌套结果查询的结果映射。

关联的两张表分别为**bookstore**和**people**。**bookstore**表列信息如下。

**people**表列信息如下。

关联查询结果的实体对象为**BsPeopleCombine**，如下所示。

public class BsPeopleCombine {
    
        private int id;
        private String bookStoreName;
    
        private People boss;
    
        // 省略get和set
    	
    }
    复制代码

映射文件中对应的查询语句的<**select**>标签如下所示。

<select id="queryBsPeopleCombineByBsIdAssociatedNestResult" resultMap="bsPeopleCombineResultMap">
        SELECT
            bs.id AS bs_id,
            bs.bs_name AS bs_name,
            p.id AS p_id,
            p.p_name AS p_name,
            p.p_age AS p_age
        FROM bookstore bs
            LEFT OUTER JOIN people p ON bs.p_id=p.id
        WHERE bs.id=#{bsId}
    </select>
    复制代码

上述是一个左外连接的关联查询，引用的<**resultMap**>如下所示。

<resultMap id="bsPeopleCombineResultMap" type="com.lee.learn.mybatis.entity.BsPeopleCombine">
        <id property="id" column="bs_id"/>
        <result property="bookStoreName" column="bs_name"/>
        <association property="boss" javaType="com.lee.learn.mybatis.entity.People">
            <id property="id" column="p_id"/>
            <result property="peopleName" column="p_name"/>
            <result property="peopleAge" column="p_age"/>
        </association>
    </resultMap>
    复制代码

测试程序如下所示。

@Test
    public void 关联的嵌套结果查询() throws Exception {
        AssociatedMapper associatedMapper = sqlSession
                .getMapper(AssociatedMapper.class);
        BsPeopleCombine bsPeopleCombine = associatedMapper
                .queryBsPeopleCombineByBsIdAssociatedNestResult(1);
        System.out.println(objectMapper.writeValueAsString(bsPeopleCombine));
    }
    复制代码

执行结果如下。

Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@38e79ae3]
    ==>  Preparing: SELECT bs.id AS bs_id, bs.bs_name AS bs_name, p.id AS p_id, p.p_name AS p_name, p.p_age AS p_age FROM bookstore bs LEFT OUTER JOIN people p ON bs.p_id=p.id WHERE bs.id=?
    ==> Parameters: 1(Integer)
    <==    Columns: bs_id, bs_name, p_id, p_name, p_age
    <==        Row: 1, XinHua, 1, Lee, 20
    <==      Total: 1
    {"id":1,"bookStoreName":"XinHua","boss":{"id":1,"peopleName":"Lee","peopleAge":20}}
    复制代码

可见只会执行一次查询，并且能够完成结果映射。

5. 集合的嵌套SELECT查询的结果映射

本小节演示使用<**collection**>标签来完成嵌套**SELECT**查询结果的映射。

关联的两张表分别为**bookstore**和**book**。**bookstore**表列信息如下。

**book**表列信息如下。

关联查询结果的实体对象为**BsBookCombine**，如下所示。

public class BsBookCombine {
    
        private int id;
        private String bookStoreName;
    
        private List<Book> books;
    
        // 省略get和set
    	
    }
    复制代码

映射文件中对应的查询语句的<**select**>标签如下所示。

<select id="queryBsBookCombineByBsIdCollectionNestSelect" resultMap="bsBookCombineQueryMap">
        SELECT
            id,
            bs_name
        FROM bookstore
        WHERE id=#{bsId}
    </select>
    复制代码

引用的<**resultMap**>如下所示。

<resultMap id="bsBookCombineQueryMap" type="com.lee.learn.mybatis.entity.BsBookCombine">
        <id property="id" column="id"/>
        <result property="bookStoreName" column="bs_name"/>
        <collection property="books" column="id"
                    javaType="ArrayList" ofType="com.lee.learn.mybatis.entity.Book"
                    select="com.lee.learn.mybatis.dao.BookMapper.queryBooksByBsId"/>
    </resultMap>
    复制代码

**select**属性引用的<**select**>标签在映射文件**BookMapper.xml**文件中，其**namespace**是**com.lee.learn.mybatis.dao.BookMapper**，**BookMapper.xml**中的**id**为**queryBooksByBsId**的<**select**>标签如下所示。

<select id="queryBooksByBsId" resultMap="bookResultMap">
        SELECT
            id,
            b_name,
            b_price,
            bs_id
        FROM book
        WHERE bs_id=#{bsId}
    </select>
    复制代码

上述查询语句的入参，就取<**collection**>标签中通过**column**指定的列的值，也就是**id**为**queryBsBookCombineByBsIdCollectionNestSelect**的<**select**>标签查询回来的**id**会作为入参传入到**id**为**queryBooksByBsId**的<**select**>标签中。

测试程序如下。

@Test
    public void 集合的嵌套SELECT查询() {
        AssociatedMapper associatedMapper = sqlSession
                .getMapper(AssociatedMapper.class);
        BsBookCombine bsBookCombine = associatedMapper
                .queryBsBookCombineByBsIdCollectionNestSelect(1);
        System.out.println(bsBookCombine.getBookStoreName());
        List<Book> books = bsBookCombine.getBooks();
        books.forEach(book -> System.out.println(book.getBookName()));
    }
    复制代码

运行测试程序，打印如下。

Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@38e79ae3]
    ==>  Preparing: SELECT id, bs_name FROM bookstore WHERE id=?
    ==> Parameters: 1(Integer)
    <==    Columns: id, bs_name
    <==        Row: 1, XinHua
    <==      Total: 1
    XinHua
    ==>  Preparing: SELECT id, b_name, b_price, bs_id FROM book b WHERE bs_id=?
    ==> Parameters: 1(Integer)
    <==    Columns: id, b_name, b_price, bs_id
    <==        Row: 1, Math, 20.5, 1
    <==        Row: 2, English, 21.5, 1
    <==      Total: 2
    Math
    English
    复制代码

6. 集合的嵌套结果查询的结果映射

本小节演示使用<**collection**>标签来完成嵌套结果查询的结果映射。

关联的两张表分别为**bookstore**和**book**。**bookstore**表列信息如下。

**book**表列信息如下。

关联查询结果的实体对象为**BsBookCombine**，如下所示。

public class BsBookCombine {
    
        private int id;
        private String bookStoreName;
    
        private List<Book> books;
    
        // 省略get和set
    	
    }
    复制代码

映射文件中对应的查询语句的<**select**>标签如下所示。

<select id="queryBsBookCombineByBsIdCollectionNestResult" resultMap="bsBookCombineResultMap">
        SELECT
            bs.id AS bs_Id,
            bs.bs_name AS bs_name,
            b.id AS b_id,
            b.b_name AS b_name,
            b.b_price AS b_price,
            b.bs_id AS bbs_id
        FROM bookstore bs
            LEFT OUTER JOIN book b ON bs.id=b.bs_id
        WHERE bs.id=#{bsId}
    </select>
    复制代码

上述是一个左外连接的关联查询，引用的<**resultMap**>如下所示。

<resultMap id="bsBookCombineResultMap" type="com.lee.learn.mybatis.entity.BsBookCombine">
        <id property="id" column="bs_Id"/>
        <result property="bookStoreName" column="bs_name"/>
        <collection property="books" ofType="com.lee.learn.mybatis.entity.Book">
            <id property="id" column="b_id"/>
            <result property="bookName" column="b_name"/>
            <result property="bookPrice" column="b_price"/>
            <result property="bookStoreId" column="bbs_id"/>
        </collection>
    </resultMap>
    复制代码

测试程序如下所示。

@Test
    public void 集合的嵌套结果查询() {
        AssociatedMapper associatedMapper = sqlSession
                .getMapper(AssociatedMapper.class);
        BsBookCombine bsBookCombine = associatedMapper
                .queryBsBookCombineByBsIdCollectionNestResult(1);
        System.out.println(bsBookCombine.getBookStoreName());
        List<Book> books = bsBookCombine.getBooks();
        books.forEach(book -> System.out.println(book.getBookName()));
    }
    复制代码

执行结果如下。

Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@38e79ae3]
    ==>  Preparing: SELECT bs.id AS bs_Id, bs.bs_name AS bs_name, b.id AS b_id, b.b_name AS b_name, b.b_price AS b_price, b.bs_id AS bbs_id FROM bookstore bs LEFT OUTER JOIN book b ON bs.id=b.bs_id WHERE bs.id=?
    ==> Parameters: 1(Integer)
    <==    Columns: bs_Id, bs_name, b_id, b_name, b_price, bbs_id
    <==        Row: 1, XinHua, 1, Math, 20.5, 1
    <==        Row: 1, XinHua, 2, English, 21.5, 1
    <==      Total: 2
    XinHua
    Math
    English
    复制代码

7. N+1问题与解决

第3和第5小节中，分别在<**association**>和<**collection**>标签中使用了**select**属性来引用查询语句，表示在进行结果映射时，需要执行这个查询语句来得到更多的结果来完成映射。以如下的查询语句为例。

<resultMap id="bsPeopleCombineQueryMap" type="com.lee.learn.mybatis.entity.BsPeopleCombine">
        <id property="id" column="id"/>
        <result property="bookStoreName" column="bs_name"/>
        <association property="boss" column="p_id"
                     javaType="com.lee.learn.mybatis.entity.People"
                     select="com.lee.learn.mybatis.dao.PeopleMapper.queryPeopleByPeopleId"/>
    </resultMap>
    
    <select id="queryBsPeopleCombineByBsIdAssociatedNestSelect" resultMap="bsPeopleCombineQueryMap">
        SELECT
            id,
            bs_name,
            p_id
        FROM bookstore
        WHERE id=#{bsId}
    </select>
    复制代码

由于是通过`id=#{bsId}`作为查询条件，所以上述查询语句的一次查询只会返回一条数据，而这一条数据会触发一次<**association**>标签的**select**属性引用的查询语句，所以一次查询实际触发了两次查询操作。但是试想一下，如果上述的条件变更为`id>#{bsId}`，那么上述查询语句的一次查询有可能会返回多条数据，从而触发多次查询操作，这在大数据量时会十分影响性能，称这种问题为**N+1**问题。

解决**N+1**问题，有两种方式，如下所示。

*  **延迟执行额外的select**。也就是使用到对应的属性时，才触发这个属性对应的**select**查询语句，这能够一定程度缓解**N+1**问题带来的性能影响。要想延时执行，也有两种方式：第一种是在配置文件中通过<**setting name="lazyLoadingEnabled" value="true"/**>设置**lazyLoadingEnabled**为**true**，第二种是在<**association**>或<**collection**>标签中设置**fetchType**为**lazy**，其中第二种方式优先级高于第一种方式；
 *  **采用嵌套结果查询**。也就是使用第4和第6小节中的嵌套结果查询的方式来代替嵌套**SELECT**查询的方式。

### 总结 ###

在**MyBatis**中的映射文件中，可以通过<**select**>标签来配置查询语句，而执行查询后的结果映射，可以通过两种方式来配置。

1.  <**select**>标签的**resultType**。使用**resultType**告诉**MyBatis**需要将查询结果映射为什么对象类型，这要求表列名与对象的属性名一样或者满足驼峰命名规则，如果是满足驼峰命名规则，还需要开启自动映射机制（<**setting name="mapUnderscoreToCamelCase" value="true"/**>），才能完成查询结果映射；
2.  <**select**>标签的**resultMap**。

<**select**>标签的**resultMap**能够引用<**resultMap**>标签的内容，即当前<**select**>标签的结果映射规则使用引用的<**resultMap**>标签配置的规则。<**resultMap**>标签能够完成如下规则配置。

1.  <**id**>和<**result**>配置一个列与简单数据类型的映射关系。在这两个标签中，通过**column**配置列，通过**property**配置简单数据类型的属性名，**MyBatis**会在结果映射时，完成配置的列到属性的映射；
2.  <**association**>配置查询结果到`一个`复杂属性的映射关系。假如一个书店`有一个`老板，那么在查询书店时，可以通过<**association**>配置一个查询语句，在查询出书店后，再通过这个查询语句查询出老板，这会带来**N+1**问题；也可以通过<**association**>配置一个映射关系，在关联查询出书店和老板的记录后，通过关联关系将老板对应的列映射到老板对应的属性对象上。
3.  <**collection**>配置查询结果到`多个`复杂属性的映射关系。<**collection**>和<**association**>几乎一模一样，只不过<**association**>适用场景是一个书店`有一个`老板的场景，而<**collection**>适用场景是一个书店`有多本`书的场景。

[format_png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/7cf1c3ce9bc54236af9e1dc51890ade0.png
[select]: https://link.juejin.cn?target=https%3A%2F%2Fmybatis.org%2Fmybatis-3%2Fzh%2Fsqlmap-xml.html%23select