MyBatis深入讲解resultMap的定义及用法

在使用MyBatis进行数据操作时，查询结果可能会被映射到Java对象中或者直接返回Map类型数据，而MyBatis提供了resultMap来帮助我们自定义查询结果的映射方式。本文将详细介绍resultMap的定义及用法。

ResultMap定义

resultMap是一个非常重要的MyBatis配置元素，它将查询结果集映射成Java对象集合。在MyBatis映射文件中，我们可以使用标签来定义一个resultMap，其格式如下：

<resultMap id="ResultMapName" type="JavaObject" extends="BaseResultMap">
  <!-- 字段映射，可包含多个result标签 -->
  <result .../>
  <!-- 关联对象映射，可包含多个association标签 -->
  <association .../>
  <!-- 集合对象映射，可包含多个collection标签 -->
  <collection .../>
</resultMap>

其中，id为resultMap的唯一标识符，type指定映射的Java对象类型。extends属性表示继承自哪个resultMap。

接下来我们将结合示例来具体看一下resultMap的使用方法。

ResultMap用法示例

示例1：基本使用

考虑如下表结构：

CREATE TABLE user (
    id INT PRIMARY KEY,
    username VARCHAR(20),
    password VARCHAR(20)
);

对应的Java对象如下：

public class User {
    private Integer id;
    private String username;
    private String password;

    // getter setter方法省略
}

如果我们想要将查询结果映射到User对象中，我们可以定义如下的resultMap：

<resultMap id="userResultMap" type="User">
    <result column="id" property="id"/>
    <result column="username" property="username"/>
    <result column="password" property="password"/>
</resultMap>

其中，标签中的column属性指定数据库表中的列名，property属性指定Java对象中对应的属性名。

然后我们就可以在select语句中使用这个resultMap了：

<select id="selectUser" resultMap="userResultMap">
    SELECT id, username, password FROM user WHERE id=#{id}
</select>

这样，查询结果就会被映射到User对象中了。

示例2：关联对象查询

考虑如下的表结构：

CREATE TABLE post (
    id BIGINT PRIMARY KEY,
    title VARCHAR(100),
    content VARCHAR(1000),
    user_id INT, FOREIGN KEY (user_id) REFERENCES user(id)
);

对应的Java对象如下：

public class Post {
    private Long id;
    private String title;
    private String content;
    private User author;

    // getter setter方法省略
}

如果我们需要查询Post对象，并且需要将其关联的User对象也同时查询出来，我们可以在resultMap中使用标签来完成：

<resultMap id="postResultMap" type="Post">
    <result column="id" property="id"/>
    <result column="title" property="title"/>
    <result column="content" property="content"/>
    <association property="author" javaType="User" resultMap="userResultMap"/>
</resultMap>

其中，标签中的javaType属性指定关联的Java对象类型，resultMap属性指定关联对象的resultMap。

然后我们就可以在select语句中使用这个resultMap了：

<select id="selectPost" resultMap="postResultMap">
    SELECT
        p.id, p.title, p.content,
        u.id as author_id, u.username as author_username, u.password as author_password
    FROM post p LEFT JOIN user u ON p.user_id = u.id
    WHERE p.id=#{id}
</select>

这样，查询结果就会被映射到Post对象中，并且关联的User对象也会被查询出来。

总结

本文介绍了MyBatis中resultMap的定义及使用方法，并且结合了示例进行了详细的讲解。在实际应用中，我们可以根据需要来自定义resultMap来完成数据的映射。