本文来说下mybatis中的resultMap，在平时的开发中resultType使用的比较多。resultType在解决一对一的关系时候比较方便，但是在设计到多对多的时候，使用resultMap比较方面，而且resultMap的功能也是十分强大的。

文章目录

概述
字段映射
构造方法
关联
集合
- 集合的嵌套结果映射
- 集合的嵌套Select查询
自动填充关联对象
本文小结

概述

resultMap使用中文文档参考文档

在Mybatis中，有一个强大的功能元素resultMap。当我们希望将JDBC ResultSets中的数据，转化为合理的Java对象时，你就能感受到它的非凡之处。正如其官方所述的那样：

resultMap元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来，并在一些情形下允许你进行一些 JDBC 不支持的操作。实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的长达数千行的代码。ResultMap 的设计思想是，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了。

字段映射

在Mybatis中，最简单的结果映射方式，就是通过类型别名typeAliases来处理。如果要这样做，那么第一步需要配置实体类包的路径：mybatis.type-aliases-package=com.xxx.entity。该路径下的所有类，就会被注册到TYPE_ALIASES容器。我们在指定返回值类型的时候，就直接用别名即可。

如果不知啥是类型别名，请看这里类型别名参考文档

比如，我们有一个User类：

@Data
public class User {private String id;private String username;private String password;private String address;private String email;
}

如果数据库中表的字段与User类的属性名称一致，我们就可以使用resultType来返回。

<select id="getUsers" resultType="User">SELECTu.id,u.username,u.password,u.address,u.emailFROMUSER u
</select>

当然，这是理想状态下，属性和字段名都完全一致的情况。但事实上，不一致的情况是有的，这时候我们的resultMap就要登场了。

如果User类保持不变，但SQL语句发生了变化，将id改成了uid。

<select id="getUsers" resultType="User">SELECTu.id as uid,u.username,u.password,u.address,u.emailFROMUSER u
</select>

那么，在结果集中，我们将会丢失id数据。这时候我们就可以定义一个resultMap，来映射不一样的字段。

<resultMap id="getUserByIdMap" type="User"><result property="id" column="uid"></result>
</resultMap>

然后，我们把上面的select语句中的resultType修改为resultMap=“getUserByIdMap”。

这里面column对应的是数据库的列名或别名；property对应的是结果集的字段或属性。

这就是resultMap最简单，也最基础的用法：字段映射。

下面，我们看看其他几种标签都是怎么应用的。

元素名称	描述
constructor	用于在实例化类时，注入结果到构造方法中
association	关联一个对象
collection	关联多个对象

构造方法

如果你希望将结果注入构造方法里，就可以用到constructor元素。

比如，我们的User类增加了一个构造方法：

public User(String id, String name) {this.id = id+"--------";this.username = name+"--------";
}

我们需要在resultMap中定义constructor元素：

<resultMap id="getUserByIdMap" type="User"><constructor><idArg column="id" name="id" javaType="string"></idArg><arg column="username" name="name" javaType="string"></arg></constructor>
</resultMap>

其中，column代表数据库字段名称或者别名；name则是构造方法中的参数名称；javaType指定了参数的类型。

如你所想，这样指定构造方法后，我们结果集中的id和username属性都会发生变化。

{"id": "10001--------","username": "张三--------","password": "123456","address": "上海市黄浦区","email": "55667788@qq.com"
}

关联

在实际的业务中，我们的用户一般都会有一个角色。那么在User类里面一般也是以一个实体类来表示。

@Data
public class User {//省略用户属性...//角色信息private Role role;
}

我们在查询用户的时候，如果也希望看到它的角色信息，我们会这样来写查询语句：

<select id="getUserById" resultType="User">SELECTu.id,u.username,u.password,u.address,u.email,r.id as 'role_id',r.name as 'role_name'FROMUSER uLEFT JOIN user_roles ur ON u.id = ur.user_idLEFT JOIN role r ON r.id = ur.role_idwhere u.id=#{id}</select>

如上，就要查询单个用户以及用户的角色信息。不过在这里，我们不能用resultType=User来返回。

毕竟，User类中只有一个Role对象，并没有role_id和role_name字段属性。

所以，我们要使用association来关联它们。

