MyBatis/Ibatis框架，resultMap标签中association子标签中resultMap属性使用。

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/dear_Alice_moon/article/details/88380870

       本文主要讲解 SysUserMapper.xml文件中，resultMap标签下的 association子标签调用 SysRoleMapper.xml文件时的一些框架缺陷。 SysUserMapper.xml文件中，resultMap标签下的 association子标签调用 SysRoleMapper.xml文件中的resultMap标签时，被调用的 SysRoleMapper.xml的resultMap标签的id值必须为： BaseResultMap 。

       下面是一个小例子，请详细观看 SysUserMapper.xml文件、SysRoleMapper.xml文件中的相关配置。

                                                                                      项目目录图片

1、 SysUser.java、SysRole.java 实体类如下，此处省略 get()、set()函数

       

       SysUser.java实体类：   

package com.moon.mybatis.pojo;

import java.util.Arrays;
import java.util.Date;

public class SysUser {
    /**
     * 用户ID
     * 
     * id
     */
    private Long id;

    /**
     * 用户名
     * 
     * user_name
     */
    private String userName;

    /**
     * 密码
     * 
     * user_password
     */
    private String userPassword;

    /**
     * 邮箱
     * 
     * user_email
     */
    private String userEmail;

    /**
     * 创建时间
     * 
     * create_time
     */
    private Date createTime;

    /**
     * 简介
     * 
     * user_info
     */
    private String userInfo;

    /**
     * 头像
     * 
     * head_img
     */
    private byte[] headImg;
    
    /**
     * 用户角色 
     */
    private SysRole sysRole;
    

    /**
     * 重写 toString()函数 
     */
	@Override
	public String toString() {
		return "SysUser [id=" + id + ", userName=" + userName + ", userPassword=" + userPassword + ", userEmail="
				+ userEmail + ", createTime=" + createTime + ", userInfo=" + userInfo + ", headImg="
				+ Arrays.toString(headImg) + ", sysRole=" + sysRole + "]";
	}
	
	/**
	 * 全参构造函数，包含sysRole属性. 
	 * 
	 * @param id
	 * @param userName
	 * @param userPassword
	 * @param userEmail
	 * @param createTime
	 * @param userInfo
	 * @param headImg
	 * @param sysRole
	 */
	public SysUser(Long id, String userName, String userPassword, String userEmail, Date createTime, String userInfo,
			byte[] headImg, SysRole sysRole) {
		super();
		this.id = id;
		this.userName = userName;
		this.userPassword = userPassword;
		this.userEmail = userEmail;
		this.createTime = createTime;
		this.userInfo = userInfo;
		this.headImg = headImg;
		this.sysRole = sysRole;
	}
	
	/**
	 * 全参构造函数，不包含sysRole属性.
	 * 
	 * @param id
	 * @param userName
	 * @param userPassword
	 * @param userEmail
	 * @param createTime
	 * @param userInfo
	 * @param headImg
	 */
	public SysUser(Long id, String userName, String userPassword, String userEmail, Date createTime, String userInfo,
			byte[] headImg) {
		super();
		this.id = id;
		this.userName = userName;
		this.userPassword = userPassword;
		this.userEmail = userEmail;
		this.createTime = createTime;
		this.userInfo = userInfo;
		this.headImg = headImg;
	}
	
	/**
	 * 无参构造函数  
	 */
	public SysUser() {
		super();
	}



    // 此处省略 get()、 set() 函数 


}

       SysRole.java实体类：   

package com.moon.mybatis.pojo;

import java.util.Date;

public class SysRole {
    /**
     * 角色ID
     * 
     * id
     */
    private Long id;

    /**
     * 角色名
     * 
     * role_name
     */
    private String roleName;

    /**
     * 有效标志
     * 
     * enabled
     */
    private Integer enabled;

    /**
     * 创建人
     * 
     * create_by
     */
    private Long createBy;

    /**
     * 创建时间
     * 
     * create_time
     */
    private Date createTime;
    
    
    
    /**
     * 重写 toString() 函数 
     */
    @Override
	public String toString() {
		return "SysRole [id=" + id + ", roleName=" + roleName + ", enabled=" + enabled + ", createBy=" + createBy
				+ ", createTime=" + createTime + "]";
	}
    
    /**
     * 全参构造函数  
     * 
     * @param id
     * @param roleName
     * @param enabled
     * @param createBy
     * @param createTime
     */
	public SysRole(Long id, String roleName, Integer enabled, Long createBy, Date createTime) {
		super();
		this.id = id;
		this.roleName = roleName;
		this.enabled = enabled;
		this.createBy = createBy;
		this.createTime = createTime;
	}
	
	/**
	 * 无参构造函数 
	 */
	public SysRole() {
		super();
	}
	
	
        // 此处省略 get()、set()函数 	


}

2、 SysUserMapper.java文件内容如下：

package com.moon.mybatis.mapper;

