diff --git a/ssw-dacli/src/main/java/ssw/dacli/form/builder/reverse/FormReverseDebugger.java b/ssw-dacli/src/main/java/ssw/dacli/form/builder/reverse/FormReverseDebugger.java new file mode 100644 index 0000000..45fc7fe --- /dev/null +++ b/ssw-dacli/src/main/java/ssw/dacli/form/builder/reverse/FormReverseDebugger.java @@ -0,0 +1,226 @@ +package ssw.dacli.form.builder.reverse; + +import ssw.dacli.form.builder.FieldBuilderFactory; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.Iterator; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * v13 Task 1.20 — form info 反向调试器. + * + *
读已有 form JSON (formData 字段), 提取 jnpfKey 分布, 跟 + * {@link FieldBuilderFactory#registeredKeys()} 对比, 输出未打磨控件列表. + * + *
典型用法: + *
+ * ReverseAnalysisReport r = new FormReverseDebugger().analyzeFormData(jsonStr);
+ * System.out.println(r.toJson());
+ * // 或:
+ * ReverseAnalysisReport r2 = new FormReverseDebugger().analyzeFormFile(Paths.get("form.json"));
+ *
+ *
+ * 关键扫描点: + *
注: 本类不是 FieldBuilder, 不需注册 SPI. 供 dacli form info --reverse 调用. + */ +public class FormReverseDebugger { + + private static final ObjectMapper M = new ObjectMapper(); + + /** + * 解析 formData JSON 字符串, 返回分析报告. + * + * @param formDataJson formData 字段的 JSON 内容 (从 form JSON 提取的 formData 部分) + * @return 分析报告 + */ + public ReverseAnalysisReport analyzeFormData(String formDataJson) { + if (formDataJson == null || formDataJson.isEmpty()) { + return emptyReport("(empty formData)"); + } + try { + JsonNode root = M.readTree(formDataJson); + return analyzeRoot(root); + } catch (Exception e) { + throw new RuntimeException("FormReverseDebugger.analyzeFormData failed: " + e.getMessage(), e); + } + } + + /** + * 读 form JSON 文件并分析. + * + *
支持两种输入: + *
FormReverseDebugger.analyzeFormData() / analyzeFormFile() 返回. + * 用于定位 form JSON 中 未打磨 的 jnpfKey (即无对应 FieldBuilder). + * + *
字段: + *
toJson() 用 Jackson 序列化为 pretty-printed JSON, 供 dacli form info --reverse 输出.
+ */
+public class ReverseAnalysisReport {
+
+ /** form 用到的 jnpfKey 列表 (去重, 按首次出现顺序) */
+ public final List 校验核心行为:
+ *
+ *
+ */
+public class FormReverseDebuggerTest {
+
+ private static final ObjectMapper M = new ObjectMapper();
+
+ @Test
+ public void testBasic() throws Exception {
+ // 构造 formData: formItems 含 input/datePicker/relationForm 3 字段
+ // 注: "select" 不是 v13 已注册 jnpfKey, 实际注册的是 popupSelect/relationForm/autoComplete 等
+ String formDataJson = "{\n" +
+ " \"formItems\": [\n" +
+ " {\"__config__\": {\"jnpfKey\": \"input\"}, \"__vModel__\": \"f_name\"},\n" +
+ " {\"__config__\": {\"jnpfKey\": \"datePicker\"}, \"__vModel__\": \"f_date\"},\n" +
+ " {\"__config__\": {\"jnpfKey\": \"relationForm\"}, \"__vModel__\": \"f_user\"}\n" +
+ " ]\n" +
+ "}";
+
+ ReverseAnalysisReport r = new FormReverseDebugger().analyzeFormData(formDataJson);
+
+ // 1) usedJnpfKeys 包含 3 个控件
+ assertEquals(3, r.usedJnpfKeys.size());
+ assertTrue(r.usedJnpfKeys.contains("input"));
+ assertTrue(r.usedJnpfKeys.contains("datePicker"));
+ assertTrue(r.usedJnpfKeys.contains("relationForm"));
+
+ // 2) jnpfKeyCount 计数 = 1
+ assertEquals(1, r.jnpfKeyCount.get("input").intValue());
+ assertEquals(1, r.jnpfKeyCount.get("datePicker").intValue());
+ assertEquals(1, r.jnpfKeyCount.get("relationForm").intValue());
+
+ // 3) totalFieldCount = 3
+ assertEquals(3, r.totalFieldCount);
+
+ // 4) columnListSize = 0 (无 columnList)
+ assertEquals(0, r.columnListSize);
+
+ // 5) input/datePicker/relationForm 应已被打磨 (33+ builders)
+ // (校验 Factory 实际注册了这些 key, 跟 plan "v13 33 个 builder" 对齐)
+ assertTrue(FieldBuilderFactory.isSupported("input"), "input 必须已注册");
+ assertTrue(FieldBuilderFactory.isSupported("datePicker"), "datePicker 必须已注册");
+ assertTrue(FieldBuilderFactory.isSupported("relationForm"), "relationForm 必须已注册");
+
+ // 6) supported 列表
+ assertTrue(r.supportedJnpfKeys.contains("input"));
+ assertTrue(r.supportedJnpfKeys.contains("datePicker"));
+ assertTrue(r.supportedJnpfKeys.contains("relationForm"));
+
+ // 7) unsupported 空
+ assertTrue(r.unsupportedJnpfKeys.isEmpty(), "本测试 3 个控件都已注册, unsupported 应为空");
+
+ // 8) formSummary 不空
+ assertNotNull(r.formSummary);
+ assertTrue(r.formSummary.contains("fields=3"));
+ }
+
+ @Test
+ public void testUnsupported() throws Exception {
+ // 构造 formData: 含 1 个未注册 jnpfKey "unknownControl"
+ String formDataJson = "{\n" +
+ " \"formItems\": [\n" +
+ " {\"__config__\": {\"jnpfKey\": \"input\"}, \"__vModel__\": \"f_name\"},\n" +
+ " {\"__config__\": {\"jnpfKey\": \"unknownControl\"}, \"__vModel__\": \"f_xxx\"}\n" +
+ " ]\n" +
+ "}";
+
+ ReverseAnalysisReport r = new FormReverseDebugger().analyzeFormData(formDataJson);
+
+ // 1) unsupportedJnpfKeys 含 "unknownControl"
+ assertEquals(1, r.unsupportedJnpfKeys.size());
+ assertTrue(r.unsupportedJnpfKeys.contains("unknownControl"));
+
+ // 2) supported 含 "input"
+ assertTrue(r.supportedJnpfKeys.contains("input"));
+ assertFalse(r.supportedJnpfKeys.contains("unknownControl"));
+
+ // 3) usedJnpfKeys 含两者
+ assertEquals(2, r.usedJnpfKeys.size());
+
+ // 4) formSummary 标识 unsupported=1
+ assertTrue(r.formSummary.contains("unsupported=1"));
+ }
+
+ @Test
+ public void testColumnList() throws Exception {
+ // 构造 formData: columnList 含 input/datePicker 2 列
+ String formDataJson = "{\n" +
+ " \"formItems\": [\n" +
+ " {\"__config__\": {\"jnpfKey\": \"input\"}, \"__vModel__\": \"f_name\"}\n" +
+ " ],\n" +
+ " \"columnList\": [\n" +
+ " {\"__config__\": {\"jnpfKey\": \"input\"}, \"__vModel__\": \"f_name\"},\n" +
+ " {\"__config__\": {\"jnpfKey\": \"datePicker\"}, \"__vModel__\": \"f_date\"}\n" +
+ " ]\n" +
+ "}";
+
+ ReverseAnalysisReport r = new FormReverseDebugger().analyzeFormData(formDataJson);
+
+ // 1) columnListSize = 2
+ assertEquals(2, r.columnListSize);
+
+ // 2) usedJnpfKeys 包含 input + datePicker (columnList 也有)
+ assertTrue(r.usedJnpfKeys.contains("input"));
+ assertTrue(r.usedJnpfKeys.contains("datePicker"));
+
+ // 3) input 计数 = 2 (formItems 1 个 + columnList 1 个)
+ assertEquals(2, r.jnpfKeyCount.get("input").intValue());
+ assertEquals(1, r.jnpfKeyCount.get("datePicker").intValue());
+
+ // 4) totalFieldCount = 1 (只算 formItems)
+ assertEquals(1, r.totalFieldCount);
+
+ // 5) hasFlowTemplate = false
+ assertFalse(r.hasFlowTemplate);
+
+ // 6) formSummary 含 columns=2
+ assertTrue(r.formSummary.contains("columns=2"));
+ }
+
+ @Test
+ public void testDumpToFile() throws Exception {
+ // 写 target/baseline-dump/FormReverseDebugger.json 留作人类可读 baseline 调试样本
+ String formDataJson = "{\n" +
+ " \"formItems\": [\n" +
+ " {\"__config__\": {\"jnpfKey\": \"input\"}, \"__vModel__\": \"f_name\"},\n" +
+ " {\"__config__\": {\"jnpfKey\": \"relationForm\"}, \"__vModel__\": \"f_user\"}\n" +
+ " ],\n" +
+ " \"columnList\": [\n" +
+ " {\"__config__\": {\"jnpfKey\": \"input\"}, \"__vModel__\": \"f_name\"}\n" +
+ " ],\n" +
+ " \"flowTemplateJson\": null\n" +
+ "}";
+
+ ReverseAnalysisReport r = new FormReverseDebugger().analyzeFormData(formDataJson);
+ String reportJson = r.toJson();
+
+ Path out = Paths.get("target/baseline-dump/FormReverseDebugger.json");
+ Files.createDirectories(out.getParent());
+ Files.writeString(out, reportJson);
+
+ // 1) 文件存在
+ assertTrue(Files.exists(out));
+ // 2) 大小 > 100 字节 (JSON 报告不空)
+ assertTrue(Files.size(out) > 100);
+ // 3) 内容含关键字段
+ String content = Files.readString(out);
+ assertTrue(content.contains("usedJnpfKeys"), "报告应含 usedJnpfKeys 字段");
+ assertTrue(content.contains("\"input\""), "报告应含 input 控件");
+ assertTrue(content.contains("\"relationForm\""), "报告应含 relationForm 控件");
+ assertTrue(content.contains("totalFieldCount"), "报告应含 totalFieldCount 字段");
+ assertTrue(content.contains("columnListSize"), "报告应含 columnListSize 字段");
+ assertTrue(content.contains("hasFlowTemplate"), "报告应含 hasFlowTemplate 字段");
+ }
+}