fix(flow): BpmnIdSanitizer 评审收口——safe占位契约测试+空白原样+inverse fail-fast

- I-1:补「生成净化 id 不与文档既有合法字面 id 冲突」契约测试。fixture 含合法字面
  id nb7af8 + 中文 id 审批(其 hashCode&0x7fffffff 的 hex 恰为 b7af8)→ 断言 审批 让位
  映射为 nb7af8-2、既有 nb7af8 不动、restore 逐字节还原。
- M-1:rewrite 未改值的属性原样回写(append group(0)),不再重构 → 不归一 id = "x" 这类
  等号周围空白,保逐字节契约。补测:带等号空白的合法属性 + 非空 map,round-trip 后原文不变。
- M-2:restore 反转 idMap 时检测净化 id 重复(非双射,损坏 metaInfo)抛 IllegalArgumentException,
  不再静默覆盖还原错。补 fail-fast 测试。

测试:BpmnIdSanitizerTest 7→10 例;ProcessDiagramControllerTest 4 例仍零修改;
flowable-service 全模块 mvn -pl flowable-service -am test = 68 测试 0 失败 0 错误。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-02 10:24:14 +08:00
parent 33fccb6541
commit e361d3a9ad
2 changed files with 73 additions and 4 deletions

View File

@@ -160,4 +160,64 @@ class BpmnIdSanitizerTest {
assertThat(BpmnIdSanitizer.restore(null, Map.of())).isNull();
assertThat(BpmnIdSanitizer.restore("<a/>", Map.of())).isEqualTo("<a/>");
}
/**
* 生成的净化 id 不与文档内既有合法字面 id 冲突(used 占位契约)。
* "审批".hashCode()&0x7fffffff 的 hex 恰为 b7af8 → 基名 "nb7af8" 与合法字面 id "nb7af8" 撞
* → sanitize 须让 审批 映射为 nb7af8-2(否则 restore 会误改那个合法 id),restore 逐字节还原。
*/
@Test
void 净化id不与既有合法id冲突_让位加序号() {
assertThat(Integer.toHexString("审批".hashCode() & 0x7fffffff)).isEqualTo("b7af8"); // 前置自证
String xml = """
<process id="p">
<userTask id="nb7af8"/>
<userTask id="审批"/>
<sequenceFlow id="f" sourceRef="nb7af8" targetRef="审批"/>
</process>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 中文 id 让位到 -2;既有合法字面 id nb7af8 原样不动、不入 map
assertThat(r.idMap()).containsOnlyKeys("审批");
assertThat(r.idMap().get("审批")).isEqualTo("nb7af8-2");
assertThat(r.xml()).contains("id=\"nb7af8\"");
assertThat(r.xml()).contains("sourceRef=\"nb7af8\"");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* M-1 逐字节契约:未改值的合法属性(含等号周围空白)须原样回写,不被重构归一。
* 即便 map 非空(另有中文 id 被改),带空白的合法属性 round-trip 后原文不变。
*/
@Test
void 未改值属性含等号空白_原样保留不归一() {
// legalTask 用 `id = "..."`(等号带空格)合法写法;审批 是被净化的中文 id → map 非空
String xml = "<userTask id = \"legalTask\"/>"
+ "<userTask id=\"审批\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"legalTask\" targetRef=\"审批\"/>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 审批被改;legalTask 的等号空白写法逐字保留(旧实现会归一成 id="legalTask")
assertThat(r.idMap()).containsOnlyKeys("审批");
assertThat(r.xml()).contains("id = \"legalTask\"");
// round-trip 后原文逐字节不变
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/** M-2 fail-fast:idMap 值(净化 id)重复=非双射(损坏 metaInfo),restore 抛而非静默还原错。 */
@Test
void restore_idMap值重复_抛非双射异常() {
Map<String, String> broken = new LinkedHashMap<>();
broken.put("原A", "n1");
broken.put("原B", "n1"); // 两个原 id 映到同一净化 id → 反转会静默覆盖
String xml = "<userTask id=\"n1\"/>";
org.assertj.core.api.Assertions.assertThatThrownBy(() -> BpmnIdSanitizer.restore(xml, broken))
.isInstanceOf(IllegalArgumentException.class)
.hasMessageContaining("非双射")
.hasMessageContaining("n1");
}
}