import com.moon.mybatis.pojo.SysUser;

public interface SysUserMapper {


	/**
	 * 一对一映射，使用resultMap的association标签配置一对一映射，association标签的resultMap属性值来源于SysRoleMapper.xml文件配置信息 。
	 * 根据用户ID查询用户信息、用户角色信息.
	 * 
	 * @param id
	 * @return
	 * 
	 * @author moon  2019/03/08  18:40 
	 */
	SysUser selectUserAndRoleById6(Long id);


        // 为突出本篇博客所述问题，在此处省略其他的函数。

}

3、SysRoleMapper.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="com.moon.mybatis.mapper.SysRoleMapper">
	
  <resultMap id="BaseResultMap" type="com.moon.mybatis.pojo.SysRole"> <!-- 该行代码可在UserMapperTest.java中正确执行 -->
    <id column="id" jdbcType="BIGINT" property="id" />
    <result column="role_name" jdbcType="VARCHAR" property="roleName" />
    <result column="enabled" jdbcType="INTEGER" property="enabled" />
    <result column="create_by" jdbcType="BIGINT" property="createBy" />
    <result column="create_time" jdbcType="TIMESTAMP" property="createTime" />
  </resultMap>
  
  
  <resultMap id="SysRoleMap" type="com.moon.mybatis.pojo.SysRole">
    <id column="id" jdbcType="BIGINT" property="id" />
    <result column="role_name" jdbcType="VARCHAR" property="roleName" />
    <result column="enabled" jdbcType="INTEGER" property="enabled" />
    <result column="create_by" jdbcType="BIGINT" property="createBy" />
    <result column="create_time" jdbcType="TIMESTAMP" property="createTime" />
  </resultMap>
  
  <sql id="Base_Column_List">
    id, role_name, enabled, create_by, create_time
  </sql>
  
  <select id="selectByPrimaryKey" parameterType="java.lang.Long" resultMap="BaseResultMap">
    select 
    <include refid="Base_Column_List" />
    from sys_role
    where id = #{id,jdbcType=BIGINT}
  </select>
  
</mapper>

    SysUserMapper.xml文件内容如下所示，在这里注意id为"userRoleMap6"的resultMap标签，其子标签association中的 resultMap属性值为：com.moon.mybatis.mapper.SysRoleMapper.BaseResultMap。       

<?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="com.moon.mybatis.mapper.SysUserMapper">
	
	<!-- Mybatis逆向生成工具自动生成的resultMap  @moon  2019/03/09 16:41  -->
	<resultMap id="sysUserMap" type="com.moon.mybatis.pojo.SysUser">
		<id column="id" jdbcType="BIGINT" property="id" />
		<result column="user_name" jdbcType="VARCHAR" property="userName" />
		<result column="user_password" jdbcType="VARCHAR" property="userPassword" />
		<result column="user_email" jdbcType="VARCHAR" property="userEmail" />
		<result column="create_time" jdbcType="TIMESTAMP" property="createTime" />
		<result column="user_info" jdbcType="LONGVARCHAR" property="userInfo" />
		<result column="head_img" jdbcType="BLOB" property="headImg" />
	</resultMap>


	<!-- 
		使用resultMap的association标签的resultMap属性配置一对一映射。
		 其中，association标签的resultMap属性值来源于SysRoleMapper.xml文件配置信息 。
	 -->
	<!-- 
		使用resultMap的association标签配置一对一映射。   @moon  2019/03/08  15:33 
	 --> 
	<resultMap id="userRoleMap6" extends="sysUserMap" type="com.moon.mybatis.pojo.SysUser">
		<association property="sysRole" columnPrefix="role_" resultMap="com.moon.mybatis.mapper.SysRoleMapper.BaseResultMap" />
	</resultMap>


	<!-- 
	         一对一映射，使用resultMap配置一对一映射关系.
		 使用resultMap的association标签的resultMap属性配置一对一映射。
		 其中，association标签的resultMap属性值来源于当前文件配置的信息。
	 -->
	<!-- 根据用户ID查询用户信息、用户角色信息.  @moon  2019/03/08  18:26 -->
	<select id="selectUserAndRoleById6" parameterType="java.lang.Long" resultMap="userRoleMap6">
		SELECT u.id,
			u.user_name,
			u.user_password,
			u.user_email,
			u.user_info,
			u.head_img,
			u.create_time,
			r.id AS role_id,			
			r.role_name AS role_role_name,
			r.enabled AS role_enabled,
			r.create_by AS role_create_by,
			r.create_time AS role_create_time
		FROM sys_user u
		INNER JOIN sys_user_role ur ON ur.user_id = u.id 
		INNER JOIN sys_role r ON ur.role_id = r.id 
		WHERE u.id = #{id}
	</select>

	
</mapper>

4、BaseMapperTest.java文件内容如下所示：

package com.moon.mybatis.test;

import java.io.IOException;
import java.io.Reader;

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.BeforeClass;

