MyBatis注解开发实战:从基础CRUD到动态SQL与混合使用策略

发布时间:2026/11/18 21:31:44

MyBatis注解开发实战:从基础CRUD到动态SQL与混合使用策略 1. 从XML到注解为什么我选择在项目中混合使用如果你和我一样是从MyBatis的XML配置时代一路走过来的开发者那么第一次看到满篇的Select、Insert注解时心里多半会犯嘀咕这玩意儿能行吗XML多清晰啊SQL和Java代码分离维护起来也方便。我最初也是这么想的直到在一个快速迭代、需求频繁变动的内部工具项目中我被XML文件之间来回切换和繁琐的namespaceid匹配搞得有点烦躁才决定认真试试注解开发。几年用下来我的结论是MyBatis的注解开发绝不是为了取代XML而是一种强有力的补充和特定场景下的最优解。它特别适合那些SQL逻辑相对简单、变动频繁、或者你希望DAO层接口能“自成一体”、减少文件跳转的场合。比如管理后台的CRUD接口、简单的报表查询、或者是一些原型验证阶段的功能。当你看到一个接口方法同时就能看到它要执行的SQL这种“所见即所得”的体验在开发调试阶段效率提升非常明显。当然网上很多教程只告诉你注解怎么用却很少说清楚什么时候用、用了有什么坑。这篇内容我就结合自己趟过的路把MyBatis注解开发从入门到进阶再到生产环境下的混合使用策略掰开揉碎了讲清楚。我们会涵盖基础的CRUD、复杂的结果映射、动态SQL、以及二级缓存等核心主题目标就是让你看完后不仅能写出注解代码更能做出合适的技术选型。2. 环境搭建与基础CRUD注解实战开始写注解之前得先把场子搭起来。这里假设你已经在用Spring Boot整合MyBatis无非就是加依赖、配数据源。关键点在于要确保MyBatis能扫描到你的Mapper接口。2.1 核心依赖与配置要点在你的pom.xml里需要的是mybatis-spring-boot-starter。版本选择上我建议直接上较新的稳定版比如3.0.x以上。新版本对注解的支持更完善也修复了不少历史遗留问题。dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version !-- 示例版本请使用最新稳定版 -- /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency在application.yml中基础的数据库配置必不可少。但关于MyBatis本身有一个配置项对注解开发至关重要mybatis: configuration: map-underscore-to-camel-case: true # 强烈建议开启下划线转驼峰省去大量Result映射开启这个配置后数据库字段user_name会自动映射到Java实体属性userName上对于简单的查询你甚至可以不写任何Result映射非常省事。这是很多新手会忽略的一个高效技巧。2.2 核心CRUD注解逐一看假设我们有一个User实体和对应的UserMapper接口。下面我们看最常用的四个注解。Select查询的基石Mapper public interface UserMapper { Select(SELECT id, user_name, age, email FROM user WHERE id #{id}) User selectById(Long id); Select(SELECT * FROM user WHERE age #{minAge}) ListUser selectByMinAge(Integer minAge); }注意SELECT *在注解里要谨慎使用。如果数据库表字段顺序或数量发生变化而你的实体类没及时更新可能会导致映射错误。显式列出字段是更稳妥的做法尤其是在生产环境。Insert插入数据与返回主键插入操作简单但如何获取数据库生成的主键比如自增ID是个关键点。Insert(INSERT INTO user (user_name, age, email) VALUES (#{userName}, #{age}, #{email})) Options(useGeneratedKeys true, keyProperty id) // 关键在这里 int insertUser(User user);Options注解的useGeneratedKeys true告诉MyBatis使用JDBC的getGeneratedKeys方法来获取数据库生成的主键。keyProperty id指定将这个值回填到参数对象user的id属性中。执行完这个方法后user.getId()就能拿到插入的ID了。Update 与 Delete更新与删除这两个注解相对直接。Update(UPDATE user SET email #{email} WHERE id #{id}) int updateEmailById(Param(id) Long id, Param(email) String email); Delete(DELETE FROM user WHERE id #{id}) int deleteById(Long id);这里引入了Param注解。当方法有多个参数时你必须使用Param给每个参数命名在SQL中通过#{参数名}来引用。如果只有一个参数且是基本类型/String可以不用Param但为了清晰我习惯都加上。2.3 关于Param注解的深度理解Param的作用不仅仅是解决多参数问题。它本质上是为参数创建了一个在SQL上下文中可用的名字。即使你只有一个复杂对象参数有时也需要它。// 场景模糊查询参数是一个User对象但我们只想用其中的name属性进行模糊匹配 Select(SELECT * FROM user WHERE user_name LIKE CONCAT(%, #{user.name}, %)) ListUser selectByUserCondition(Param(user) User user);如果没有Param(user)在SQL中直接写#{name}是取不到值的因为MyBatis不知道name属性属于哪个参数对象。通过Param指定后就可以用#{user.name}这种OGNL表达式来访问对象属性了。这是处理复杂查询条件时的一个实用模式。3. 解决复杂映射Results与ResultMap基础CRUD的SQL简单映射也简单。但遇到查询结果包含关联对象、集合或者字段名与属性名无法通过驼峰规则自动映射时就需要Results和ResultMap出场了。3.1 处理字段名不对应与简单关联假设我们查询用户及其所属部门假设部门信息在user表中有dept_id和dept_name字段但实体类中是deptId和deptName。Select(SELECT u.id, u.user_name, u.dept_id, d.name as dept_name FROM user u LEFT JOIN department d ON u.dept_id d.id WHERE u.id #{id}) Results({ Result(column id, property id, id true), // idtrue表示这是主键 Result(column user_name, property userName), Result(column dept_id, property deptId), Result(column dept_name, property deptName) }) User selectUserWithDeptById(Long id);Results注解可以理解为一个结果映射的集合。Result中的column是数据库查询结果的列名或别名property是Java实体类的属性名。当开启了map-underscore-to-camel-case后像user_name到userName的映射其实可以省略但这里为了演示完整性还是写了出来。对于主键建议明确标记id true这有助于提高性能尤其是在嵌套查询时。3.2 使用ResultMap复用映射规则如果同一个映射规则在多个Select方法中都要用到每次都写一遍Results太冗余了。这时可以用ResultMap。首先在一个方法上定义Results并指定一个唯一的idSelect(SELECT * FROM user WHERE id #{id}) Results(id userResultMap, value { Result(column id, property id, id true), Result(column user_name, property userName), Result(column dept_id, property deptId) }) User selectByIdForMap(Long id);然后在其他方法中通过ResultMap来引用这个映射规则Select(SELECT * FROM user WHERE age #{age}) ResultMap(userResultMap) // 直接复用上面定义的映射 ListUser selectByAge(Integer age);这种方式极大地减少了重复代码。但请注意ResultMap引用的id必须在同一个Mapper接口内定义。它无法跨Mapper接口引用这是注解开发的一个局限性。3.3 一对多、多对一关联映射的挑战与方案这是注解开发最棘手的部分之一。在XML中我们可以使用collection和association轻松定义复杂关联。在注解中MyBatis提供了One和Many注解来模拟但用起来颇为繁琐。例如查询用户及其所有订单一对多。// OrderMapper.java Mapper public interface OrderMapper { Select(SELECT * FROM order WHERE user_id #{userId}) ListOrder selectByUserId(Long userId); } // UserMapper.java Select(SELECT * FROM user WHERE id #{id}) Results({ Result(id true, column id, property id), Result(column user_name, property userName), Result(column id, property orderList, // 将用户id作为参数传递给另一个查询 many Many(select com.example.mapper.OrderMapper.selectByUserId)) }) User selectUserWithOrders(Long id);Many注解的select属性指定了另一个Mapper方法的全限定名或同一Mapper内的方法名。MyBatis会先执行主查询SELECT * FROM user然后对每一条结果再执行一次OrderMapper.selectByUserId(user.id)最后将查询到的ListOrder集合设置到User对象的orderList属性中。这种方式的优缺点非常明显优点逻辑清晰直接利用已有的Mapper方法符合SQL直观思维。缺点容易产生N1查询问题。如果主查询返回10个用户那么就会产生1主查询10查询订单11次数据库查询性能隐患巨大。对于数据量大的场景这是不可接受的。因此对于复杂的关联查询我个人的强烈建议是不要在注解里硬扛回归XML写一个联表查询才是正道。你可以用Select注解执行一个联表查询SQL然后通过Results手动映射每一个字段包括嵌套对象的字段但这会让Results变得极其庞大和难以维护。此时XML的清晰和强大就体现出来了。这也引出了我的核心观点注解与XML混合使用各取所长。4. 注解下的动态SQLProvider与
延伸阅读

