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:
@@ -83,22 +83,31 @@ final class BpmnIdSanitizer {
|
||||
if (xml == null || xml.isEmpty() || idMap == null || idMap.isEmpty()) {
|
||||
return xml;
|
||||
}
|
||||
// 反转前校验双射:idMap 值(净化 id)重复会让 inverse 静默覆盖 → 还原错。fail-fast
|
||||
// (T2.1 起 idMap 从 metaInfo JSON 反序列化,损坏数据须炸不能静默还原成别的 key)。
|
||||
Map<String, String> inverse = new LinkedHashMap<>();
|
||||
for (Map.Entry<String, String> e : idMap.entrySet()) {
|
||||
inverse.put(e.getValue(), e.getKey());
|
||||
String clash = inverse.put(e.getValue(), e.getKey());
|
||||
if (clash != null) {
|
||||
throw new IllegalArgumentException("idMap 非双射:净化 id \"" + e.getValue()
|
||||
+ "\" 同时映射自 \"" + clash + "\" 与 \"" + e.getKey() + "\"");
|
||||
}
|
||||
}
|
||||
return rewrite(xml, inverse);
|
||||
}
|
||||
|
||||
/** 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。 */
|
||||
/**
|
||||
* 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。
|
||||
* 未改值的属性原样回写(append group(0) 原文),不重构 → 不归一 {@code id = "x"} 这类等号周围空白,保逐字节契约。
|
||||
*/
|
||||
private static String rewrite(String xml, Map<String, String> map) {
|
||||
Matcher rw = ID_ATTR.matcher(xml);
|
||||
StringBuilder sb = new StringBuilder();
|
||||
while (rw.find()) {
|
||||
String attr = rw.group(1);
|
||||
String val = rw.group(2);
|
||||
String repl = map.getOrDefault(val, val);
|
||||
rw.appendReplacement(sb, Matcher.quoteReplacement(attr + "=\"" + repl + "\""));
|
||||
String replacement = repl.equals(val) ? rw.group(0) : rw.group(1) + "=\"" + repl + "\"";
|
||||
rw.appendReplacement(sb, Matcher.quoteReplacement(replacement));
|
||||
}
|
||||
rw.appendTail(sb);
|
||||
return sb.toString();
|
||||
|
||||
@@ -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