MyBatis从入门到精通(第6章)：MyBatis 高级查询->6.1.2高级结果映射之一对多映射
jdk1.8、MyBatis3.4.6、MySQL数据库5.6.45、IntelliJ IDEA 2019.3.1
本章主要包含的内容为 MyBatis 的高级结果映射，主要处理数据库一对一、一对多的查询，另外就是在 MyBatis 中使用存储过程的方法，处理存储过程的入参和出参方法，最后会介绍 Java 中的枚举方法和数据库表字段的处理方法。
6.1 高级结果映射
在关系型数据库中，我们经常要处理一对一、一对多的关系。
在 RBAC 权限系统中还存在着一个用户拥有多个角色、一个角色拥有多个权限这样复杂的嵌套关系。使用已经学会的 MyBatis 技巧都可以轻松地解决这种复杂的关系。在面对这种关系的时候，我们可能要写多个方法分别查询这些数据，然后再组合到一起。这种处理方式特别适合用在大型系统上，由于分库分表，这种用法可以减少表之间的关联查询，方便系统进行扩展。
但是在一般的企业级应用中，使用 MyBatis 的高级结果映射便可以轻松地处理这种一对一、一对多的关系。
一对多映射只有两种配置方式，都是使用 collection 标签进行的，下面来看具体的介绍。
在 RBAC 权限系统中，一个用户拥有多个角色（注意，使用association 是设定的特例，限制一个用户只有一个角色），每个角色又是多个权限的集合，所以要渐进式地去实现一个 SQL，查询出所有用户和用户拥有的角色，以及角色所包含的所有权限信息的两层嵌套结果。
先来看如何实现一层嵌套的结果，为了能够存储一对多的数据，先对 SysUser 类进行修改，代码如下。
在 SysUser 类中增加 roleList 属性用于存储用户对应的多个角色。
在 UserMapper.xml 中创建 resultMap ，代码如下。
和 6.1.1.3 中的方式对比会很容易发现，此处就是把 association 改成了 collection ，然后将 property 设置为了 roleList，其他的 id 和 result 的配置都还一样。仔细想想应该不难理解，collection 用于配置一对多关系，对应的属性必须是对象中的集合类型，因此这里是 roleList。另外，resultMap 只是为了配置数据库字段和实体属性的映射关系，因此其他都一样。同时能存储一对多的数据结构肯定也能存储一对一关系，所以一对一像是一对多的一种特例。collection 支持的属性以及属性的作用和association 完全相同。
上一节中，我们逐步对 resultMap 进行了简化，在这一节，因为有了上一节的基础，因此可以大刀阔斧地对这个 resultMap 进行快速简化。首先，SysUser 中的属性可以直接通过继承 userMap 来使用 sys_user 的映射关系，其次在 RoleMapper.xml 中的 roleMap 映射包含了 sys_role 的映射关系，因此可以直接引用 roleMap，经过这两个方式的简化，最终的userRoleListMap 如下。
仿照上一节的 selectUserAndRoleById 2 方法，创建selectAllUserAndRoles 方法，代码如下。
这个方法用于查询所有用户及其对应的角色，sys_role 对应的查询列都增加了以“role_”作为前缀的别名。
在 UserMapper 接口中增加如下的对应方法。
/** * 获取所有的用户以及对应的所有角色 * * @return */ List<SysUser> selectAllUserAndRoles();
针对该方法，在 UserMapperTest 中添加如下测试。
从上图已经可以看到，第一个用户拥有两个角色，实现了一对多的查询。再来看一下测试代码输出的日志。
通过日志可以清楚地看到，SQL 执行的结果数有 3 条，后面输出的用户数是 2，也就是说本来查询出的 3 条结果经过 MyBatis 对 collection 数据的处理后，变成了两条。
提示！
在嵌套结果配置 id 属性时，如果查询语句中没有查询 id 属性配置的列，就会导致 id 对应的值为 null。
这种情况下，所有值的 id 都相同，因此会使嵌套的集合中只有一条数据。所以在配置 id 列时，查询语句中必须包含该列。
在 RBAC 权限系统中，除了一个用户对应多个角色外，每一个角色还会对应多个权限。所以在现有例子的基础上可以再增加一级，获取角色对应的所有权限。
如果在 PrivilegeMapper.xml 中没有 privilegeMap 映射配置，就在该配置文件中添加如下代码。
<resultMap id="privilegeMap" type="tk.mybatis.simple.model.SysPrivilege"> <id property="id" column="id"/> <result property="privilegeName" column="privilege_name"/> <result property="privilegeUrl" column="privilege_url"/> </resultMap>
然后在 SysRole 类中添加如下属性和方法。
/** * 角色包含的权限列表 */ List<SysPrivilege> privilegeList; public List<SysPrivilege> getPrivilegeList() { return privilegeList; } public void setPrivilegeList(List<SysPrivilege> privilegeList) { this.privilegeList = privilegeList; }
在 RoleMapper.xml 文件中，增加如下 resultMap 配置。
<resultMap id="rolePrivilegeListMap" extends="roleMap" type="tk.mybatis.simple.model.SysRole"> <collection property="privilegeList" columnPrefix="privilege_" resultMap="tk.mybatis.simple.mapper.PrivilegeMapper.privilegeMap"/> </resultMap>
我们创建了角色权限映射，继承了 roleMap，嵌套了 privilegeList 属性，直接使用了 PrivilegeMapper.xml 中的 privilegeMap 。
最后还要修改 UserMapper.xml 中的 userRoleListMap ，代码如下。
完成以上步骤就配置好了一个两层嵌套的映射。为了得到权限信息，还需要修改 SQL 进行关联，代码如下。
<select id="selectAllUserAndRoles" resultMap="userRoleListMap"> select u.id, u.user_name, u.user_password, u.user_email, u.user_info, u.head_img, 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, p.id role_privilege_id, p.privilege_name role_privilege_privilege_name, p.privilege_url role_privilege_privilege_url 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 inner join sys_role_privilege rp on rp.role_id = r.id inner join sys_privilege p on p.id = rp.privilege_id </select>
这里要特别注意 sys_ privilege 表中列的别名，因为 sys_ privilege 嵌套在 rolePrivilegeListMap 中，而 rolePrivilegeListMap 的前缀是“role_”，所以 rolePrivilegeListMap 中 privilegeMap 的前缀就变成了“role_privilege_”。在嵌套中，这个前缀需要叠加，一定不要写错。
为了加深印象，利用上面的 rolePrivilegeListMap 实现一个查询角色和对应权限的方法。在 RoleMapper.xml 中添加如下方法。
<select id="selectAllRoleAndPrivileges" resultMap="rolePrivilegeListMap"> select r.id, r.role_name, r.enabled, r.create_by, r.create_time, p.id privilege_id, p.privilege_name privilege_privilege_name, p.privilege_url privilege_privilege_url from sys_role r inner join sys_role_privilege rp on rp.role_id = r.id inner join sys_privilege p on p.id = rp.privilege_id </select>
在这个方法中，大家需要注意 sys_ privilege 对应列的别名，请自行在 RoleMapper 中添加对应的接口，并且在 RoleMapperTest 中添加该方法的测试。
此处通过使用 rolePrivilegeListMap ，大家可以了解这样一个映射配置：它不仅可以被嵌套的配置引用，其本身也可以使用。一个复杂的映射就是由这样一个基本的映射配置组成的。通常情况下，如果要配置一个相当复杂的映射，一定要从基础映射开始配置，每增加一些配置就进行对应的测试，在循序渐进的过程中更容易发现和解决问题。
虽然 association 和 collection 标签是分开介绍的，但是这两者可以组合使用或者互相嵌套使用，也可以使用符合自己需要的任何数据结构，不需要局限于数据库表之间的关联关系。
6.1.2.2 collection 集合的嵌套查询
仍然以关联的嵌套结果中的 selectAllUserAndRoles 为基础，以上一节最后的两层嵌套结果为目标，将该方法修改为集合的嵌套查询方式。
面以自下而上的过程来实现这样一个两层嵌套的功能，并且这个自下而上的过程中的每一个方法都是一个独立可用的方法，最后的结果都是以前一个方法为基础的。把所有对象设置为延迟加载，因此每个方法都可以单独作为一个普通（没有嵌套）的查询存在。
首先在 PrivilegeMapper.xml 中添加如下方法。
<select id="selectPrivilegeByRoleId" resultMap="privilegeMap"> select p.* from sys_privilege p inner join sys_role_privilege rp on rp.privilege_id = p.id where role_id = #{roleId} </select>
这个方法通过角色 id 获取该角色对应的所有权限信息，可以在PrivilegeMapper 接口中增加相应的方法。这是一个很常见的方法，许多时候都需要这样一个方法来获取角色包含的所有权限信息。
下一步，在 RoleMapper.xml 中配置映射和对应的查询方法，代码如下。
在上面代码中要注意 column 属性配置的{roleId=id}，roleId 是 select 指定方法 selectPrivilegeByRoleId 查询中的参数，id 是当前查询selectRoleByUserId 中查询出的角色 id。selectRoleByUserId 是一个只有一层嵌套的一对多映射配置，通过调用 PrivilegeMapper 的selectPrivilegeByRoleId 方法，很轻易就实现了嵌套查询的功能。针对这个方法，大家也要添加相应的接口方法进行测试。
终于要轮到顶层的用户信息了，在 UserMapper.xml 中添加如下映射和查询，代码如下。
<resultMap id="userRoleListMapSelect" extends="userMap" type="tk.mybatis.simple.model.SysUser"> <collection property="roleList" fetchType="lazy" select="tk.mybatis.simple.mapper.RoleMapper.selectRoleByUserId" column="{userId=id}"/> </resultMap>
<select id="selectAllUserAndRolesSelect" resultMap="userRoleListMapSelect"> select u.id, u.user_name, u.user_password, u.user_email, u.user_info, u.head_img, u.create_time from sys_user u where u.id = #{id} </select>
这里也需要注意，collection 的属性 column 配置为{userId=id}，将当前查询用户中的 id 赋值给 userId，使用 userId 作为参数再进行selectRoleByUserId 查询。因为所有嵌套查询都配置为延迟加载，因此不存在 N+1 的问题。
在 UserMapper 接口中添加如下方法。
/** * 通过嵌套查询获取指定用户的信息，以及用户的角色和权限信息 * * @param id * @return */ SysUser selectAllUserAndRolesSelect(Long id);
然后在 UserMapperTest 中添加相应的测试，代码如下。
@Test public void testSelectAllUserAndRolesSelect(){ //获取 sqlSession SqlSession sqlSession = getSqlSession(); try { //获取 UserMapper 接口 UserMapper userMapper = sqlSession.getMapper(UserMapper.class); SysUser user = userMapper.selectAllUserAndRolesSelect(1L); System.out.println("用户名：" + user.getUserName()); for(SysRole role: user.getRoleList()){ System.out.println("角色名：" + role.getRoleName()); for(SysPrivilege privilege : role.getPrivilegeList()){ System.out.println("权限名：" + privilege.getPrivilegeName()); } } } finally { //不要忘记关闭 sqlSession sqlSession.close(); } }
由于这里是多层嵌套，并且是延迟加载，因此这段测试会输出很长的日志，日志如下。
简单分析这段日志，当执行 selectAllUserAndRolesSelect 方法后，可以得到 admin 用户的信息，由于延迟加载，此时还不知道该用户有几个角色。当调用 user.getRoleList （）方法进行遍历时，MyBatis 执行了第一层的嵌套查询，查询出了该用户的两个角色。对这两个角色进行遍历获取角色对应的权限信息，因为已经有两个角色，所以分别对两个角色进行遍历时会查询两次角色的权限信息。特别需要注意的是，之所以可以根据需要查询数据，除了和 fetchType 有关，还和全局的aggressiveLazyLoading 属性有关，这个属性在介绍 association 时被配置成了 false，所以才会起到按需加载的作用。
6.1.3 鉴别器映射
鉴别器是一种很少使用的方式，在使用前一定要完全掌握，没有把握的情况下要尽可能避免使用。
===========================================================
end