更多相关文章

2026/11/18 21:31:44

可制造性设计(DFM)核心挑战与全流程实践指南

1. 从“画得出来”到“造得出来”:可制造性设计的核心挑战在硬件产品开发领域,有一个让无数工程师和项目经理头疼不已的经典困境:实验室里功能完美、性能惊艳的样机,一旦进入量产阶段,要么良率惨不忍睹,要么…

2026/11/18 2:43:53

终极免费网盘直链下载助手:八大平台高速下载完全指南

终极免费网盘直链下载助手:八大平台高速下载完全指南 【免费下载链接】Online-disk-direct-link-download-assistant 一个基于 JavaScript 的网盘文件下载地址获取工具。基于【网盘直链下载助手】修改 ,支持 百度网盘 / 阿里云盘 / 中国移动云盘 / 天翼云…

2026/11/18 17:33:16

PICAXE编程进阶:从输入输出到项目实战的嵌入式系统开发指南

1. 项目概述:从入门到实践,解锁PICAXE编程的核心技能上次我们聊了PICAXE编程的入门,搭建了环境,点亮了第一个LED,算是和这个小家伙打了个招呼。很多朋友反馈说,感觉像是刚拿到驾照,只会直行和倒…

2026/11/18 21:28:43

兰溪电工证在哪里考网上查询指南

