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 教程 <- 目录 —— ☆☆☆ ————