Spring Boot进阶(26)：从小白到高手，掌握Mybatis中resultType和resultMap的秘密！

<think>我们正在讨论Spring Boot集成MyBatis的结果映射问题，重点对比resultType和resultMap的使用。 根据用户的问题，我们需要详细解释resultType和resultMap的区别、使用场景以及如何配置。 引用说明： 由于用户要求参考站内引用，但之前对话中并没有直接关于resultType和resultMap的引用，因此我们将根据MyBatis官方文档和常见实践进行解释。 回答结构： 1. 结果映射概述 2. resultType的使用和示例 3. resultMap的使用和示例 4. 对比总结（使用场景、优缺点） 5. 在Spring Boot中配置结果映射的注意事项 注意：在XML映射文件中，我们使用<select>标签的resultType或resultMap属性来指定结果映射。</think>### Spring Boot集成MyBatis：resultType与resultMap结果映射详解 在Spring Boot集成MyBatis时，结果映射是将SQL查询结果自动转换为Java对象的核心机制，主要通过`resultType`和`resultMap`实现。以下是两者的对比和实现方式： --- ### 1. **resultType：简单对象映射** **适用场景**：数据库列名与Java对象属性名**完全匹配**（或通过驼峰命名转换匹配）的简单映射。 **实现原理**：MyBatis自动创建对象实例，通过**反射**将查询结果的列值注入同名属性。 **示例代码**： ```xml <!-- UserMapper.xml --> <select id="getUserById" resultType="com.example.model.User"> SELECT id, user_name, email FROM users WHERE id = #{id} </select> ``` **关键点**： - 需开启驼峰命名转换（在`application.yml`中配置）： ```yaml mybatis: configuration: map-underscore-to-camel-case: true # 自动将user_name → userName ``` - **优点**：配置简单，无需额外XML标签。 - **缺点**：无法处理复杂关系（如嵌套对象、集合）或字段名不匹配的情况[^1][^3]。 --- ### 2. **resultMap：高级自定义映射** **适用场景**： - 数据库列名与Java属性名**不匹配** - 需要映射**嵌套对象**（如User包含Order列表） - 需要自定义类型转换器 **实现原理**：通过XML显式定义字段与属性的映射关系，支持复杂对象树构建。 **示例代码**： ```xml <!-- 定义resultMap --> <resultMap id="UserResultMap" type="com.example.model.User"> <!-- 主键映射 --> <id property="id" column="id"/> <!-- 普通字段映射（列名≠属性名） --> <result property="userName" column="user_name"/> <result property="email" column="email"/> <!-- 嵌套对象映射（1对1） --> <association property="department" javaType="com.example.model.Department"> <id property="deptId" column="dept_id"/> <result property="deptName" column="dept_name"/> </association> <!-- 集合映射（1对多） --> <collection property="orders" ofType="com.example.model.Order"> <id property="orderId" column="order_id"/> <result property="amount" column="order_amount"/> </collection> </resultMap> <!-- 使用resultMap --> <select id="getUserWithOrders" resultMap="UserResultMap"> SELECT u.*, d.dept_name, o.order_id, o.amount AS order_amount FROM users u LEFT JOIN department d ON u.dept_id = d.dept_id LEFT JOIN orders o ON u.id = o.user_id WHERE u.id = #{id} </select> ``` **关键点**： - `<id>`：标识主键字段，提升性能 - `<result>`：普通字段映射 - `<association>`：映射单个嵌套对象（如User→Department） - `<collection>`：映射对象集合（如User→List<Order>） - **优点**：灵活处理复杂关系，支持深度定制[^2][^4]。 --- ### 3. **对比总结** | **特性** | **resultType** | **resultMap** | |------------------------|-----------------------------------------|----------------------------------------| | **配置复杂度** | 简单（自动映射） | 复杂（需显式定义） | | **字段名匹配要求** | 需一致或开启驼峰转换 | 可自定义任意映射关系 | | **嵌套对象支持** | ❌ 不支持 | ✅ 通过`<association>`/`<collection>` | | **适用场景** | 简单单表查询 | 多表关联、复杂对象映射 | | **性能** | 较高（自动反射） | 略低（需解析XML映射） | > 💡 **最佳实践**： > - 单表简单查询 → 优先用`resultType` + 驼峰命名 > - 多表关联/字段名不匹配 → 必须用`resultMap` > - 复用映射：通过`<resultMap id>`定义一次，多处引用[^3][^5]。 --- ### 4. **Spring Boot中的配置要点** 1. **开启驼峰命名转换**（简化resultType）： ```yaml mybatis: configuration: map-underscore-to-camel-case: true ``` 2. **指定XML映射文件路径**： ```yaml mybatis: mapper-locations: classpath:mapper/*.xml ``` 3. **扫描Mapper接口**： ```java @SpringBootApplication @MapperScan("com.example.mapper") // 自动生成代理类 public class Application { ... } ``` --- ### 常见问题解决 - **映射失败**： - 检查`resultType`的类全限定名是否正确 - 确认`resultMap`的`id`在XML中唯一 - **嵌套对象为null**： - 确保SQL关联查询的列名与`<association>`/`<collection>`中定义的`column`一致 - **性能优化**： - 复杂结果集使用`<resultMap>`的`<id>`标签避免重复对象创建 通过合理选择`resultType`或`resultMap`，可高效实现SQL结果到Java对象的智能转换[^1][^4][^5]。