【mybatis】关联查询

微雨渐落 2017-12-07

展开全文

一、数据库

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

1. 数据库设计

[html] view plain copy

print?

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

[html] view plain copy

print?

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，此处假设的业务逻辑是一个号码存在多个用户。

用例数据：

[html] view plain copy

print?

id,username,password,gender,age,phoneID
1,zhangsan,123,male,18,2
2,lisi,123,female,24,2
id,phoneNum
2,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>体现关联关系，示例代码如下。

[html] view plain copy

print?

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;
}
@Override
public String toString() {
return "Person [id=" + id + ", username=" + username + ", password="
+ password + ", gender=" + gender + ", age=" + age
+ ", phoneID=" + phoneID + "]";
}
}

[html] view plain copy

print?

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;
}
@Override
public String toString() {
return "Phone [id=" + id + ", phoneNum=" + phoneNum + "--------- persons="
+ persons + "]";
}
}

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

[html] view plain copy

print?

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);
}

[html] view plain copy

print?

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;
@Before
public void setUp(){
try {
factory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
} catch (IOException e) {
e.printStackTrace();
}
}
@Test
public 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配置和测试代码如下。

[html] view plain copy

print?

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-////DTD Mapper 3.0//EN"
"http:///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中。详细过程，通过打印日志也可窥见一斑。

[html] view plain copy

print?

2015-04-29 16:02:15,188 DEBUG JdbcTransaction:132 - Opening JDBC Connection
2015-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: 2
2015-04-29 16:02:15,622 DEBUG select:139 - <== Total: 1
Phone [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配置文件内容如下。

[html] view plain copy

print?

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-////DTD Mapper 3.0//EN"
"http:///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 per
where 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的数据。

[html] view plain copy

print?

2015-04-29 16:24:37,892 DEBUG JdbcTransaction:132 - Opening JDBC Connection
2015-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: 2
Phone [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在做结果映射的时候会发现两次的映射主键是一样的，因此第二条记录就不会被映射了。正确执行结果如下所示。

[html] view plain copy

print?

2015-04-29 18:27:42,758 DEBUG JdbcTransaction:132 - Opening JDBC Connection
2015-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: 2
Phone [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做结果映射的时候有可能发生异常，需要取别名；