<resultMap id="userMap" type="User"><id property="id" column="id"></id><result property="username" column="username"></result><result property="password" column="password"></result><result property="address" column="address"></result><result property="email" column="email"></result><association property="role" javaType="Role"><id property="id" column="role_id"></id><result property="name" column="role_name"></result></association>
</resultMap>

最后我们就可以将角色信息一块显示出来：

{"id": "10001","username": "张三","password": "123456","address": "上海市黄浦区","email": "55667788@qq.com""role": {"id": "1","name": "普通用户"}
}

事实上，如果你确定关联信息是一对一的情况，有个更简便的方法可以替代association，我们在本文的第五部分-自动填充关联对象再看它是怎么实现的。

集合

集合的嵌套结果映射

上面我们看到一个用户张三，它的角色是普通用户；但大部分时候，我们每个人都不可能只拥有一种角色。所以，我们需要将User类中的角色属性的类型改成List。

@Data
public class User {//省略用户属性...//角色信息private List<Role> roles;
}

现在就变成了一个用户对应多个角色，所以就不是简单的association。

因为association处理的是有一个类型的关联；而我们这里是有多个类型的关联，所以就需要用到collection属性。

我们整体的resultMap会变成下面这样：

<resultMap id="userMap" type="User"><id property="id" column="id"></id><result property="username" column="username"></result><result property="password" column="password"></result><result property="address" column="address"></result><result property="email" column="email"></result><collection property="roles" ofType="Role"><id property="id" column="role_id"></id><result property="name" column="role_name"></result></collection>
</resultMap>

这样的话，即便你有多个角色也可以被正确显示：

{"id": "10001","username": "张三","password": "123456","address": "上海市黄浦区","email": "55667788@qq.com""roles": [{"id": "1","name": "普通用户"},{"id": "2","name": "管理员"}]
}

集合的嵌套Select查询

在大部分业务系统中，我们都会有一个菜单的表，比如像下面这样，一张Menu表：

id	name	url	parent_id
1	系统管理		0
1001	用户管理	/user	1
1002	角色管理	/role	1
1003	单位管理	/employer	1
1	平台监控		0
2001	系统监控	/system/monitor	2
2002	平台监控	/system/monitor	2

这里我们给菜单分为两级。我们给前端返回菜单的时候，也是需要分级的，不可能将这7条数据平级展示。那么，在这里我们的Menu实体类如下：

@Data
public class Menu {private String id;private String name;private String url;private String parent_id;private List<Menu> childMenu;
}

一级菜单，包含一个二级菜单的列表，这里用childMenu来表示。

SQL语句中，如果没有parent_id字段属性，我们就先查所有的一级菜单：

<select id="getMenus" resultMap="menusMap">SELECTm.id,m.name,m.url,m.parent_idFROMm_menu mwhere 1=1<choose><when test="parent_id!=null">and m.parent_id = #{parent_id}</when><otherwise>and m.parent_id = '0'</otherwise></choose>
</select>

这个查询语句，在不传输任何参数的情况下，我们会得到两条一级菜单的数据。

那么在只调用此方法一次的情况下，怎么把所有的菜单信息查询出来，并按层级展示呢？

我们来看menusMap的定义：

<resultMap id="menusMap" type="Menu"><id property="id" column="id"></id><result property="name" column="name"></result><result property="url" column="url"></result><result property="m_desc" column="m_desc"></result><result property="parent_id" column="parent_id"></result><collection property="childMenu" ofType="Menu" select="getMenus"  column="{parent_id=id}"></collection>
</resultMap>

重点来看collection元素：

property=“childMenu” 对应的是菜单中的子级菜单列表；

ofType=“Menu” 对应返回数据的类型；

select=“getMenus” 指定了SELECT语句的id；

column="{parent_id=id}" 则是参数的表达式。

这个collection整体的含义可以这样理解：

通过getMenus这个SELECT语句来获取一级菜单中的childMenu属性结果；在上面的SELECT语句中，需要传递一个parent_id参数；这个参数的值就是一级菜单中的id。

通过这种方式，我们就可以得到已分级的所有菜单信息。

