单表增删改查占掉持久层大半工作量,却要为每张表写一套 XML——MyBatis-Plus(下称 MP)把这部分全免了:继承一个 BaseMapper,二十来个通用方法直接可用。这一篇不止讲用法,重点拆它的设计思想——以及同一思想在 easy-es 上的复刻,学会「从框架里抄思想」。
// 实体映射:注解对齐表结构
@TableName("t_order")
public class Order {
@TableId(type = IdType.ASSIGN_ID) // 雪花ID,17.2 会拆
private Long id;
private String orderNo;
@TableLogic // 逻辑删除标记位
private Integer deleted;
}
public interface OrderMapper extends BaseMapper<Order> {}
// 到这为止:insert/deleteById/selectById/selectPage 全部可用
条件构造器代替手写 XML:
LambdaQueryWrapper<Order> w = new LambdaQueryWrapper<Order>()
.eq(Order::getOrderNo, "A001") // 方法引用编译期查列名
.gt(Order::getAmount, 100)
.orderByDesc(Order::getCreateTime);
List<Order> list = orderMapper.selectList(w);
Lambda 写法的好处实打实:列名用方法引用表达,重构改名时编译器替你揪出所有查询——字符串列名的那种「改了实体忘了改 XML」事故从此绝迹。
15.2 讲过 Mapper 是接口加动态代理,代理按「namespace + 方法名」查表路由。MP 的招数是在启动时动态注入:扫描到继承 BaseMapper 的接口,就把二十来个通用方法的 SQL 元信息(按实体注解推导出表名、列名)批量注册进 MyBatis 的路由表——通用方法的「XML」是运行期现生成的。
这一手是标准的「约定优于配置」:实体上的 @TableName/@TableId 提供元数据,注解扫描生成 SQL,MyBatis 原生引擎照常执行。MP 没有 fork MyBatis,只是站在它的扩展点上盖了一层楼——好的增强框架不换发动机,只加涡轮。插件生态同理:分页插件是 15.2 说的 Interceptor 实现,逻辑删除、乐观锁、自动填充都是同一机制的变体。
Mapper 之上还有一层 IService(MP 的服务层封装:把通用 CRUD 再包一遍并附 saveBatch 等增强):ServiceImpl<OrderMapper, Order> 继承即得批量插入、saveOrUpdate(按主键存在性自动插或改)、链式查询。它真正省心的是 saveBatch——底层走 BatchExecutor 批量刷新,千条数据几次往返完成,替代手写循环 insert 的经典反模式。分层含义也要看懂:Mapper 层对应「表操作」,IService 层对应「业务可复用操作」——团队里最常见的用法是业务 Service 继承 IService 拿通用能力,再写自己的领域方法。
自动填充(MetaObjectHandler:插入/更新时自动写入审计字段的插件)则是另一枚高频内置件——createBy、createTime、updateTime 这些每张表都要的审计列,实现两个方法统一注入,业务代码一行都不用写:
@Component
public class AuditFill implements MetaObjectHandler {
@Override
public void insertFill(MetaObject meta) {
this.strictInsertFill(meta, "createTime",
LocalDateTime.class, LocalDateTime.now());
}
@Override
public void updateFill(MetaObject meta) {
this.strictUpdateFill(meta, "updateTime",
LocalDateTime.class, LocalDateTime.now());
}
}
「谁改的、什么时候改的」这条审计线靠它铺满全库——出事故溯源时(9.6 的排查场景)这些字段就是第一手证物。
逻辑删除(用标记位代替物理 DELETE 的软删方案)一行注解生效:deleteById 变成 UPDATE ... SET deleted=1,所有查询自动追加 WHERE deleted=0。注意它和唯一索引的冲突:同名字段软删后重建会撞唯一键,常见解法是删除时间戳混入唯一索引。
乐观锁(用版本号CAS防并发覆盖,9.5 的老朋友)@Version 注解配插件:更新自动带 WHERE version=? 并自增,影响行数为 0 说明被别人抢先——重试或放弃由业务决定。数据库层的并发武器,被封装成了 ORM 的一行注解。
easy-es 把 MP 的完整体验搬到了 Elasticsearch 上:BaseMapper 对应的接口、Lambda 条件构造器、分页插件一应俱全,只是 SQL 换成了 DSL。对比原生写法的差距一目了然:手搓一个 bool 查询要拼几十行 JSON 字符串,easy-es 里是三行链式调用。
它证明这套设计的可迁移性:「元数据 + 约定 + 动态注入 + 链式构造器」 这个组合,换一个存储引擎照样成立。评估同类框架时可以直接拿这四件套当 checklist——四件齐备的是好抽象,缺一件的用起来就会在某处漏气。读框架读出可搬运的模式,比背十个 API 值钱得多。
选型上给 easy-es 一个务实定位:它适合「把 ES 当搜索引擎用的业务团队」——商品检索、日志门户这类以标准查询为主的场景,链式构造器的开发效率优势尽显。但 ES 的高级能力(聚合分析的多层嵌套、自定义评分函数、索引别名零停机切替)在 ORM 抽象里容易失真,重度搜索工程仍建议保留原生 DSL 层——和 MP 与原生 XML 的分工完全同构:抽象层管常规流量,原生层接深度定制,这个「二八分层」本身就是可复用的架构判断。
单表神器,复杂联查是它的盲区。多表 join、报表级 SQL,MP 的构造器写起来比 XML 还绕——官方也建议复杂场景退回 MyBatis 原生 XML。工程上的常见分工:单表 CRUD 用 MP 爽完,复杂查询进 XML 精雕(9.1 的 SQL 优化功力在这发挥),两者共存于同一项目毫无冲突——MP 本来就是 MyBatis 的超集,不是替代品。
MyBatis-Plus 用「约定推导 + 动态注入」给单表 CRUD 免了票,easy-es 证明这套四件套思想可跨引擎复刻——学框架学到能抽出模式,才算真学到了。