Skip to content

code-association 0.6.1

Choose a tag to compare

@geek-xin geek-xin released this 28 Oct 03:03
· 9 commits to main since this release

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.sh

Windows

:: 解压 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,
历史报告也不会被重写——要看到新的判定,请重新分析一次。