Repository navigation
code-association 0.6.1
code-association 0.6.1
跨程序变更影响扫描工具(Java / Maven 多模块仓库):分析一次提交改动了哪些类、方法、
SQL、MQ 消息结构,并推导出对其他模块 / 服务的连带影响与风险等级。
这一版没有新功能,全部是 0.6.0「字段级数据库契约」落地之后暴露出来的误报与漏报。
数据库契约的准入条件现在固定为四步:同一数据库对象 → 变更可被观察 → 类型兼容 →
字段级命中。不满足的不扩散,只计数并在报告里说明,或者进「字段盲区」等人确认。
此前「同名表就命中」「加一列和删一列一样严重」这类结果不会再出现。
本次重点:先确认是同一张表
- 契约 key 仍是
表.字段,但匹配前先比较两侧的数据源身份:从
spring.datasource.url/spring.datasource.*.url/spring.datasource.hikari.jdbc-url
解析数据库名,从 SQL 与 DDL 的schema.table读取显式 schema。 - 两侧都已知且同层级不同 → 排除并计数;一侧未知 → 保留匹配但降低置信度;
H2 mem / HSQLDB / Derby / SQLite 视为未知,因为进程内数据库不共享数据。 - 报告会说明有多少候选因数据库不同被排除、多少条因一侧未声明数据库而无法确认同库,
而不是让它们悄悄消失。
本次重点:DDL 按「变更可被观察」分型
- 会扩散:
DROP COLUMN、收窄类型(VARCHAR(64) → VARCHAR(32)、BIGINT → INT)、
类型族变化 → 命中读方、写方、映射方。 - 不扩散只计数:
ADD COLUMN、CREATE TABLE、删除迁移脚本、
类型放宽(VARCHAR(32) → VARCHAR(64)、INT → BIGINT)。加列 / 建表 / 删除迁移脚本
以前是「悄悄消失」,现在报告给出「对对方不可观察的变更」计数与示例。 - 新增
ColumnTypeCompatibility:按字符串长度、整数等级、decimal 精度 / scale、
可空性与安全提升判断兼容性;判断不了就保留命中并降低置信度,不猜。 - decimal 的整数位补上了:
DECIMAL(10,2) → DECIMAL(10,4)的 scale 变大、precision 不变,
但整数位从 8 位降到 6 位,12345678.99放不进去——现在按收窄扩散,不再当成兼容抑制。 - 加列只对
SELECT */ 无列名 INSERT 形成字段盲区;删除迁移脚本不再被当成 schema 回滚。
本次重点:实体映射与数据库 schema 解耦
FIELD_ADDED不再产生数据库 delta;FIELD_REMOVED/FIELD_TYPE_CHANGED
只对同样映射该列的对方代码给出低置信度 mapping 提示,不再命中 SQL 读写方。@Transient、static、集合类型不建列映射;显式@Column/@JoinColumn
优先于隐式命名;隐式命名按 Hibernate 边界转换(userID → user_id、URLPath → url_path)。
本次重点:解析加固
- 解析前剥离 SQL 行注释与块注释:注释掉的
ALTER TABLE ... DROP COLUMN不再生效,
纯注释改动不再产生SQL_CHANGED。 - MySQL 的
#行注释同样识别:#注释里的分号不再把一条 DDL 切成两条。
MyBatis 的#{id}占位符与 PostgreSQL 的#>/#-运算符不受影响。 - 单引号内的反斜杠转义被识别:
'it\'s'不再被当成「字符串到此结束」,
后半句不会被当作 SQL 解析。 - 同一 SQL 从一个 mapper / 迁移文件移到另一个时,按规范化文本配对
SQL_REMOVED与SQL_ADDED并抵消——「文件搬家」不会被读成「本程序停止写这一列」。 - 动态 SQL(
<if>/<choose>/<foreach>/<include>、占位符拼接)不再降级为
表级契约,对方侧改为计入字段盲区。 src/test/下的 mapper、schema.sql、data.sql与迁移脚本不参与生产契约。ADD INDEX/ADD CONSTRAINT/DROP INDEX不再被当成列;INSERT ... SELECT
读取目标列清单;ON DUPLICATE KEY UPDATE不再凭空造出名为status的表。- ALTER / 迁移脚本:识别 PostgreSQL 风格
ALTER COLUMN ... SET/DROP NOT NULL / SET DEFAULT、
ADD/DROP COLUMN IF [NOT] EXISTS、RENAME COLUMN;多动作 ALTER 的类型不再吞掉后续动作;
迁移脚本按数值版本排序(V10 在 V2 后);按引号 / 注释外的分号切分语句;
DDL 只在语句开头识别,字符串字面量里的CREATE TABLE不再污染快照。
报告
- 新增「因数据库不同被排除」「因类型兼容被排除」「对对方不可观察」三组计数与说明。
- 兼容变更与不可观察变更按变更计:此前按「变更 × 对比程序」累加,对比的程序越多,
同一个数字越大。 - 字段盲区口径修正为「读写列都没解析出来或语句不完整」,已作为 writer 命中的纯写语句
不重复计入。 - 文档新增
docs/wiki/数据库影响判断.md:四个准入条件、DDL 分型对照表、类型兼容规则、
字段盲区口径,以及仍然存在的边界(值语义、事务并发、视图 / 触发器 / 存储过程、运行时 SQL)。
下载
| 文件 | 说明 |
|---|---|
code-association-0.6.1.jar |
可执行 jar 单文件,应用内「自动更新」用的就是它 |
code-association-0.6.1.zip |
Windows 推荐(自带解压即可,保留 CRLF) |
code-association-0.6.1.tar.gz |
Linux / macOS 推荐 |
两个压缩包内容完全一致,均包含:可执行 jar、start.sh / stop.sh、
start.bat / stop.bat / start.ps1 / stop.ps1、application.yml 示例配置、
README.md、docs/ 与 INSTALL.md。
运行
Linux / macOS
tar -xzf code-association-0.6.1.tar.gz # 或 unzip code-association-0.6.1.zip
cd code-association-0.6.1
chmod +x start.sh stop.sh
./start.sh # 默认 http://127.0.0.1:9996
./stop.shWindows
:: 解压 zip,进入解压目录
start.bat :: 默认 http://127.0.0.1:9996
stop.bat需要 JDK 21+。详见包内 INSTALL.md。
升级说明
从 0.3.0 起可以直接用应用内更新:设置 → 版本与更新 → 应用更新 → 按提示重启。
0.6.0 起换完 jar 会自己重启(auto-restart 默认开),失败自动回滚到备份 jar;
更早的版本换完只会提示你自己执行 stop.sh / start.sh。
0.3.0 及更早的版本没有应用内更新,请手动下载替换 jar(旧 jar 会被备份为 .bak-<版本>,可回滚)。
这一版只改分析结果,不改接口、配置与更新机制:升级后不需要改 application.yml,
历史报告也不会被重写——要看到新的判定,请重新分析一次。