MyBatis 结果映射的两种方式

更新时间：2024年11月24日 10:14:09 作者：firepation

本文主要介绍了MyBatis的结果映射机制,包括基本结果映射、复杂结果映射以及动态结果映射和延迟加载,通过合理配置结果映射,可以简化复杂查询结果,感兴趣的可以了解一下

MyBatis 是一款优秀的持久层框架，它通过映射文件（Mapper XML 文件）或注解方式将 SQL 语句与 Java 对象关联起来。本文将详细介绍 MyBatis 的结果映射（Result Mapping）机制，帮助你理解和应用这一强大功能，提高开发效率和代码的可维护性。

1. 什么是结果映射

在 MyBatis 中，结果映射是指将 SQL 查询结果集中的列值映射到 Java 对象的属性中。通过配置结果映射，可以轻松地将复杂的查询结果转换为便于操作的 Java 对象。

2. 基本结果映射

MyBatis 提供了两种主要的结果映射方式：通过 XML 配置文件和注解。以下是这两种方式的详细介绍。

2.1 通过 XML 配置文件进行结果映射

假设有一个 User 类：

public class User {
    private int id;
    private String name;
    private String email;

    // getters and setters
}

对应的数据库表结构如下：

CREATE TABLE users (
    id INT PRIMARY KEY,
    name VARCHAR(50),
    email VARCHAR(50)
);

首先，在 MyBatis 的映射文件（如 UserMapper.xml）中定义 SQL 查询和结果映射：

<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserById" resultType="com.example.model.User">
        SELECT id, name, email FROM users WHERE id = #{id}
    </select>
</mapper>

在这里，resultType 属性指定了查询结果将映射到的 Java 类。MyBatis 会自动将查询结果的列名与 User 类的属性名进行映射。

2.2 通过注解进行结果映射

MyBatis 也支持使用注解来配置 SQL 查询和结果映射：

import org.apache.ibatis.annotations.Select;

public interface UserMapper {
    @Select("SELECT id, name, email FROM users WHERE id = #{id}")
    User getUserById(int id);
}

3. 复杂结果映射

在实际应用中，查询结果往往不仅仅是简单的平面数据，还可能包含嵌套对象或集合。这时，需要使用更复杂的结果映射配置。

3.1 嵌套对象映射

假设有一个 Order 类，其中包含一个 User 对象：

public class Order {
    private int id;
    private User user;
    private Date orderDate;

    // getters and setters
}

对应的数据库表结构如下：

CREATE TABLE orders (
    id INT PRIMARY KEY,
    user_id INT,
    order_date DATE,
    FOREIGN KEY (user_id) REFERENCES users(id)
);

在 MyBatis 的映射文件中配置嵌套对象映射：

<mapper namespace="com.example.mapper.OrderMapper">
    <resultMap id="OrderResultMap" type="com.example.model.Order">
        <id property="id" column="id" />
        <result property="orderDate" column="order_date" />
        <association property="user" javaType="com.example.model.User">
            <id property="id" column="user_id" />
            <result property="name" column="user_name" />
            <result property="email" column="user_email" />
        </association>
    </resultMap>

    <select id="getOrderById" resultMap="OrderResultMap">
        SELECT o.id, o.order_date, u.id AS user_id, u.name AS user_name, u.email AS user_email
        FROM orders o
        JOIN users u ON o.user_id = u.id
        WHERE o.id = #{id}
    </select>
</mapper>

在这里，association 元素用于定义与嵌套对象（User 对象）的映射关系。

3.2 集合映射

假设有一个 User 类，其中包含一个订单列表：

public class User {
    private int id;
    private String name;
    private String email;
    private List<Order> orders;

    // getters and setters
}

在 MyBatis 的映射文件中配置集合映射：

<mapper namespace="com.example.mapper.UserMapper">
    <resultMap id="UserResultMap" type="com.example.model.User">
        <id property="id" column="id" />
        <result property="name" column="name" />
        <result property="email" column="email" />
        <collection property="orders" ofType="com.example.model.Order">
            <id property="id" column="order_id" />
            <result property="orderDate" column="order_date" />
        </collection>
    </resultMap>

    <select id="getUserWithOrdersById" resultMap="UserResultMap">
        SELECT u.id, u.name, u.email, o.id AS order_id, o.order_date
        FROM users u
        LEFT JOIN orders o ON u.id = o.user_id
        WHERE u.id = #{id}
    </select>
