史上最简单的 MyBatis 教程（五）

1 前言

在史上最简单的 MyBatis 教程（一、二、三、四）中，咱们已经把 MyBatis 框架的基本内容了解的差不多啦，然而美中不足的是：在前四篇博文的示例中，咱们仅仅演示了一对一（1:1）的映射关系，并没有演示一对多（1:N）的映射关系。因此，在本篇博文中，咱们就一起来看看 MyBatis 框架如何实现一对多的映射关系！

2 关联映射(1:N)

为了更好的演示一对多的映射关系，在原有的项目中，又新建了两个实体类以及一个映射文件，项目结构图发生了变化，因此先给出项目结构图：

第一步：在数据库中新建两个表，咱们以客户（customer）和订单（orders）为例

customer 表结构：

customer 表内容：

orders 表结构：

orders 表内容：

第二步：新建两个对应 customer 和 orders 表的实体类

Customer 实体类：

package yeepay.payplus.domain;

import java.util.List;

/**
 * Created by 维C果糖 on 2017/3/6.
 */
public class Customer {
    private List<Orders> orders;    // 关联多个订单
    private Integer id;
    private String name;

    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 List<Orders> getOrders() {
        return orders;
    }

    public void setOrders(List<Orders> orders) {
        this.orders = orders;
    }
}

Orders 实体类：

package yeepay.payplus.domain;

/**
 * Created by 维C果糖 on 2017/3/6.
 */
public class Orders {
    private Integer id;
    private String sn;       // 订单编号
    private String remark;   // 订单描述

    public Integer getId() {
        return id;
    }

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

    public String getSn() {
        return sn;
    }

    public void setSn(String sn) {
        this.sn = sn;
    }

    public String getRemark() {
        return remark;
    }

    public void setRemark(String remark) {
        this.remark = remark;
    }
}

第三步：创建 CustomerMapper.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="yeepay.payplus.mapper.CustomerMapper">
    <resultMap type="yeepay.payplus.domain.Customer" id="customerRM">
        <id property="id" column="ID"/>
        <result property="name" column="NAME"/>
    </resultMap>

    <!-- 配置关联关系 1:N -->
    <resultMap type="yeepay.payplus.domain.Customer" id="customerOrdersRM" extends="customerRM">
        <!-- 配置多的（N），property 属性就是实体中的 List 对象属性名称，ofType 属性就是集合元素的类型 -->
        <collection property="orders" ofType="yeepay.payplus.domain.Orders">
            <id property="id" column="ID"/>
            <result property="sn" column="SN"/>
            <result property="remark" column="REMARK"/>
        </collection>
    </resultMap>

    <!-- 查询，关联关系 Map 作为查询条件 -->
    <select id="find" parameterType="map" resultMap="customerOrdersRM">
        SELECT
            c.name,o.sn,o.remark
        FROM
            (SELECT id,name FROM customer) c
        LEFT JOIN
            (SELECT id,sn,remark,customer_id FROM orders) o
        ON c.id = o.customer_id
        WHERE c.name = #{customerName}
    </select>
</mapper>

在上面的映射文件中，咱们写了一个具有查询功能的 SQL 语句，但是程序还没有运行，咱们也不知道这个 SQL 语句写的是否正确，因此咱们可以先在数据库中试运行该 SQL 语句，看其是否能够实现多表关联的查询功能。运行示例及结果如下图所示：

由此可见，咱们写的 SQL 语句是正确的。

第四步：修改 sqlMapConfig.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>

    <!-- 赋别名 -->
    <typeAliases>
        <typeAlias type="yeepay.payplus.domain.Person" alias="Person"/>
    </typeAliases>

    <!-- 配置开发环境，可以配置多个，在具体用时再做切换 -->
    <environments default="">
        <environment id="test">
            <transactionManager type="JDBC"></transactionManager>    <!-- 事务管理类型：JDBC、MANAGED -->
            <dataSource type="POOLED">    <!-- 数据源类型：POOLED、UNPOOLED、JNDI -->
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/test?characterEncoding=utf-8" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
    </environments>

    <!-- 加载映射文件 mapper -->
    <mappers>
        <!-- 路径用 斜线（/） 分割，而不是用 点(.) -->
        <mapper resource="yeepay/payplus/mapper/UserMapper.xml"/>
        <mapper resource="yeepay/payplus/mapper/CustomerMapper.xml"/>
    </mappers>
</configuration>

在此处，细心的童鞋估计会发现咱们也没有修改什么（与前四篇博文中使用的配置文件相比），仅仅是在配置文件中添加了一个 mapper 标签，把 CustomerMapper.xml 映射文件配置进来而已。

第五步：创建 CeshiCustomer 测试类

package yeepay.payplus.test;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;
import yeepay.payplus.domain.Customer;

import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * Created by 维C果糖 on 2017/3/6.
 */
public class CeshiCustomer {
    @Test
    public void testFind() throws IOException {
        /**
         *  1、获得 SqlSessionFactory
         *  2、获得 SqlSession
         *  3、调用在 mapper 文件中配置的 SQL 语句
         */
        String resource = "sqlMapConfig.xml";           // 定位核心配置文件
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);    // 创建 SqlSessionFactory

        SqlSession sqlSession = sqlSessionFactory.openSession();    // 获取到 SqlSession

        Map map = new HashMap();
        map.put("customerName", "charies");

        // 调用 mapper 中的方法：命名空间 + id
        List<Customer> customerList = sqlSession.selectList("yeepay.payplus.mapper.CustomerMapper.find", map);

        for (Customer c : customerList) {
            System.out.println(c);
        }
    }
}

至此，MyBatis 框架中的关联映射（一对多）演示完成。不过有一点需要大家特别注意，那就是：在映射时，如果 SQL 查询语句出现了同名字段，那么 MyBatis 就会以第一个出现的字段为准，从而省略第二个同名字段的值，造成数据损失，因此在出现同名字段的时候，咱们可以保留第一个字段，再为其它同名字段分别起一个不同的别名来避免这种情况的发生。

---

———— ☆☆☆ —— 返回 -> 史上最简单的 MyBatis 教程 <- 目录 —— ☆☆☆ ————