3.1-mapper映射文件：结果映射机制

将数据库查询结果集转换为 Java 对象的核心技术一、 核心知识点概述MyBatis 的结果映射机制本质是将 SQL 查询返回的数据库结果集ResultSet按照指定规则封装为 Java 对象实体类、包装类等或集合的过程而select标签的resultType本题考点和resultMap是实现该机制的两个核心配置支撑了从 “数据库数据” 到 “Java 对象” 的转换避免了开发者手动遍历ResultSet封装数据的繁琐工作二、resultType简单结果映射这是结果映射机制中最基础、最常用的方式对应简单场景的快速映射其核心特性和使用规则是知识点的重点核心作用直接指定 SQL 查询结果对应的单个数据类型MyBatis 依靠默认映射规则完成结果封装无需自定义字段映射关系默认映射规则MyBatis 会自动将数据库表字段名忽略大小写与 Java 实体类的属性名进行匹配若完全一致或通过全局配置mapUnderscoreToCamelCasetrue开启驼峰命名转换支持user_name匹配userName则自动完成字段值到属性值的赋值支持的结果类型基本数据类型 / 包装类int、Integer、String、Long等适用于查询单个字段如统计总数、查询单个用户名称Java 实体类如com.example.entity.User适用于查询单条表记录封装为单个实体对象自定义 VO/DTO视图对象 / 数据传输对象适用于多表查询简化结果、前端数据适配等场景与实体类映射规则一致集合元素类型查询多条记录返回ListUser、SetUser时resultType只需指定集合中的元素类型UserMyBatis 会自动封装为对应集合使用限制仅适用于字段名与属性名匹配或可通过驼峰转换匹配的简单场景不支持复杂关联查询一对一、一对多、自定义映射规则等需求三、resultMap复杂自定义结果映射这是结果映射机制中更灵活、更强大的补充方式对应复杂场景的自定义映射是该知识点的延伸重点核心作用先通过resultMap标签定义自定义的结果映射规则包括字段与属性的对应关系、主键映射、关联查询映射等再在select标签中通过resultMap属性引用该规则完成复杂结果的封装核心适用场景数据库表字段名与 Java 实体类属性名不一致且无法通过驼峰命名转换匹配如u_id对应userId、user_phone对应mobile多表关联查询一对一association、一对多collection需要自定义结果封装逻辑如字段值格式化、类型转换扩展等单个查询结果需要映射到多个关联对象中核心特性灵活性强完全脱离默认映射规则支持按需定义字段与属性的对应关系可复用性定义好的resultMap可被多个select标签引用减少重复配置支持高级功能支撑 MyBatis 的关联查询、嵌套结果映射等高级特性满足复杂业务场景四、resultType与resultMap的核心区别与使用原则核心区别配置方式resultType直接指定结果类型依赖默认规则resultMap先定义映射规则再引用规则自定义性强适用场景resultType适用于简单场景配置简洁高效resultMap适用于复杂场景配置灵活强大关联性select标签中两者不可同时使用只能二选一使用原则优先使用resultType对于简单场景优先选择resultType减少配置工作量提升开发效率复杂场景用resultMap当resultType无法满足需求时使用resultMap保证结果映射的准确性和灵活性五、 核心价值简化开发无需手动遍历ResultSet封装数据减少冗余代码提升开发效率适配多样场景通过resultType和resultMap的配合既满足简单场景的快速开发又支撑复杂业务的自定义需求提升可维护性结果映射规则集中配置便于后续修改、优化降低维护成本总结核心知识点MyBatis 结果映射机制Result Mapping两大实现resultType简单默认映射、resultMap复杂自定义映射关键原则简单场景优先resultType复杂场景使用resultMap两者不可同时配置