三、MyBatis系列：Mapper 映射 之 多级关联查询结果映射

现在有这么几张表，员工表（user）、订单（orders）、订单明细（orderdetails）、产品信息（items）它们的物理模型图如下：

希望能查询出某些用户下的订单详细信息，而且希望能一条SQL查出所有相关的数据，并映射到POJO实体中。
返回的结果应该包含用户信息、订单及明细、相应产品信息。
数据映射为实体结构如下:

package cn.xleos.mybatis.po;

public class User {
    private int id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;
    private List<Order> orders;  // 一个用户关联多个订单
}
public class Order {
    private int id;
    private User user; // 订单所属的用户.
    private int number;
    private Date createtime;
    private List<OrderDetail> details; // 一个订单关联多个订单明细
}
public class OrderDetail {
    private int id;
    private Order order;  // 明细所属的订单
    private Item item;  // 每个订单明细关联一个产品信息.
    private int number;
}
public class Item {
    private int id;
    private String name;
    private Float price;
    private String detail;
}

现在来看看这个mapper的映射配置如何编写，注意示例中的以下几点：
1、constructor  实体的构造方法
2、autoMapping  自动属性映射
3、collection  集合属性的映射
4、association  关联属性的映射
5、mapUnderscoreToCamelCase 是否开启自动驼峰命名规则，全局配置.

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.3//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="test">
    <!-- 定义一个返回结果映射，告诉 MyBatis你希望的映射方式.
         1. type 是你希望结果映射到的POJO类型;
         2. autoMapping 默认为 false;
     -->
    <resultMap type="cn.xleos.mybatis.po.User" id="userOrderDetailMap" autoMapping="true">
        <!-- 当你希望以自定构造方法来创建实例时，就需要该配置节,如:User(Integer id, String username).
             正如期望的那样，为构造方法传递参数值，是按照配置节顺序传入的.
            >idArg: 传入一个做为主键值的参数. 
            >arg: 传入一个普通的参数值.
         -->
        <constructor>
            <!-- 使用 User(Integer id)构造函数来传入 id 参数.
                >这里有个地方要注意，无论 javaType 设置的值为 int 或 integer 都是 java.lang.Integer 的别名.
                >这样在 User 类型中就不能使用 int 做为 id 的类型, 否则会找不到该构造方法.
                >若希望在 User 类中使用 int 做为构造方法类型 User(int id),那这里的 javaType 应设置为 _int，它才是 int 类型别名.
                >还需要注意的是: 其它类型也可能存在相同的问题.
             -->
            <idArg column="user_id" javaType="int" />
            <arg column="username" javaType="String" />
        </constructor>
    
        <!-- 当构造方法中没有定义一个主键做为参数，那么你可能需要使用以下的方式配置主键属性. -->
        <!-- <id property="id" column="user_id" /> -->
        
        <!-- 默认情况下只有配置了 result 才会将数据绑定至该属性.
            >只有 autoMapping 设置为 true 时, 即使不配置 sex/address,也会自动绑定属性.会忽略大小写的.
            >还有一种情况是：数据字段命名时常常将多个字段名使用下划线间隔，如：user_name
            >如果希望能正确的映射到 username 属性中，需要在全局配置文件中设置: mapUnderscoreToCamelCase=true
        -->
          <result property="birthday" column="birthday"  />
        <!--
        <result column="sex" property="sex" />
        <result column="address" property="address" />
        -->
        
        <!-- collection 表示你将要映射一个 List<E> 类型的属性, 这里映射到的另一个resultMap; -->
        <collection property="orders" resultMap="orderDetailMap" />
    </resultMap>
    <!-- 表单及明细的结果映射 -->
    <resultMap type="cn.xleos.mybatis.po.Order" id="orderDetailMap">
        <id property="id" column="orders_id" />
        <result column="createtime" property="createtime" />
        <result column="number" property="number" />
        <!-- 表单所属用户的关联属性映射 -->
        <association property="user" resultMap="userOrderDetailMap" />
        <!-- 表单明细集合的结果映射 -->
        <collection property="details" ofType="cn.xleos.mybatis.po.OrderDetail">
            <id property="id" column="detail_id" />
            <result property="number" column="items_num" />
            <!-- 明细所属表单的关联属性映射 -->
            <association property="order" column="orders_id" resultMap="orderDetailMap" />
            <!-- 明细所属产品的关联属性映射 -->
            <association property="item" javaType="cn.xleos.mybatis.po.Item">
                <id property="id" column="items_id" />
                <result property="name" column="name" />
                <result property="price" column="price" />
                <result property="detail" column="detail" />
            </association>
        </collection>
    </resultMap>
    
    <!-- 您必须定义 resultMap,否则将无法得到你预期的结果. -->
    <select id="getUserOrderDetails" resultMap="userOrderDetailMap">
        SELECT
        `user`.id AS user_id,
        `user`.username AS user_name,
        `user`.sex AS sex,
        `user`.birthday AS birthday, 
        `user`.address AS address,
        orders.id AS orders_id,
        orders.createtime,
        orders.number,
        orderdetail.id AS detail_id,
        orderdetail.items_num,
        items.id AS items_id,
        items.`name`,
        items.price,
        items.detail
        FROM orderdetail
        INNER JOIN orders ON orders.id = orderdetail.orders_id
        INNER JOIN `user` ON `user`.id = orders.user_id
        INNER JOIN items ON items.id = orderdetail.items_id
    </select>
</mapper>

 数据查询结果与实体映射的关系，通过下图可以很容易理解。

• A 数据源会去重，生成一个 user 对象
• B 数据源会去重，生成 user 对象中的 orders 集合中的记录。
• 在生成 order 对象的 user 属性时，会从一级缓存获取 user 对象,它的 key 就是 user_id
• C 数据源会去重，生成 order 对象中的 details 集中中的记录；
• D 数据源会生成 detail 对象的 item 关联属性；