mybatis vs mybatis-plus

 

   

​​核心关系：​​ MyBatis-Plus ​​不是​​ MyBatis 的替代品，而是构建在 MyBatis ​​之上​​的一个强大的​​增强工具包​​。它完全兼容原生 MyBatis，并在其基础上提供了大量开箱即用的功能，极大地简化了开发，尤其是单表操作。

---

​​一、 MyBatis 核心原理​​

MyBatis 的核心思想是将 ​​SQL 语句从 Java 代码中解耦​​，通过配置或注解来管理 SQL，并提供灵活的 ORM 映射。其核心原理围绕以下几个关键组件和流程：

1. ​​SqlSessionFactoryBuilder & SqlSessionFactory:​​

   • ​​作用：​​ 应用启动时，读取 MyBatis 的全局配置文件 (mybatis-config.xml) 和所有的 Mapper XML 文件（或注解配置）。
   • ​​原理：​​ SqlSessionFactoryBuilder 解析这些配置文件，构建出包含所有配置信息（数据源、事务管理器、类型处理器、插件、Mapper 注册信息等）的 Configuration 对象，并最终创建出 SqlSessionFactory。SqlSessionFactory 是生产 SqlSession 的工厂。

2. ​​SqlSession:​​

   • ​​作用：​​ 代表一次与数据库的会话。它是 MyBatis 工作的​​核心入口​​。
   • ​​原理：​​ 通过 SqlSessionFactory.openSession() 获取。它提供了执行 SQL 命令（selectOne, selectList, insert, update, delete）、获取 Mapper 接口代理对象、管理事务等方法。每个 SqlSession 通常对应一个数据库连接（或连接池中的一个连接）。

3. ​​Executor:​​

   • ​​作用：​​ SqlSession 内部真正​​执行 SQL 操作​​的组件。
   • ​​原理：​​ SqlSession 将请求委托给 Executor。Executor 负责维护一级缓存（SqlSession 级别）、处理延迟加载、调用 StatementHandler 等。常见的实现有 SimpleExecutor（每次执行创建新 Statement）、ReuseExecutor（重用 Statement）、BatchExecutor（批处理）。

4. ​​StatementHandler:​​

   • ​​作用：​​ 负责​​创建 JDBC Statement 对象​​（PreparedStatement, CallableStatement, Statement），并​​设置参数​​、​​执行 SQL​​。
   • ​​原理：​​ Executor 调用 StatementHandler。它使用 ParameterHandler 将 Java 对象参数设置到 SQL 的占位符 (?) 上。

5. ​​ParameterHandler:​​

   • ​​作用：​​ 负责将​​用户传入的 Java 参数​​，按照 SQL 语句中的占位符 (?) 进行​​类型转换和设置​​。
   • ​​原理：​​ 利用注册的 TypeHandler 完成 Java 类型到 JDBC 类型的转换。

6. ​​TypeHandler:​​

   • ​​作用：​​ 负责 ​​Java 类型和 JDBC 类型之间的相互转换​​。
   • ​​原理：​​ MyBatis 内置了常用类型（如 String, Integer, Date 等）的处理器。用户可以自定义处理器处理特殊类型（如枚举）。

7. ​​ResultSetHandler:​​

   • ​​作用：​​ 负责将 JDBC ResultSet 返回的结果集​​转换​​为​​指定的 Java 对象​​（单个对象、List、Map 等）。
   • ​​原理：​​ 根据 Mapper 方法定义的返回类型（或 resultMap 配置），利用 TypeHandler 和反射，将结果集的每一行数据映射成 Java 对象。

8. ​​MappedStatement:​​

   • ​​作用：​​ 代表一个映射的 SQL 语句。它是 MyBatis 配置的核心单元。
   • ​​原理：​​ 存储了 SQL 语句本身（<select>, <insert> 等标签的内容）、参数映射信息 (<parameterMap> 或 @Param)、结果映射信息 (<resultMap> 或 @Result)、SQL 命令类型（SELECT/INSERT 等）、缓存配置等。一个 Mapper 接口方法对应一个 MappedStatement。

