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:
@@ -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");
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user