兰溪电工证在哪里考网上查询指南 急需特种作业证才能上岗找工作,但兰溪电工证在哪里考?网上查询结果让人眼花缭乱,怎么选?别急,这篇文章给你讲清楚,帮你少走弯路,快速拿到电工证。 兰溪电工证在哪里考?正规培训机构怎么找? 兰溪电工证在哪里考…

2026/11/18 21:28:43

吸毒人员电工证体检报名费多少钱?网上查询体检结果攻略

吸毒人员电工证体检报名费多少钱?网上查询体检结果攻略 你是不是正被“急需特种作业证才能上岗找工作”这个问题逼得焦头烂额?尤其是像你这样曾经有吸毒史的人员,连最基本的电工证体检都成了拦路虎。别急,今天就告诉你【吸毒人员电工证体检】报名费多少钱…

2026/11/18 21:28:43

家装电工证多久能考到 你知道多少钱吗

家装电工证多久能考到 你知道多少钱吗 证书过期了不知道怎么复审延期,这事儿很多人都经历过。尤其像家装电工证这种实操性强、涉及安全的证书,一旦过期,不仅影响工作,还可能带来安全隐患。现在很多人关心的是: 家装电工证多久能考到 ,还有就是…

2026/11/18 21:28:43

睢县办电工证怎么转异地,官方回应来了,别再走弯路

睢县办电工证怎么转异地,官方回应来了,别再走弯路 你是不是也遇到这种情况:好不容易在睢县办了电工证,结果去外地找工作,发现证书不能用了?别急,这事儿官方有回应,也别慌,我来给你支招,怎么把睢县办的电工证顺利转到异地,省心又省钱。…

2026/11/18 21:28:43

1997井下电工证怎么转异地 电子证书异地变更流程全解析

1997井下电工证怎么转异地 电子证书异地变更流程全解析 之前考的证在外省能不能转过来?这个问题其实困扰了不少特种作业人员,尤其是像郑州金水区的建筑工人,很多人都是跨省打工,考的证在老家,但工作在外地,想转证又不知道怎么操作。别急,本文就围…

2026/11/18 21:12:58

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/17 21:35:12

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/18 0:00:18

小型汽车电工证怎么考通过率揭秘

小型汽车电工证怎么考通过率揭秘 你是不是也担心,花了几千块培训费,最后考不过,钱就白花了?别急,今天我就从安阳在职建筑工人的角度,给你讲讲【小型汽车电工证怎么考】的真相,特别是【通过率揭秘】,帮你避坑、避雷、少走弯路。…

2026/11/18 0:00:18

青浦区电工证在哪考内部消息曝光了,学历不高也能考!

青浦区电工证在哪考内部消息曝光了,学历不高也能考! 你是不是也担心自己学历不高,报不了电工证?别急, 青浦区电工证在哪考 其实有“内部消息”能让你轻松搞定,而且门槛并不高。今天我就从一个过来人的角度,给你讲清楚电工证报考的真相,以及你真正需…

2026/11/18 0:00:18

你别再被中介坑了!登高证和电工证相片保姆级教程来了

你别再被中介坑了!登高证和电工证相片保姆级教程来了 你是不是正为 登高证和电工证相片 的事情发愁?不知道去哪儿报名,怕被中介忽悠,花了不少冤枉钱却还没拿到证?其实,这事儿你不是一个人在战斗,很多人都在为这事头疼。别急,今天这波 保姆级教程…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/18 1:15:04

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