9. ​​配置方式：​​

   • ​​XML 配置：​​ 主要方式。通过 mybatis-config.xml 配置全局设置，通过 Mapper.xml 文件定义 SQL 和映射关系。
   • ​​注解配置：​​ 在 Mapper 接口方法上使用 @Select, @Insert, @Update, @Delete, @Results 等注解直接编写 SQL 和映射规则。通常用于简单 SQL。

​​MyBatis 工作流程总结：​​

1. 应用启动：解析配置 -> 构建 Configuration -> 创建 SqlSessionFactory。
2. 业务请求：SqlSessionFactory -> 创建 SqlSession。
3. 执行操作：
   • 通过 SqlSession 直接执行 SQL 方法 (selectOne, update 等)。
   • 或通过 SqlSession.getMapper() 获取 Mapper 接口的​​动态代理对象​​。
4. 代理对象调用：代理对象根据方法名找到对应的 MappedStatement。
5. Executor 执行：Executor 根据 MappedStatement 信息，调用 StatementHandler 创建 Statement。
6. ParameterHandler 设置参数。
7. StatementHandler 执行 SQL。
8. ResultSetHandler 处理结果集，映射为 Java 对象。
9. 返回结果。

​​优点：​​ 灵活、SQL 可控性强、与 JDBC 解耦、支持复杂映射、插件扩展性强。
​​缺点：​​ 需要编写大量 SQL 和 XML/注解（尤其是简单 CRUD）、配置繁琐。

---

​​二、 MyBatis-Plus (MP) 核心原理​​

MP 的核心原理是在 ​​MyBatis 原有架构和机制的基础上​​，通过一系列封装、扩展和自动化技术，​​极大地简化单表操作和常用功能开发​​。它没有改变 MyBatis 的核心流程，而是增强了它。

1. ​​核心增强点：BaseMapper 与 SqlInjector / AbstractMethod​​

   • ​​原理：​​ MP 的核心创新。用户 Mapper 接口只需继承 BaseMapper。在应用启动时，MP 的 SqlInjector (如 DefaultSqlInjector) 会扫描这些 Mapper。
   • ​​动态 SQL 生成：​​ 对于 BaseMapper 中的每个方法（insert, selectById, update 等），MP 都有一个对应的 AbstractMethod 子类（如 Insert, SelectById, Update）。这些子类在启动时，利用实体类的元数据 (TableInfo，由 @TableName, @TableId 等注解解析而来) 和预定义的 SQL 模板 (SqlMethod)，​​动态生成​​该方法的完整 SQL 语句和 MappedStatement 对象，并注册到 MyBatis 的 Configuration 中。
   • ​​结果：​​ 开发者无需为这些通用方法编写任何 SQL 或 XML，MP 自动提供实现。

2. ​​强大的条件构造器 (Wrapper)​​

   • ​​原理：​​ 提供 QueryWrapper, UpdateWrapper, LambdaQueryWrapper 等。用户通过链式调用构建复杂的查询/更新条件（eq, like, between, set 等）。
   • ​​SQL 拼接：​​ Wrapper 内部将条件表达式存储为结构化的数据。当 Wrapper 被用于查询或更新方法时，MP 的 SQL 生成引擎会安全地（防止 SQL 注入）将这些条件​​解析并拼接到自动生成的基础 SQL 的 WHERE 子句或 SET 部分​​。

3. ​​自动配置与 Starter (Spring Boot)​​

   • ​​原理：​​ 提供 mybatis-plus-boot-starter。利用 Spring Boot 自动配置机制，自动创建和配置 DataSource, SqlSessionFactoryBean（注入 MP 的核心组件如 GlobalConfig, Interceptor）, MapperScannerConfigurer 等，大大简化了集成步骤。

