【mybatis】关联查询——mybatis一对多两种方式实现详解

一、数据库

        演示的小demo涉及两张表，一张是Person表，记录用户基本信息，另一张是phone表，记录电话号码，Person的phoneID外键关联phone表id。此处示例涉及并不符合实际情况，一对多方式是一个号码有多个用户使用的（更符合实际情况的是一个用户有多个号码），原因是从一对一demo直接扒拉过来用的，见谅，不过也能体现mybatis关联查询一对多的细节了。

1. 数据库设计

CREATE TABLE `tbl_person` (   `id` int(11) NOT NULL AUTO_INCREMENT,   `username` varchar(30) NOT NULL,   `password` varchar(30) NOT NULL,   `gender` varchar(30) DEFAULT NULL,   `age` int(11) DEFAULT NULL,   `phoneID` int(11) DEFAULT NULL,   PRIMARY KEY (`id`),   UNIQUE KEY `id` (`id`),   UNIQUE KEY `username` (`username`),   KEY `per_pho_fk` (`phoneID`),   CONSTRAINT `per_pho_fk` FOREIGN KEY (`phoneID`) REFERENCES `tbl_phone` (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8

CREATE TABLE `tbl_phone` (   `id` int(11) NOT NULL AUTO_INCREMENT,   `phoneNum` varchar(11) NOT NULL,   PRIMARY KEY (`id`),   UNIQUE KEY `phoneNum` (`phoneNum`) ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8

2. 数据库补充

        phoneID作为tbl_person的外键，关联tbl_phone的主键id，此处假设的业务逻辑是一个号码存在多个用户。

        用例数据：

id,username,password,gender,age,phoneID1,zhangsan,123,male,18,22,lisi,123,female,24,2id,phoneNum2,15200898242

二、一对多两种方式详解

        通过phone id查询电话信息，并关联查询拥有该电话的Person信息列表，一种方式是先查询tbl_phone表，获取到phone id，再通过phone id从tbl_person表中查询Person信息列表，这种方式要和数据库交互两次，发出两次sql语句，但是数据库返回的数据没有冗余；另一种方式是直接关联查询，只与数据库交互一次，只发出一次sql语句，但是数据库返回数据存在主表信息冗余，冗余数据为主表内容，冗余次数为从表中满足条件的记录数。

        因此，应该选择哪一种方式更合理，需要根据具体的业务场景来选择，没有绝对的正确，只有相对的适合。

        两种方式的实现，最核心的差异在于mapper.xml配置文件，完整的示例工程，需要mybatis-config.xml以及log4j的配置文件等，此处不一一列举出来，在第三部分附上完整代码download地址，此处仅仅关注核心问题——实现以及差异。两种方式的po类相同，主要关注Phone类中通过List<Person>体现关联关系，示例代码如下。

package cn.wxy.domain;import java.io.Serializable;public class Person implements Serializable {private static final long serialVersionUID = 6028193740527306730L;private Integer id;private String username;private String password;private String gender;private Integer age;private Integer phoneID;public Person() {}public Person(Integer id, String username, String password, String gender,Integer age, Integer phoneID) {super();this.id = id;this.username = username;this.password = password;this.gender = gender;this.age = age;this.phoneID = phoneID;}public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getUsername() {return username;}public void setUsername(String username) {this.username = username;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}public String getGender() {return gender;}public void setGender(String gender) {this.gender = gender;}public Integer getAge() {return age;}public void setAge(Integer age) {this.age = age;}public Integer getPhoneID() {return phoneID;}public void setPhoneID(Integer phoneID) {this.phoneID = phoneID;}@Overridepublic String toString() {return "Person [id=" + id + ", username=" + username + ", password="+ password + ", gender=" + gender + ", age=" + age+ ", phoneID=" + phoneID + "]";}}

package cn.wxy.domain;import java.io.Serializable;import java.util.List;public class Phone implements Serializable {/** *  */private static final long serialVersionUID = 3929743268466303948L;private Integer id;private String phoneNum;private List<Person> persons;public Phone() {}public Phone(Integer id, String phoneNum) {super();this.id = id;this.phoneNum = phoneNum;}public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getPhoneNum() {return phoneNum;}public void setPhoneNum(String phoneNum) {this.phoneNum = phoneNum;}public List<Person> getPersons() {return persons;}public void setPersons(List<Person> persons) {this.persons = persons;}@Overridepublic String toString() {return "Phone [id=" + id + ", phoneNum=" + phoneNum + "--------- persons="+ persons + "]";}}

        mybatis有两种方式和数据库进行交互，一种是基于statement id的方式（映射需要提供get/set方法），另一种是基于mapper接口的方式（最后mapper接口也是调用Statement id方式，但是其映射只需要属性名和数据库字段名匹配即可），本处采用mapper接口方式作为测试代码与数据库进行交互。 两种方式的dao接口和测试代码也一样，不作为核心关注点，在此处列出。

package cn.wxy.dao;import java.util.List;import cn.wxy.domain.Person;import cn.wxy.domain.Phone;public interface PersonDao {/** * 根据phone id获取phone的信息，并把关联的Person对象查询出来 * @param id * @return */Phone select(Integer id);}

package cn.wxy.test;import java.io.IOException;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.Before;import org.junit.Test;import cn.wxy.dao.PersonDao;import cn.wxy.domain.Phone;public class PhoneTest {private SqlSessionFactory factory;@Beforepublic void setUp(){try {factory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));} catch (IOException e) {e.printStackTrace();}}@Testpublic void test() {SqlSession session = factory.openSession();PersonDao dao = session.getMapper(PersonDao.class);Phone phone = dao.select(2);System.out.println(phone);session.close();}}

1. 第一种方式

        此种方式需要查询数据库两次，发出两次sql语句，一次是查询tbl_phone表，一次是查询tbl_person表，但是数据库返回的信息没有冗余，mapper.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="cn.wxy.dao.PersonDao"><resultMap type="Phone" id="selectPhomap"><id property="id" column="id"/><result property="phoneNum" column="phoneNum"/><collection property="persons" ofType="Person" select="selectPer" column="id"><id property="id" column="id"/><result property="username" column="username"/><result property="password" column="password"/><result property="gender" column="gender"/><result property="age" column="age"/><result property="phoneID" column="phoneID"/></collection></resultMap><select id="select" parameterType="int" resultMap="selectPhomap">select * from tbl_phone where id=#{id}</select><select id="selectPer" parameterType="int" resultType="Person">select * from tbl_person where phoneID=#{phoneID}</select></mapper>

        用直白的话来描述此种方式，在调用mapper接口中的select方法，先走语句“select * from tbl_phone where id=#{id}”，从数据库中拿到返回数据之后，开始做返回值映射，此时的返回值映射对象是一个resultMap（id:selectPhomap），该resultMap实际上是一个Phone实例，因此在开始做映射的时候，id和phoenNum因为属性名和数据库返回值一致完成映射，但是到了persons属性的时候，发现他是一个collection集合对象，里面存放的是Person实例，那怎么获取里面的数据？看collection标签的属性，他需要关联一个查询操作select="selectPer"获取其数据，即通过select * from tbl_person where phoneID=#{phoneID}获取collection中的数据，select="selectPer"操作需要传入数据，传入的数据column="id"即是第一次查询中返回的phone id，这个在这里显得不明显，在第二种方式中会更加的明显，这里也是mybatis关联查询的核心点，最后一步，就是将第二次查询出来的数据映射到collection中。详细过程，通过打印日志也可窥见一斑。

2015-04-29 16:02:15,188 DEBUG JdbcTransaction:132 - Opening JDBC Connection2015-04-29 16:02:15,536 DEBUG PooledDataSource:380 - Created connection 22429093.2015-04-29 16:02:15,537 DEBUG JdbcTransaction:98 - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@1563da5]2015-04-29 16:02:15,539 DEBUG select:139 - ==>  Preparing: select * from tbl_phone where id=? //第一次发出sql语句2015-04-29 16:02:15,586 DEBUG select:139 - ==> Parameters: 2(Integer)2015-04-29 16:02:15,616 DEBUG selectPer:139 - ====>  Preparing: select * from tbl_person where phoneID=? //第二次发出sql语句2015-04-29 16:02:15,617 DEBUG selectPer:139 - ====> Parameters: 2(Integer)//关注点：第二次查询参数的传入2015-04-29 16:02:15,621 DEBUG selectPer:139 - <====      Total: 22015-04-29 16:02:15,622 DEBUG select:139 - <==      Total: 1Phone [id=2, phoneNum=15200898242, persons=[Person [id=1, username=zhangsan, password=123, gender=male, age=18, phoneID=2], Person [id=2, username=lisi, password=123, gender=female, age=24, phoneID=2]]]2015-04-29 16:02:15,623 DEBUG JdbcTransaction:120 - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@1563da5]2015-04-29 16:02:15,624 DEBUG JdbcTransaction:88 - Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@1563da5]2015-04-29 16:02:15,625 DEBUG PooledDataSource:334 - Returned connection 22429093 to pool.

        总结：

        1. 将查询操作拆成两步来完成；

        2. 核心点：第二次查询操作传入的数据通过collection的属性column来传入，此时column的value需要和第一次查询中的返回值做映射，映射的规则是数据库返回值的name和属性name相等；