/**
 * 基础测试类 
 * 
 * @author moon  2019/03/07  16:47   
 */
public class BaseMapperTest {
	
	private static SqlSessionFactory sqlSessionFactory;
	
	@BeforeClass
	public static void init() {
		
		try {
			
			Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
			
			sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
			reader.close();
		} catch (IOException ignore) {
			ignore.printStackTrace();
		}
		
	}
	
	
	public SqlSession getSqlSession() {
		return sqlSessionFactory.openSession();
	}
	
}

  

   UserMapperTest.java文件如下所示：

package com.moon.mybatis.test;

import org.apache.ibatis.session.SqlSession;
import org.junit.Assert;
import org.junit.Test;

import com.alibaba.fastjson.JSON;
import com.moon.mybatis.mapper.SysUserMapper;
import com.moon.mybatis.pojo.SysUser;

/**
 * 测试类，集中进行验证Mybatis的高级查询: 
 * 	高级映射、存储过程、
 * 	枚举、JavaBean、JDK8  
 * 
 * @author moon  2019/03/07  16:57  
 */
public class UserMapperTest extends BaseMapperTest {
	
	
	/**
	 * 一对一映射
	 * 
	 * @author moon  2019/03/08  11:28 
	 */
	@Test
	public void testSelectUserAndRoleById() {
		
		// 获取 sqlSession
		SqlSession sqlSession = getSqlSession();
		
		try {
			
			// 获取 UserMapper接口
			SysUserMapper userMapper = sqlSession.getMapper(SysUserMapper.class);
			
			
			/**
			 * selectUserAndRoleById6(...)函数可以执行，但没能得到sysRole属性值!   @author moon  2019/03/10  11:01      
			 */
			System.out.println("------------------------ Mybatis, 一对一映射，使用resultMap的association标签配置一对一映射. ------------------------");
			SysUser user7 = userMapper.selectUserAndRoleById6(1001L);
			System.out.println("user7为：" + user7.toString());
			
			
			// user不为空
			Assert.assertNotNull(user7);
			
		} catch (Exception e) {
			
			System.out.println("e的值为: " + e.toString());
			
			// 提交事务
			// sqlSession.commit();
			// 事务回滚
			sqlSession.rollback();
			
			// 不要忘记关闭 sqlSession
			sqlSession.close();
		}
		
	}
	
	
}

       程序运行Log日志结果如下所示，注意仔细观看 SysUser实体类中的 sysRole属性的值。

	   ------------------------ Mybatis, 一对一映射，使用resultMap的association标签配置一对一映射. ------------------------
DEBUG [main] - ==>  Preparing: SELECT u.id, u.user_name, u.user_password, u.user_email, u.user_info, u.head_img, u.create_time, r.id AS role_id, r.role_name AS role_role_name, r.enabled AS role_enabled, r.create_by AS role_create_by, r.create_time AS role_create_time FROM sys_user u INNER JOIN sys_user_role ur ON ur.user_id = u.id INNER JOIN sys_role r ON ur.role_id = r.id WHERE u.id = ? 
       DEBUG [main] - ==> Parameters: 1001(Long)
       TRACE [main] - <==    Columns: id, user_name, user_password, user_email, user_info, head_img, create_time, role_id, role_role_name, role_enabled, role_create_by, role_create_time
       TRACE [main] - <==        Row: 1001, test, 123456, [email protected], <<BLOB>>, <<BLOB>>, 2016-04-01 17:00:58.0, 2, 普通用户, 1, 1, 2016-04-01 17:02:34.0
       DEBUG [main] - <==      Total: 1
       user7为：SysUser [id=1001, userName=test, userPassword=123456, [email protected], createTime=Fri Apr 01 17:00:58 CST 2016, userInfo=测试用户, headImg=null, 
				sysRole=SysRole [id=2, roleName=普通用户, enabled=1, createBy=1, createTime=Fri Apr 01 17:02:34 CST 2016]
				]

      若将 SysUserMapper.xml文件中的 id为"userRoleMap6"的resultMap标签，其子标签association中的 resultMap属性值为：com.moon.mybatis.mapper.SysRoleMapper.SysRoleMap， 则会报错！

     SysUserMapper.xml文件修改的内容为：

	<!-- 
		使用resultMap的association标签的resultMap属性配置一对一映射。
		 其中，association标签的resultMap属性值来源于SysRoleMapper.xml文件配置信息 。
	 -->
	<!-- 
		使用resultMap的association标签配置一对一映射。   @moon  2019/03/08  15:33 
	 --> 
	<resultMap id="userRoleMap6" extends="sysUserMap" type="com.moon.mybatis.pojo.SysUser">
		<association property="sysRole" columnPrefix="role_" resultMap="com.moon.mybatis.mapper.SysRoleMapper.SysRoleMap" />
	</resultMap>

       UserMapperTest.java文件运行错误截图如下所示：