4. ​​插件体系增强​​

   • ​​原理：​​ 继承并扩展 MyBatis 的 Interceptor 接口，提供功能更强大、开箱即用的内置插件：
     • PaginationInnerInterceptor： 自动处理物理分页（生成 COUNT 查询和分页 SQL）。
     • OptimisticLockerInnerInterceptor： 自动实现乐观锁（基于 @Version 注解）。
     • BlockAttackInnerInterceptor： 防止全表更新/删除（安全防护）。
     • DynamicTableNameInnerInterceptor： 动态表名。
     • IllegalSQLInnerInterceptor： SQL 性能分析/阻止恶意 SQL。
   • ​​工作方式：​​ 这些插件在 MyBatis 的执行流程（主要是 Executor 阶段）进行拦截，添加额外功能。

5. ​​全局配置与元数据处理​​

   • GlobalConfig： 存储全局配置（表前缀、主键生成器策略、元对象处理器等）。
   • MetaObjectHandler： 实现​​自动填充​​功能（@TableField(fill = ...)）。在插入或更新时，通过反射自动填充字段（如 createTime, updateTime）。

6. ​​注解驱动增强​​

   • ​​原理：​​ 在 MyBatis 注解基础上，提供更丰富的 ORM 和功能注解：
     • @TableName： 指定表名。
     • @TableId： 指定主键及策略（自增、UUID、雪花ID等）。
     • @TableField： 指定字段映射、自动填充策略、是否存在等。
     • @Version： 乐观锁版本字段。
     • @EnumValue： 枚举值映射。
     • @TableLogic： 逻辑删除标记。
     • @SqlParser： 过滤 SQL 解析（用于跳过某些拦截器）。
   • 这些注解信息在启动时被解析并存储在 TableInfo 等元数据对象中，供 SQL 生成、条件构造、插件等使用。

​​MP 工作流程总结：​​

1. ​​启动阶段：​​
   • 自动配置（Spring Boot Starter）。
   • 扫描实体类注解，构建 TableInfo 等元数据。
   • 扫描 Mapper 接口（继承 BaseMapper）。
   • SqlInjector 为 BaseMapper 的每个方法注入对应的 AbstractMethod 实现。
   • AbstractMethod 子类利用元数据和 SQL 模板，动态生成 MappedStatement 并注册。
   • 配置并添加 MP 的内置插件到 InterceptorChain。
2. ​​运行时阶段：​​
   • 与原生 MyBatis 流程基本相同（SqlSession -> Executor -> ...）。
   • 当调用 BaseMapper 方法时，执行的是 MP 动态生成的 MappedStatement。
   • 当使用 Wrapper 时，MP 在生成 SQL 时会解析并拼接 Wrapper 的条件。
   • MP 的插件在相应执行点进行拦截，提供分页、乐观锁等功能。

​​优点：​​ 极大简化 CRUD、减少 SQL/XML 编写、内置强大功能（分页、代码生成器、乐观锁、逻辑删除等）、增强条件构造、提高开发效率。
​​缺点：​​ 对复杂 SQL 和多表关联查询的支持不如直接手写 SQL/XML 灵活（虽然也能用），需要学习 MP 特有的 API 和注解。

---

​​三、 MyBatis vs MyBatis-Plus 核心对比总结​​