2. 第二种方式

        此种方式只需要查询数据库一次，发出一次sql语句，但是数据库返回值存在冗余，冗余内容为phone的信息，冗余次数是Person中使用统一电话的人的个数。mapper.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="cn.wxy.dao.PersonDao"><resultMap type="Phone" id="selectPhomap"><id property="id" column="phoID"/><result property="phoneNum" column="phoneNum"/><collection property="persons" ofType="Person"><id property="id" column="id"/><result property="username" column="username"/><result property="password" column="password"/><result property="gender" column="gender"/><result property="age" column="age"/><result property="phoneID" column="phoneID"/></collection></resultMap><select id="select" parameterType="int" resultMap="selectPhomap">select pho.id phoID, pho.phoneNum, per.* from tbl_phone pho, tbl_person perwhere pho.id=#{id}and pho.id=per.phoneID</select></mapper>

        通过此种方式实现关联查询，sql语句执行的返回值就已经包含了所有需要映射的数据，不需要再进行二次查询，但是存在一个问题，就是两张表的id字段的命名是一样的，所以在做关联查询的时候，需要将其中一个取别名以示区别，否则在映射的时候会出现不和实际情况的异常——sql和参数映射的时候是正确的，解析也是正确的，到数据库执行是正确的，数据库的返回值也是正确的，但是sql返回的是多条完整的数据记录，在做返回值映射的时候，因为phone和Person的主键都是id，一开始做映射的时候都被赋予值2，因为已经映射过了，所以第二条数据就不会在被映射。如以下所示的错误信息，person的信息其实是person.id=1的信息，但是其id=2，其他的信息都是id=1的数据。

