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 mapperPUBLIC "-//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">SELECTc.name,o.sn,o.remarkFROM(SELECT id,name FROM customer) cLEFT JOIN(SELECT id,sn,remark,customer_id FROM orders) oON c.id = o.customer_idWHERE c.name = #{customerName}</select>
</mapper>

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

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

第四步：修改 sqlMapConfig.xml 配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//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 {@Testpublic 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);    // 创建 SqlSessionFactorySqlSession sqlSession = sqlSessionFactory.openSession();    // 获取到 SqlSessionMap map = new HashMap();map.put("customerName", "charies");// 调用 mapper 中的方法：命名空间 + idList<Customer> customerList = sqlSession.selectList("yeepay.payplus.mapper.CustomerMapper.find", map);for (Customer c : customerList) {System.out.println(c);}}
}

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

---

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