[{"id": "1","name": "系统管理","parent_id": "0","childMenu": [{"id": "1001","name": "用户管理","url": "/user","parent_id": "1"},{"id": "1002","name": "角色管理","url": "/role","parent_id": "1"},{"id": "1003","name": "单位管理","url": "/employer","parent_id": "1"}]},{"id": "2","name": "平台监控","parent_id": "0","childMenu": [{"id": "2001","name": "系统监控","url": "/system/monitor","parent_id": "2"},{"id": "2002","name": "数据监控","url": "/data/monitor","parent_id": "2"}]}
]

自动填充关联对象

我们知道，在Mybatis解析返回值的时候。

第一步是获取返回值类型，拿到Class对象，然后获取构造器，设置可访问并返回实例，然后又把它包装成MetaObject对象。

从数据库rs中拿到结果之后，会调用MetaObject.setValue(String name, Object value) 来填充对象。

在这过程中，有趣的是，它会以.来分隔这个name属性。

如果name属性中包含.符号，就找到.符号之前的属性名称，把它当做一个实体对象来处理。

可能笔者在这里描述的不够直观，我们还是来看例子。

在本文第三部分中，我们有一个用户对应一个角色的例子。

其中，User类定义如下：

@Data
public class User {//省略用户属性...//角色信息private Role role;
}

在这里，我们无需定义resultMap，直接返回resultType=User即可。不过需要把role信息的别名修改一下，重点是.符号

<select id="getUserList" resultType="User">SELECTu.id,u.username,u.password,u.address,u.email,r.id as 'role.id',r.name as 'role.name'FROMUSER uLEFT JOIN user_roles ur ON u.id = ur.user_idLEFT JOIN role r ON r.id = ur.role_id
</select>

这样，在Mybatis解析到role.id属性的时候，以.符号分隔之后发现，role别名对应的是Role对象，则会先初始化Role对象，并将值赋予id属性。

本文小结

本文详细介绍了Mybatis中resultMap的用法。

Mybatis中强大的resultMap相关推荐

Mybatis中强大的功能元素：resultMap
转载自 Mybatis中强大的功能元素:resultMap 前言在Mybatis中,有一个强大的功能元素resultMap.当我们希望将JDBC ResultSets中的数据,转化为合理的Java ...
一文理清Mybatis中resultType与resultMap之间的关系和使用场景
点击蓝色"程序猿DD"关注我回复"资源"获取独家整理的学习资料! 1.概述 Mybatis ORM半自动映射框架对java开发工程师来说应该是必会的框架之一. ...
mybatis collection用法_Mybatis中强大的resultMap
前言在Mybatis中,有一个强大的功能元素resultMap.当我们希望将JDBC ResultSets中的数据,转化为合理的Java对象时,你就能感受到它的非凡之处.正如其官方所述的那样: re ...
java resultmap_Mybatis中强大的resultMap功能介绍
前言在Mybatis中,有一个强大的功能元素resultMap.当我们希望将JDBC ResultSets中的数据,转化为合理的Java对象时,你就能感受到它的非凡之处.正如其官方所述的那样: re ...
resultmap的写法_Mybatis中强大的resultMap
前言在Mybatis中,有一个强大的功能元素resultMap.当我们希望将JDBC ResultSets中的数据,转化为合理的Java对象时,你就能感受到它的非凡之处.正如其官方所述的那样: re ...
[转]MyBatis中resultType与resultMap区别
MyBatis中关于resultType和resultMap的具体区别如下: MyBatis中在查询进行select映射的时候,返回类型可以用resultType,也可以用resultMap. res ...
mybatis中resultType和resultMap的区别
MyBatis中在查询进行select映射的时候,返回类型可以用resultType,也可以用resultMap resultType是直接表示返回类型的,而resultMap则是对外部ResultM ...
关于mybatis中mapper文件resultMap中collection和association的使用
mybatis mapper配置文件结果集映射resultMap中collection属性(一对多关系结果集映射)和association属性(多对一关系结果集映射)理解: collection的使用 ...
Mybatis中查询结果resultMap使用分析
本文章将讲述: mybatis resultMap 标签的作用 resultMap 标签中子标签 result 的使用分析 resultMap 标签中主键标签 id 的使用分析 resultMap ...

Mybatis中强大的resultMap