2015-04-29 16:24:37,892 DEBUG JdbcTransaction:132 - Opening JDBC Connection2015-04-29 16:24:38,194 DEBUG PooledDataSource:380 - Created connection 289639718.2015-04-29 16:24:38,195 DEBUG JdbcTransaction:98 - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@11438d26]2015-04-29 16:24:38,198 DEBUG select:139 - ==>  Preparing: select pho.id, pho.phoneNum, per.* from tbl_phone pho, tbl_person per where pho.id=? and pho.id=per.phoneID 2015-04-29 16:24:38,239 DEBUG select:139 - ==> Parameters: 2(Integer)2015-04-29 16:24:38,290 DEBUG select:139 - <==      Total: 2Phone [id=2, phoneNum=15200898242--------- persons=[Person [id=2, username=zhangsan, password=123, gender=male, age=18, phoneID=2]]]2015-04-29 16:24:38,292 DEBUG JdbcTransaction:120 - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@11438d26]2015-04-29 16:24:38,293 DEBUG JdbcTransaction:88 - Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@11438d26]2015-04-29 16:24:38,293 DEBUG PooledDataSource:334 - Returned connection 289639718 to pool.

        实际上要想了解此种方式的异常原因，需要从数据库返回值入手，在数据库中直接执行mapper.xml中的sql语句，其返回的数据组织情况如下图所示。

        如果没有修改其中某一个id别名，那么mybatis在做结果映射的时候会发现两次的映射主键是一样的，因此第二条记录就不会被映射了。正确执行结果如下所示。

2015-04-29 18:27:42,758 DEBUG JdbcTransaction:132 - Opening JDBC Connection2015-04-29 18:27:43,117 DEBUG PooledDataSource:380 - Created connection 22429093.2015-04-29 18:27:43,117 DEBUG JdbcTransaction:98 - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@1563da5]2015-04-29 18:27:43,133 DEBUG select:139 - ==>  Preparing: select pho.id phoID, pho.phoneNum, per.* from tbl_phone pho, tbl_person per where pho.id=? and pho.id=per.phoneID 2015-04-29 18:27:43,164 DEBUG select:139 - ==> Parameters: 2(Integer)2015-04-29 18:27:43,211 DEBUG select:139 - <==      Total: 2Phone [id=2, phoneNum=15200898242--------- persons=[Person [id=1, username=zhangsan, password=123, gender=male, age=18, phoneID=2], Person [id=2, username=lisi, password=123, gender=female, age=24, phoneID=2]]]2015-04-29 18:27:43,211 DEBUG JdbcTransaction:120 - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@1563da5]2015-04-29 18:27:43,211 DEBUG JdbcTransaction:88 - Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@1563da5]2015-04-29 18:27:43,211 DEBUG PooledDataSource:334 - Returned connection 22429093 to pool.

        总结：

        1. 查询一步完成，关注sql的编写；

        2. 注意sql返回之中是否存在同名的列，如果存在同名列，则mybatis做结果映射的时候有可能发生异常，需要取别名；

三、编码实现

1. 第一种实现方式

        示例代码下载：点击打开链接

2. 第二种实现方式

        示例代码下载：点击打开链接

附注：

        本文如有错漏，烦请不吝指正，谢谢！

        示例代码简陋，包涵！