S-mall-ssm 自定义MyBatis Generator插件实战：完美隔离生成代码与手写代码

S-mall-ssm 自定义MyBatis Generator插件实战完美隔离生成代码与手写代码【免费下载链接】S-mall-ssm小小商城系统JavaWEB项目基于SSM仿天猫页面功能齐全实现了自动处理关联查询的通用Mapper、抽象 BaseService 类、注解鉴权、参数注解校验等项目地址: https://gitcode.com/gh_mirrors/smal/S-mall-ssm在 SSM 电商项目开发中MyBatis Generator简称 MBG是生成实体类、Mapper 接口与 XML 的利器但一键生成后手写代码被覆盖的痛点困扰着无数开发者。开源商城项目S-mall-ssm通过自定义MyBatis Generator插件实现了生成代码与手写代码的完美隔离生成代码只负责骨架手写代码集中在 Extension 扩展层从此重复生成不再害怕冲突。本文带新手与普通开发者看懂这套实战设计。先看看效果一个仿天猫商城的数据之美S-mall-ssm 是一个页面仿天猫、功能齐全的 SSM 电商系统商品、分类、订单、购物车等模块一应俱全。这套复杂的数据关系正是考验代码生成与手写逻辑能否和平共处的最佳舞台。为什么必须隔离生成代码与手写代码很多团队用 MBG 时面临两难全部手写10 张表就要手敲 10 套实体类、Mapper、Example枯燥且易错。全部生成一旦业务复杂生成代码又难以覆盖自定义查询与业务逻辑。S-mall-ssm 给出的答案是**各司其职**让 MBG 生成的代码继承、实现项目预置的基础类而所有业务扩展代码放进专门的 extension 包。重新运行生成器时只会覆盖生成目录手写代码安然无恙。核心思路三个钩子让生成代码自动归位S-mall-ssm 的隔离方案建立在三个预置的基类/接口之上它们都位于 pojo/base 包 与 mapper 包BasePOJO所有实体类的基础类内置id与deleteAt字段为软删除打底BasePOJO.javaBaseExample所有查询条件类的统一接口约束createCriteria()等通用能力BaseExample.javaBaseMapper泛型 Mapper 接口BaseMapperP, E明确 POJO 与 Example 的对应关系BaseMapper.java配合一个标记接口 POJOMapper.java让生成的 POJO 反向关联到自己的 Mapper为后续通用 Mapper 的自动关联查询埋下伏笔。四大自定义MBG插件逐一看懂所有插件都放在 MBGPlugins 包 中每个插件只做一件事职责非常清晰。1. POJOExtendsPlugin让实体类自动继承 BasePOJOPOJOExtendsPlugin.java 在modelBaseRecordClassGenerated回调中为生成的实体类自动加上extends BasePOJO并实现POJOMapper对应Mapper。效果是生成的 Product、Category 等类无需手改就自带id、deleteAt字段和与 Mapper 的关联。2. MapperExtendsPlugin让 Mapper 接口自动继承 BaseMapperMapperExtendsPlugin.java 通过clientGenerated回调让生成的 Mapper 接口自动继承BaseMapper实体, Example。这样一来通用 Mapper 层就能以统一的泛型方式拿到每个表的实体与查询条件类。3. ExampleExtendsPlugin让查询条件类自动实现 BaseExampleExampleExtendsPlugin.java 在modelExampleClassGenerated中为生成的 Example 类加上implements BaseExample统一了所有条件类的入口通用查询逻辑因此可以面向接口编程。4. DeleteAtPlugin一行代码让全表支持软删除这是最有实用价值的一个。DeleteAtPlugin.java 会在生成的 SQL 片段中自动追加and deleteAt is NULL覆盖selectByPrimaryKey和 Example 查询。配合 BasePOJO 里的deleteAt字段全项目所有表的查询只查有效数据瞬间完成无需为每张表手写条件。手写代码放哪里答案在 Extension 包生成代码解决通用手写代码解决业务。S-mall-ssm 将手写逻辑统一放在 pojo/extension 包ProductExtension、CategoryExtension、OrderExtension 等类扩展生成实体所没有的业务字段与关联对象手写的 Mapper XML如 ProductMapper.xml、OrderMapper.xml与生成代码分文件存放重复生成零风险扩展类中配合ManyToOne、OneToMany、JoinColumn等 ORM 注解再由通用 MapperMapper4ORM.java在读写时自动完成关联对象的填充相当于给 SSM 项目装上了迷你 Hibernate。落地之后写业务到底有多省有了这套隔离架构业务层只依赖手写扩展类BaseService 层则通过泛型把增删改查、分页等通用能力抽象出来可参考 BaseService.java 与 BaseServiceImpl.java。新增加一张表时你只需运行生成器核心入口见 MybatisGenerator.java生成代码自动归位到基础类体系在 Extension 包补充业务字段与自定义查询完事重新生成绝不覆盖手写内容总结给新手的三点启示插件要小每个 MBG 插件只处理一个回调、一个职责S-mall-ssm 的四个插件是绝佳范本基类要稳BasePOJO / BaseExample / BaseMapper 是隔离的锚点设计好它们就成功了一半目录要分生成代码与手写代码物理隔离比任何约定都可靠如果你正被 MBG 覆盖问题困扰不妨把 S-mall-ssm 的这套自定义MyBatis Generator插件方案移植到自己的项目里——克隆仓库后直接查看 MBGPlugins 目录照着抄就能用。【免费下载链接】S-mall-ssm小小商城系统JavaWEB项目基于SSM仿天猫页面功能齐全实现了自动处理关联查询的通用Mapper、抽象 BaseService 类、注解鉴权、参数注解校验等项目地址: https://gitcode.com/gh_mirrors/smal/S-mall-ssm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考