文章目录
-
- 一、概述
- 二、ORM 基础概念
-
- 2.1 什么是 ORM
- 2.2 实体类与数据库表的映射关系
- 2.3 字段映射规则与策略
- 2.4 ORM 优势与适用场景
- 三、项目结构
- 四、架构总览
-
- 4.1 端到端 ORM 执行流程
- 4.2 基于 BaseMapper 的查询流程
- 五、核心组件详解
-
- 5.1 BaseMapper 接口
-
- 5.1.1 插入操作
- 5.1.2 删除操作
- 5.1.3 更新操作
- 5.1.4 查询操作
- 5.1.5 高级功能
- 5.1.6 方法重载与默认方法设计
- 5.2 元数据系统
-
- 5.2.1 TableInfo：表元数据模型
- 5.2.2 TableInfoHelper：元数据助手与缓存
- 5.2.3 TableFieldInfo：字段元数据与 SQL 片段生成
- 5.2.4 其他关键组件
- 5.3 注解驱动配置
-
- 5.3.1 @TableId：主键注解
- 5.3.2 @TableName：表名注解
- 5.3.3 @TableField：字段注解
- 5.3.4 注解与元数据系统的关系
- 5.4 SQL 模板与执行流程
- 六、依赖关系分析
-
- 6.1 组件耦合关系
- 6.2 外部依赖
- 七、性能考量
- 八、故障排查指南
- 九、最佳实践与示例
-
- 9.1 实体类定义
- 9.2 Mapper 接口定义
- 9.3 动态 SQL 片段使用示例
- 9.4 最佳实践总结
- 十、总结
一、概述
MyBatis-Plus 作为 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。本文基于 MyBatis-Plus 3.5.16 版本源码，系统梳理其核心概念，重点围绕以下主题展开：
- ORM（对象关系映射）基本原理与 MyBatis-Plus 的简化实践
- BaseMapper 接口的设计理念与 CRUD 方法详解
- TableInfo 元数据系统的工作原理与缓存机制
- 注解驱动的配置方式（@TableId、@TableName、@TableField 等）及其配置选项
- 通过真实代码路径示例帮助读者快速上手
二、ORM 基础概念
2.1 什么是 ORM
ORM（Object Relational Mapping，对象关系映射）是一种将面向对象编程语言中的对象与关系数据库中的表建立映射的技术。简单来说，ORM 让我们可以用操作 Java 对象的方式来操作数据库，而无需编写繁琐的 SQL 语句。
MyBatis-Plus 通过以下关键构件实现 ORM：
- 注解驱动的实体映射：通过注解声明表名、主键、字段、字段策略等
- 元数据解析与缓存：在启动阶段解析实体类，生成表与字段元信息并缓存
