MyBatis从入门到精通(十一):MyBatis高级结果映射之一对多映射
最近在读刘增辉老师所著的《mybatis从入门到精通》一书,很有收获,于是将自己学习的过程以博客形式输出,如有错误,欢迎指正,如帮助到你,不胜荣幸!
本篇博客主要讲解mybatis中如何使用collection标签实现查询结果一对多映射。
1. 使用collection标签
需求:根据用户id查询用户信息的同时获取用户拥有的角色,一个用户可以拥有1个或多个角色。
一般情况下,不建议直接修改数据库表对应的实体类。
所以这里我们延用之前博客中新建的类sysuserextend,并添加如下代码,如下所示:
/** * 用户的角色集合 */ private list<sysrole> sysrolelist; public list<sysrole> getsysrolelist() { return sysrolelist; } public void setsysrolelist(list<sysrole> sysrolelist) { this.sysrolelist = sysrolelist; }
然后,我们在接口sysusermapper中添加如下方法:
/** * 获取所有的用户以及对应的所有角色 * * @return */ list<sysuserextend> selectalluserandroles();
接着,在对应的sysusermapper.xml中添加如下代码:
<resultmap id="userrolelistmap" type="com.zwwhnly.mybatisaction.model.sysuserextend" extends="sysusermap"> <collection property="sysrolelist" columnprefix="role_" oftype="com.zwwhnly.mybatisaction.model.sysrole"> <id property="id" column="id"/> <result property="rolename" column="role_name"/> <result property="enabled" column="enabled"/> <result property="createby" column="create_by"/> <result property="createtime" column="create_time" jdbctype="timestamp"/> </collection> </resultmap>
因为我们在前面的博客中已经建过角色表的rolemap:
<resultmap id="rolemap" type="com.zwwhnly.mybatisaction.model.sysrole"> <id property="id" column="id"/> <result property="rolename" column="role_name"/> <result property="enabled" column="enabled"/> <result property="createby" column="create_by"/> <result property="createtime" column="create_time" jdbctype="timestamp"/> </resultmap>
所以上面的collection标签可以简化为:
<collection property="sysrolelist" columnprefix="role_" resultmap="com.zwwhnly.mybatisaction.mapper.sysrolemapper.rolemap"> </collection>
新建接口对应的查询代码,使用上面新建的userrolelistmap,如下所示:
<select id="selectalluserandroles" resultmap="userrolelistmap"> select u.id, u.user_name, u.user_password, u.user_email, u.create_time, r.id role_id, r.role_name role_role_name, r.enabled role_enabled, r.create_by role_create_by, r.create_time role_create_time from sys_user u inner join sys_user_role ur on u.id = ur.user_id inner join sys_role r on ur.role_id = r.id </select>
最后,在sysusermappertest测试类中添加如下测试方法:
@test public void testselectalluserandroles() { sqlsession sqlsession = getsqlsession(); try { sysusermapper sysusermapper = sqlsession.getmapper(sysusermapper.class); list<sysuserextend> sysuserlist = sysusermapper.selectalluserandroles(); system.out.println("用户数:" + sysuserlist.size()); for (sysuserextend sysuser : sysuserlist) { system.out.println("用户名:" + sysuser.getusername()); for (sysrole sysrole : sysuser.getsysrolelist()) { system.out.println("角色名:" + sysrole.getrolename()); } } } finally { sqlsession.close(); } }
运行测试代码,测试通过,输出日志如下:
debug [main] - ==> preparing: select u.id, u.user_name, u.user_password, u.user_email, u.create_time, r.id role_id, r.role_name role_role_name, r.enabled role_enabled, r.create_by role_create_by, r.create_time role_create_time from sys_user u inner join sys_user_role ur on u.id = ur.user_id inner join sys_role r on ur.role_id = r.id
debug [main] - ==> parameters:
trace [main] - <== columns: id, user_name, user_password, user_email, create_time, role_id, role_role_name, role_enabled, role_create_by, role_create_time
trace [main] - <== row: 1, admin, 123456, admin@mybatis.tk, 2019-06-27 18:21:07.0, 1, 管理员, 1, 1, 2019-06-27 18:21:12.0
trace [main] - <== row: 1, admin, 123456, admin@mybatis.tk, 2019-06-27 18:21:07.0, 2, 普通用户, 1, 1, 2019-06-27 18:21:12.0
trace [main] - <== row: 1001, test, 123456, test@mybatis.tk, 2019-06-27 18:21:07.0, 2, 普通用户, 1, 1, 2019-06-27 18:21:12.0
debug [main] - <== total: 3
用户数:2
用户名:admin
角色名:管理员
角色名:普通用户
用户名:test
角色名:普通用户
2. mybatis合并规则
观察上面的日志,我们的sql语句查询到了3条数据,在数据库查询的话,也是返回如下的数据:
但经过mybatis配置的映射到,最后合并为了2个用户,其中第1个用户包含了2个角色,第2个用户包含了1个角色,那么mybatis是根据什么规则合并的呢?
mybatis在处理结果的时候,会判断结果是否相同,如果是相同的结果,则只会保留第一个结果,所以关键点就是mybatis如何判断结果是否相同。
判断结果是否相同时,最简单的情况就是在映射配置中至少有1个id标签,上面使用的sysusermap就配置了id标签:
<id property="id" column="id"/>
一般情况下,id标签配置的字段为表的主键,如果是联合主键,可以配置多个id标签。
id标签的作用就是在嵌套的映射配置时判断数据是否相同,当配置id标签时,mybatis只需要逐条比较所有数据中id标签配置的字段值是否相同即可。
也可以不配置id标签,将上面的代码修改为:
<result property="id" column="id"/>
使用result不会影响查询结果,但是此时mybatis就要对所有字段进行比较,因此当字段数为m时,如果查询结果有n条,就需要比较m*n次,如果配置了id标签,只需要比较n次即可,所以要尽可能的配置id标签。
结合上面的例子,因为sql的查询结果中,前2条数据中用户的id是相同的,所以会合并为1个用户,所以最终的结果是2个用户。
为了更清楚的理解id标签的作用,我们将sysusermap临时修改为:
<resultmap id="sysusermap" type="com.zwwhnly.mybatisaction.model.sysuser"> <id property="userpassword" column="user_password"/> <result property="id" column="id"/> <result property="username" column="user_name"/> <result property="useremail" column="user_email"/> <result property="userinfo" column="user_info"/> <result property="headimg" column="head_img" jdbctype="blob"/> <result property="createtime" column="create_time" jdbctype="timestamp"/> </resultmap>
运行测试方法,输出的部分日志如下:
用户数:1
用户名:admin
角色名:管理员
角色名:普通用户
因为3个用户的密码都是123456,所以查询到的3条数据只保留了第一个用户admin,包含了2个角色。
有的同学也许会问,为什么不是拥有3个角色呢?
这是因为mybatis会对嵌套查询的每一级对象都进行属性比较,mybatis会先比较顶层的对象,如果sysuser部分相同,就继续比较sysrole部分,如果sysrole不同,就会增加一个sysrole,如果相同就保留前一个。
如果sysrole还有下一级,依次按照规则去比较。
上面的“普通用户”角色重复了,所以只保留了前1个,导致最终的结果中只包含2个角色而不是3个。
3. 源码及参考
源码地址:,欢迎下载。
刘增辉《mybatis从入门到精通》
4. 最后
打个小广告,欢迎扫码关注微信公众号:「申城异乡人」,不定期分享java技术干货,让我们一起进步。