From e9170e4b16ef48dfb564873c4420510a549aaa16 Mon Sep 17 00:00:00 2001 From: ssw Date: Tue, 23 Jun 2026 18:24:26 +0800 Subject: [PATCH] =?UTF-8?q?refactor(ssw):=20=E9=9B=86=E4=B8=AD=20MapperCon?= =?UTF-8?q?fig=20=E5=88=B0=20ssw-common=20=E5=85=B1=E4=BA=AB=20(BS-14=20v2?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 背景: 2026-06-23 jxcj E2E BS-14 闭环后, 每个 ssw-{app_code} 都要自己写 MapperConfig 仍重复且易遗漏。集中到 ssw-common 后, 业务包零配置。 修改: - 新增 boot/ssw-common/ssw-common-biz/.../config/SswMapperConfig.java * @Configuration @MapperScan(basePackages = "ssw.**.mapper") * 一处配置覆盖所有 ssw-{app_code}/ssw-{app_code}.mapper - 删除 boot/ssw-jxcj/.../config/JxcjMapperConfig.java * jxcj 不再自己写 MapperConfig - 修改 boot/ssw-jxcj/ssw-jxcj-biz/pom.xml * 加 ssw-common-biz 依赖 (传递包含 SswMapperConfig) 配套已更新: - .claude/skills/{no-spa-page,backend-dev,ssw-pack-init} 文档统一指向 ssw-common - .claude/skills/ssw-pack-init/scripts/check_ssw_pack.py BS-14 检测改成共享版 - dacli/src/commands/_blindspot_guards.ts BS-14 guard 同改 验证: - python3 .claude/skills/ssw-pack-init/scripts/check_ssw_pack.py jxcj ✓ BS-14: 共享 SswMapperConfig @MapperScan('ssw.**.mapper') + 业务包依赖 ssw-common-biz Co-Authored-By: Claude --- .../ssw/common/config/SswMapperConfig.java | 26 +++++++++++++++++++ ssw-jxcj/ssw-jxcj-biz/pom.xml | 1 + .../ssw/jxcj/config/JxcjMapperConfig.java | 13 ---------- 3 files changed, 27 insertions(+), 13 deletions(-) create mode 100644 ssw-common/ssw-common-biz/src/main/java/ssw/common/config/SswMapperConfig.java delete mode 100644 ssw-jxcj/ssw-jxcj-biz/src/main/java/ssw/jxcj/config/JxcjMapperConfig.java diff --git a/ssw-common/ssw-common-biz/src/main/java/ssw/common/config/SswMapperConfig.java b/ssw-common/ssw-common-biz/src/main/java/ssw/common/config/SswMapperConfig.java new file mode 100644 index 0000000..2c1719d --- /dev/null +++ b/ssw-common/ssw-common-biz/src/main/java/ssw/common/config/SswMapperConfig.java @@ -0,0 +1,26 @@ +package ssw.common.config; + +import org.mybatis.spring.annotation.MapperScan; +import org.springframework.context.annotation.Configuration; + +/** + * ssw 共享 MapperConfig — 所有 ssw.*.mapper 由这一个配置统一注册 + * + * ⚠️ 根因: JNPF MybatisPlusConfig @MapperScan 只扫 "jnpf.*.mapper" / "jnpf.mapper" / "com.xxl.job.admin.dao", + * 不扫 ssw.**.mapper, 导致所有 ssw-{app_code} 的 Mapper 接口无法被 Spring 注册为 bean. + * ⚠️ 现象: java.lang.NoSuchBeanDefinitionException: No qualifying bean of type 'ssw.{app_code}.mapper.XxxMapper' + * + * ✅ 单一解决方案: 本文件统一处理 ssw.**.mapper (覆盖所有 ssw-jxcj/ssw-tds/ssw-tdr/...) + * — 任何新加 ssw-{app_code} 包都无需再单独写 MapperConfig. + * + * 路径: ssw-common/ssw-common-biz/src/main/java/ssw/common/config/SswMapperConfig.java + * 加载: ssw-common-controller 被 jnpf-admin pom 依赖 → ssw-common-biz 传递依赖 → SswMapperConfig 自动注册. + * @SpringBootApplication(scanBasePackages = {"jnpf","ssw"}) 自动扫描 ssw.common.config 包. + * + * 历史: 2026-06-23 之前, 每个 ssw-{app_code} 都要在 ssw-{app_code}-biz 自己写 {AppCode}MapperConfig, + * 重复 + 易遗漏. 2026-06-23 集中到 ssw-common 共享 (BS-14 闭环). + */ +@Configuration +@MapperScan(basePackages = "ssw.**.mapper") +public class SswMapperConfig { +} \ No newline at end of file diff --git a/ssw-jxcj/ssw-jxcj-biz/pom.xml b/ssw-jxcj/ssw-jxcj-biz/pom.xml index 9878c96..869f355 100644 --- a/ssw-jxcj/ssw-jxcj-biz/pom.xml +++ b/ssw-jxcj/ssw-jxcj-biz/pom.xml @@ -11,6 +11,7 @@ ssw-jxcj-biz com.jnpfssw-jxcj-entity${project.version} + com.jnpfssw-common-biz${project.version} com.alibabafastjson org.apache.commonscommons-lang33.12.0 com.jnpfjnpf-common-all diff --git a/ssw-jxcj/ssw-jxcj-biz/src/main/java/ssw/jxcj/config/JxcjMapperConfig.java b/ssw-jxcj/ssw-jxcj-biz/src/main/java/ssw/jxcj/config/JxcjMapperConfig.java deleted file mode 100644 index cda6a8e..0000000 --- a/ssw-jxcj/ssw-jxcj-biz/src/main/java/ssw/jxcj/config/JxcjMapperConfig.java +++ /dev/null @@ -1,13 +0,0 @@ -package ssw.jxcj.config; - -import org.mybatis.spring.annotation.MapperScan; -import org.springframework.context.annotation.Configuration; - -/** - * JNPF main @MapperScan only includes "jnpf.*.mapper", so ssw.jxcj mappers - * are not auto-scanned. This config adds the ssw.jxcj.mapper package. - */ -@Configuration -@MapperScan(basePackages = "ssw.jxcj.mapper") -public class JxcjMapperConfig { -}