</mapper>

在这里，collection 元素用于定义与集合（orders 列表）的映射关系。

4. 动态结果映射

MyBatis 支持动态结果映射，通过 <resultMap> 元素可以动态定义结果映射的结构：

<resultMap id="DynamicResultMap" type="java.util.HashMap">
    <id property="id" column="id" />
    <result property="name" column="name" />
    <result property="email" column="email" />
</resultMap>

<select id="getDynamicResult" resultMap="DynamicResultMap">
    SELECT id, name, email FROM users WHERE id = #{id}
</select>

在这里，查询结果会映射到 HashMap 对象中，键为列名，值为相应的列值。

5. 延迟加载（Lazy Loading）

MyBatis 支持延迟加载，只有在真正使用嵌套对象或集合时才进行查询：

在 MyBatis 配置文件（mybatis-config.xml）中启用延迟加载：

<configuration>
    <settings>
        <setting name="lazyLoadingEnabled" value="true"/>
        <setting name="aggressiveLazyLoading" value="false"/>
    </settings>
</configuration>

配置完成后，只有在访问嵌套对象或集合时才会触发相应的查询，提高性能。

6. 总结

MyBatis 的结果映射机制极大地方便了复杂查询结果与 Java 对象之间的转换。通过合理配置结果映射，可以轻松处理嵌套对象、集合等复杂结构，提高代码的可读性和可维护性。本文介绍了 MyBatis 中基本和复杂结果映射的配置方法，希望能帮助你更好地掌握 MyBatis 的使用。

进一步学习 MyBatis 结果映射，可以参考以下资源：

到此这篇关于MyBatis 结果映射的两种方式的文章就介绍到这了,更多相关MyBatis 结果映射内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java二分查找算法实现代码实例
这篇文章主要介绍了Java二分查找算法实现代码实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-11-11
通过mybatis-plus进行数据库字段加解密方式
文章主要介绍了在Java开发中,从编写处理程序（handler）到实现加解密工具（util）,再到配置实体和字段,以及自定义MyBatis的mapper语句的全过程
2026-01-01
springboot配置文件使用方式
文章介绍了将参数配置在配置文件中的方法,包括使用@Component和@Value注解进行外部配置的属性注入,以及使用@ConfigurationProperties简化配置,文章还提供了YAML格式配置文件的语法和特点,并强调了集中管理和维护配置参数的重要性
2024-11-11
SSH框架网上商城项目第25战之使用java email给用户发送邮件
这篇文章主要为大家详细介绍了SSH框架网上商城项目第25战之使用java email给用户发送邮件，感兴趣的小伙伴们可以参考一下
2016-06-06
Java 详解循环屏障CyclicBarrier如何实现多线程分段等待执行完成
CyclicBarrier是一个同步工具类，可以翻译成循环屏障，也叫障碍器或同步屏障。CyclicBarrier内部有一个计数器count，调用障碍器的await方法会使计数器count的值减一，当计数器count的值为0时，表明调用了await方法线程已经达到了设置的数量
2021-11-11
解决Springboot 2 的@RequestParam接收数组异常问题
这篇文章主要介绍了解决Springboot 2 的@RequestParam接收数组异常问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-08-08
MyBatis常用标签大全
这篇文章主要介绍了MyBatis常用标签大全的相关资料,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2016-12-12
Springboot引入多个yml方法(多种方案)
SpringBoot默认加载的是application.yml文件，所以想要引入其他配置的yml文件，就要在application.yml中激活该文件这篇文章主要介绍了Springboot引入多个yml方法,需要的朋友可以参考下
2019-10-10
java下载url路径包含中文需要转义的操作
这篇文章主要介绍了java下载url路径包含中文需要转义的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-12-12
java导出Echarts图表的示例代码(柱状图/饼形图/折线图)
这篇文章主要为大家详细介绍了java导出Echarts图表的示例代码,包括柱状图,饼形图,折线图等,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下
2025-06-06