深入理解 MyBatis 中的 resultMap 和 ＜collection＞ 标签

---

一、前言

1. 引言

在使用 MyBatis 进行 Java 数据持久化时，resultMap 是一个核心功能，它允许我们定义如何将 SQL 查询结果映射到 Java 对象。resultMap 提供了极大的灵活性，使得复杂的查询结果能够被正确地映射到我们定义的对象模型中。本文将重点讲解 resultMap 和 <collection> 标签的使用，通过示例代码和详细解释帮助读者深入理解这一概念。

2. MyBatis 中的 resultMap

resultMap 是 MyBatis 中一个重要的配置元素，用于定义 SQL 查询结果如何映射到 Java 对象的属性。它允许我们进行复杂的结果集映射，包括处理一对多或多对多的关系。通过 resultMap，我们可以指定每个字段如何映射到 Java 对象的属性上，支持各种数据类型的映射。

3. 基本结构

一个基本的 resultMap 示例：

<resultMap id="UserMap" type="com.example.User">
    <id property="id" column="id" jdbcType="VARCHAR"/>
    <result property="username" column="username" jdbcType="VARCHAR"/>
    <result property="email" column="email" jdbcType="VARCHAR"/>
</resultMap>

在这个例子中，resultMap 定义了如何将 SQL 查询的 id、username 和 email 字段映射到 User 类的相应属性上。

二、使用 <collection> 标签处理一对多关系

当处理一对多关系时，我们需要使用 <collection> 标签来映射子集合（如一对多关系中的多个子项）。<collection> 标签用于定义如何从父对象中提取和填充集合属性。

1. 示例解释

让我们来看一个具体的示例：

<resultMap id="UserMenuMap" type="com.supplier.supplierplatform.entity.SystemMenu">
    <id property="id" column="id" jdbcType="VARCHAR"/>
    <result property="menuName" column="menu_name" jdbcType="VARCHAR"/>
    <result property="parentId" column="parent_id" jdbcType="VARCHAR"/>
    <result property="url" column="url" jdbcType="VARCHAR"/>
    <result property="icon" column="icon" jdbcType="VARCHAR"/>
    <result property="sortOrder" column="sort_order" jdbcType="INTEGER"/>
    <collection property="permissions" ofType="com.supplier.supplierplatform.entity.SystemPermission"
                select="com.supplier.supplierplatform.mapper.SystemPermissionMapper.queryMenuPermissionListByMenuId"
                column="id">
        <id property="id" column="id" jdbcType="VARCHAR"/>
        <result property="permissionName" column="permission_name" jdbcType="VARCHAR"/>
        <result property="description" column="description" jdbcType="VARCHAR"/>
        <result property="code" column="code" jdbcType="VARCHAR"/>
    </collection>
</resultMap>

解析：

• <id> 标签：用于标识主键属性，将 SystemMenu 对象的 id 属性与数据库中的 id 列对应起来。

• <result> 标签：用于映射其他普通属性。这里将 SystemMenu 的 menuName、parentId、url、icon 和 sortOrder 属性分别映射到相应的数据库列。

• <collection> 标签：处理 SystemMenu 对象中的 permissions 属性，这个属性是一个 List<SystemPermission> 类型的集合。

  • property：指定集合属性的名称，即 SystemMenu 中的 permissions。
  • ofType：指定集合中的元素类型，即 SystemPermission 类。
  • select：指定查询子集合数据的方法。这里 SystemPermissionMapper.queryMenuPermissionListByMenuId 是查询 SystemPermission 数据的方法。
  • column：指定用来查询子集合的字段，即 SystemMenu 的 id。

2. 查询方法配置

为了使 <collection> 标签正常工作，需要在 Mapper 中配置相应的查询方法，例如：

public interface SystemPermissionMapper {
    List<SystemPermission> queryMenuPermissionListByMenuId(String menuId);
}

这个方法应该返回与 SystemMenu 中的 permissions 属性匹配的 SystemPermission 对象的列表。

3. 总结

通过使用 MyBatis 的 resultMap 和 <collection> 标签，我们可以轻松地将复杂的 SQL 查询结果映射到 Java 对象中，尤其是在处理一对多关系时。掌握这些配置技巧能够帮助我们在构建数据访问层时更高效、更准确地处理数据。

希望这篇文章能帮助你深入理解 resultMap 和 <collection> 标签的用法，并在实际开发中灵活运用这些技术来提升你的项目质量。如果你还有其他问题或需要进一步的学习材料，请随时告诉我！