特性	MyBatis	MyBatis-Plus (MP)	说明
​​定位​​	灵活的 SQL 映射框架	MyBatis 的增强工具包	MP 基于 MyBatis，不是替代品。
​​核心目标​​	SQL 与代码解耦，灵活控制 SQL	​​简化开发​​，尤其是单表 CRUD	MP 专注于减少样板代码。
​​SQL 编写​​	​​必需​​ (XML 或注解)	​​可选​​ (对单表 CRUD 自动生成)	MP 的 BaseMapper 自动提供通用方法实现。复杂 SQL 仍需手写。
​​CRUD 实现​​	手动编写每个 CRUD 方法的 SQL 和映射	​​自动实现​​ BaseMapper 中的通用 CRUD 方法	MP 的核心优势，省去大量简单 SQL 编写。
​​条件构造​​	手动拼接 SQL 条件字符串 (易错，不安全)	强大的 ​​Wrapper API​​ (链式调用，类型安全 - LambdaWrapper，防注入)	MP 提供面向对象的、安全的条件构建方式。
​​分页​​	需手动编写分页 SQL (不同数据库语法不同)	内置 ​​PaginationInterceptor​​ (自动物理分页)	MP 的分页插件自动处理不同数据库方言、COUNT 查询和数据获取。
​​主键生成​​	需在 SQL 或配置中处理	支持多种策略 (@TableId)，内置分配器 (雪花ID等)	MP 简化了主键管理。
​​逻辑删除​​	需手动在 SQL 中添加条件	内置支持 (@TableLogic)，自动添加过滤条件	MP 自动在查询/更新中处理逻辑删除字段。
​​乐观锁​​	需手动实现版本控制逻辑	内置支持 (@Version)，通过插件自动处理	MP 简化了乐观锁实现。
​​自动填充​​	需手动在代码中设置	内置支持 (@TableField(fill) + MetaObjectHandler)	MP 自动填充如创建时间、更新时间等字段。
​​代码生成器​​	无官方提供，需用第三方或自研	提供功能强大的 ​​代码生成器​​	MP 可快速生成 Entity, Mapper, Service, Controller 等基础代码。
​​安全防护​​	无内置	提供 ​​BlockAttackInnerInterceptor​​ 等安全插件	MP 防止全表更新/删除等危险操作。
​​配置复杂度​​	相对较高 (需配置较多 XML/注解)	​​显著降低​​ (尤其结合 Spring Boot Starter)	MP 的自动配置和默认行为减少了大量配置。
​​学习曲线​​	掌握 SQL/XML 映射和核心组件即可	需额外学习 MP 特有的 API (Wrapper, BaseMapper), 注解和插件	MP 增加了自己的抽象层。
​​灵活性​​	​​极高​​，完全掌控 SQL	对单表操作灵活，对​​复杂 SQL/多表​​ 灵活性相对降低	MP 处理复杂场景时，有时仍需回退到原生 MyBatis 方式 (手写 SQL/XML)。
​​适用场景​​	需要极致 SQL 控制、复杂查询、存储过程调用	快速开发、大量单表操作、需要内置功能 (分页/乐观锁等)	两者并非互斥，可在同一项目中结合使用。

​​总结：​​

• ​​MyBatis：​​ 是​​基础​​，提供了灵活、强大的 SQL 映射能力，将开发者从 JDBC 的繁琐中解放出来，但需要编写大量 SQL 和配置。
• ​​MyBatis-Plus：​​ 是​​增强​​，在 MyBatis 的基础上，通过自动化生成、强大的条件构造器、丰富的内置功能（分页、代码生成、乐观锁等）和便捷的配置（特别是 Spring Boot），​​极大地提升了开发效率，尤其擅长处理单表操作​​。它保留了 MyBatis 的灵活性，对于复杂场景，你仍然可以像使用原生 MyBatis 一样编写自定义 SQL。

​​选择建议：​​

• 如果你的项目有​​大量简单的单表 CRUD 操作​​，追求​​开发效率​​，且需要​​分页、乐观锁​​等常见功能，​​MyBatis-Plus 是绝佳选择​​。
• 如果你的项目​​极其复杂​​，涉及大量​​定制化 SQL、存储过程、复杂的多表关联和嵌套查询​​，或者你对 SQL 有​​绝对的控制欲​​，​​原生 MyBatis 可能更合适​​（或者结合使用，复杂部分用原生）。
• ​​实际项目中，两者结合使用非常常见：​​ 简单 CRUD 用 MP 的 BaseMapper 和 Wrapper，复杂查询或存储过程调用则使用原生 MyBatis 的 XML 或注解方式编写 SQL。MP 的 @SqlParser(filter=true) 可以让你在同一个 Mapper 中混合使用这两种方式。