P4-2 脚本迁移线:全量改写产出 + facade 动词表运行时实现
任务1 全量改写执行: - run_rewrite.py 对客户库缓存 1,427 条逐条改写,按 template_id+脚本序号落盘 output/rewritten/(497 FULL_AUTO + 30 PARTIAL + 85 HARD + 815 NO_S3) - 人工作业单 115 份(PARTIAL 30 + HARD 85),每份附原文/已改部分/余留模式/建议改法/工时口径 - 自动化率 81.2% 复现 C4 实测,0 误改 任务2 facade 动词表运行时: - ScriptFacade 把 31 改写目标动词 + bindField 作为 Groovy 闭包注入 Bindings (PoC enableButton 模式扩展);服务端语义动词直接求值,UI 语义动词捕获为 amis 事件动作指令 JSON(actionType/componentId/args) - 保真层纪律:全在 com.eip4 现代层,com.dsasp 源码零改,ArchUnit 复跑通过 - ScriptExecuteController 提供 /api/script/execute 与 /api/script/execute-template 验证: - 单测 17 方法逐动词覆盖,均经真实 Groovy 过保真层引擎,BUILD SUCCESS - 集成 6 条真实 FULL_AUTO 改写脚本经 8086 执行,amis 指令协议合规 - 回归 PoC script-test 通过,ArchUnit 架构纪律通过 报告 tools/s3_rewriter/P4脚本迁移执行报告.md;新坑入 docs/迁移手册.md 5.39/9.3 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,361 @@
|
||||
package com.eip4.platform.metadata.script;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
import javax.script.Bindings;
|
||||
import javax.script.SimpleBindings;
|
||||
|
||||
import groovy.lang.Closure;
|
||||
|
||||
/**
|
||||
* facade 动词表运行时(P4 脚本迁移线 任务2)。
|
||||
*
|
||||
* <p>背景:S3 正则改写器(tools/s3_rewriter)把存量 Vaadin S3 脚本改写成了 31 个目标动词
|
||||
* (setFieldVisible/getFieldValue/showToast/addSubTableButton/setFieldFilter 等,见
|
||||
* tools/s3_rewriter/C4实测报告.md §2.2)。本类在引擎侧落地这些动词:脚本经
|
||||
* {@code ScriptingEnginesManager.evaluateGroovy(key, script, bindings)} 执行时,把每个动词
|
||||
* 作为 Groovy 闭包注入 {@link Bindings},于是脚本文本零修改即可运行(PoC enableButton 模式扩展)。
|
||||
*
|
||||
* <p>架构纪律:本类位于现代层 {@code com.eip4.*},仅向保真层
|
||||
* {@code com.dsasp...ScriptingEnginesManager} 注入闭包,不修改任何 {@code com.dsasp} 源码
|
||||
* (ArchUnit「保真层禁止依赖现代层」恒成立)。
|
||||
*
|
||||
* <p>动词分两类:
|
||||
* <ul>
|
||||
* <li><b>服务端语义动词</b>(getFieldValue/getFieldDataSource/getFieldDisplay):直接在
|
||||
* 服务端对行数据/数据源求值并返回 Java 值,脚本可继续用其结果做分支。</li>
|
||||
* <li><b>UI 语义动词</b>(其余 28 个):捕获为 amis 事件动作指令 JSON(actionType/componentId/args,
|
||||
* amis 事件动作协议口径,见 amis-core/src/actions),收集进 {@link #getCommands()} 返回前端,
|
||||
* 由 amis 在浏览器侧重放——「换 facade 实现、脚本零改」。</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>线程模型:每次脚本执行 new 一份 ScriptFacade,闭包捕获本实例,指令收集非共享,无并发问题。
|
||||
*/
|
||||
public class ScriptFacade {
|
||||
|
||||
/** 行数据上下文(amis 表单当前数据),服务端语义动词从此取值。键为字段名(大写列名)。 */
|
||||
private final Map<String, Object> item;
|
||||
|
||||
/** 捕获的 amis 事件动作指令(UI 语义动词产出,按调用顺序)。 */
|
||||
private final List<Map<String, Object>> commands = new ArrayList<>();
|
||||
|
||||
public ScriptFacade(Map<String, Object> item) {
|
||||
this.item = item != null ? item : new LinkedHashMap<>();
|
||||
}
|
||||
|
||||
/** 已捕获的 amis 事件动作指令数组(脚本执行后取出返回前端)。 */
|
||||
public List<Map<String, Object>> getCommands() {
|
||||
return commands;
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// 指令构造助手:统一 amis 事件动作协议形态 {actionType, componentId, args}
|
||||
// ──────────────────────────────────────────────
|
||||
private Object emit(String actionType, String componentId, Map<String, Object> args) {
|
||||
Map<String, Object> cmd = new LinkedHashMap<>();
|
||||
cmd.put("actionType", actionType);
|
||||
if (componentId != null) {
|
||||
cmd.put("componentId", componentId);
|
||||
}
|
||||
if (args != null && !args.isEmpty()) {
|
||||
cmd.put("args", args);
|
||||
}
|
||||
commands.add(cmd);
|
||||
return null;
|
||||
}
|
||||
|
||||
private static Map<String, Object> args(Object... kv) {
|
||||
Map<String, Object> m = new LinkedHashMap<>();
|
||||
for (int i = 0; i + 1 < kv.length; i += 2) {
|
||||
m.put(String.valueOf(kv[i]), kv[i + 1]);
|
||||
}
|
||||
return m;
|
||||
}
|
||||
|
||||
private static boolean truthy(Object v) {
|
||||
if (v instanceof Boolean b) {
|
||||
return b;
|
||||
}
|
||||
if (v instanceof Number n) {
|
||||
return n.doubleValue() != 0;
|
||||
}
|
||||
return Boolean.parseBoolean(String.valueOf(v));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// 1. 服务端语义动词(求值并返回)
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
/** getFieldValue("X") → 行数据当前字段值(服务端求值)。 */
|
||||
public Object getFieldValue(String field) {
|
||||
return item.get(field);
|
||||
}
|
||||
|
||||
/** getFieldDataSource("X") → 字段数据源句柄占位(服务端不持有 Vaadin 容器,返回轻量句柄)。 */
|
||||
public Object getFieldDataSource(String field) {
|
||||
return new FieldDataSourceHandle(field, this);
|
||||
}
|
||||
|
||||
/** getFieldDisplay("X") → 字段显示值(服务端口径同值;amis 侧由 label/map 渲染)。 */
|
||||
public Object getFieldDisplay(String field) {
|
||||
return item.get(field);
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// 2. UI 语义动词(捕获为 amis 事件动作指令)
|
||||
// actionType 取 amis 标准动作名(show/hidden/enabled/disabled/static/setValue/reload/toast),
|
||||
// 平台扩展语义(filter/option/subTableButton 等)以自定义 actionType + args 表达。
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
public Object setFieldVisible(String field, Object visible) {
|
||||
return emit(truthy(visible) ? "show" : "hidden", field, null);
|
||||
}
|
||||
|
||||
public Object setFieldEnabled(String field, Object enabled) {
|
||||
return emit(truthy(enabled) ? "enabled" : "disabled", field, null);
|
||||
}
|
||||
|
||||
public Object setFieldReadOnly(String field, Object readOnly) {
|
||||
// amis static=只读展示, nonstatic=恢复可编辑
|
||||
return emit(truthy(readOnly) ? "static" : "nonstatic", field, null);
|
||||
}
|
||||
|
||||
public Object setFieldValue(String field, Object value) {
|
||||
return emit("setValue", field, args("value", value));
|
||||
}
|
||||
|
||||
public Object setFieldConvertedValue(String field, Object value) {
|
||||
return emit("setValue", field, args("value", value, "converted", true));
|
||||
}
|
||||
|
||||
public Object setFieldCaption(String field, Object caption) {
|
||||
return emit("setLabel", field, args("label", caption));
|
||||
}
|
||||
|
||||
public Object setFieldRequired(String field, Object required) {
|
||||
return emit("setRequired", field, args("required", truthy(required)));
|
||||
}
|
||||
|
||||
public Object setFieldRequiredError(String field, Object message) {
|
||||
return emit("setRequired", field, args("required", true, "errorMessage", message));
|
||||
}
|
||||
|
||||
public Object setFieldFilter(String field, Object filter) {
|
||||
return emit("setFilter", field, args("filter", filter));
|
||||
}
|
||||
|
||||
public Object setFieldFilterMap(String field, Object filter) {
|
||||
return emit("setFilter", field, args("filter", filter));
|
||||
}
|
||||
|
||||
public Object setFieldDataFilter(String field, Object filter) {
|
||||
return emit("setFilter", field, args("filter", filter));
|
||||
}
|
||||
|
||||
public Object clearFieldData(String field) {
|
||||
return emit("setOptions", field, args("options", new ArrayList<>()));
|
||||
}
|
||||
|
||||
public Object getFieldDataSourceClear(String field) {
|
||||
return clearFieldData(field);
|
||||
}
|
||||
|
||||
public Object addFieldOption(String field, Object value, Object label) {
|
||||
return emit("addOption", field, args("value", value, "label", label));
|
||||
}
|
||||
|
||||
public Object setFieldNullSelection(String field, Object value) {
|
||||
return emit("setNullSelection", field, args("value", value));
|
||||
}
|
||||
|
||||
public Object removeFieldItem(String field, Object value) {
|
||||
return emit("removeOption", field, args("value", value));
|
||||
}
|
||||
|
||||
public Object addFieldButton(String field, Object label, Object handler) {
|
||||
return emit("addButton", field, args("label", label));
|
||||
}
|
||||
|
||||
public Object addSubTableButton(String field, Object targetField, Object index) {
|
||||
return emit("addSubTableButton", field, args("target", targetField, "index", index));
|
||||
}
|
||||
|
||||
public Object setSubTableAddButtonVisible(String field, Object visible) {
|
||||
return emit("setSubTableButtonVisible", field, args("button", "add", "visible", truthy(visible)));
|
||||
}
|
||||
|
||||
public Object setSubTableDeleteButtonVisible(String field, Object visible) {
|
||||
return emit("setSubTableButtonVisible", field, args("button", "delete", "visible", truthy(visible)));
|
||||
}
|
||||
|
||||
public Object setSubTableModifyButtonVisible(String field, Object visible) {
|
||||
return emit("setSubTableButtonVisible", field, args("button", "modify", "visible", truthy(visible)));
|
||||
}
|
||||
|
||||
public Object setSubTableDetailButtonVisible(String field, Object visible) {
|
||||
return emit("setSubTableButtonVisible", field, args("button", "detail", "visible", truthy(visible)));
|
||||
}
|
||||
|
||||
public Object setFieldViewOnly(String field, Object viewOnly) {
|
||||
return emit(truthy(viewOnly) ? "static" : "nonstatic", field, null);
|
||||
}
|
||||
|
||||
public Object focusField(String field) {
|
||||
return emit("focus", field, null);
|
||||
}
|
||||
|
||||
public Object setFieldWidth(String field, Object width) {
|
||||
return emit("setStyle", field, args("width", width));
|
||||
}
|
||||
|
||||
public Object setFieldHeight(String field, Object height) {
|
||||
return emit("setStyle", field, args("height", height));
|
||||
}
|
||||
|
||||
public Object reloadField(String field) {
|
||||
return emit("reload", field, null);
|
||||
}
|
||||
|
||||
public Object setGroupReadOnly(Object readOnly) {
|
||||
return emit(truthy(readOnly) ? "static" : "nonstatic", null, args("scope", "group"));
|
||||
}
|
||||
|
||||
public Object setGroupEnabled(Object enabled) {
|
||||
return emit(truthy(enabled) ? "enabled" : "disabled", null, args("scope", "group"));
|
||||
}
|
||||
|
||||
public Object showToast(Object message) {
|
||||
return emit("toast", null, args("msg", message));
|
||||
}
|
||||
|
||||
/**
|
||||
* bindField(field, value) — 平台基础 S2 辅助函数(迁移手册 §161 四个基础 facade 之一)。
|
||||
* 把目标字段绑定/赋为给定值,amis 侧等价于对该字段 setValue。
|
||||
*/
|
||||
public Object bindField(String field, Object value) {
|
||||
return emit("setValue", field, args("value", value, "bind", true));
|
||||
}
|
||||
|
||||
/** enableButton(name, enabled) — PoC 既有动词,按钮启停(保持兼容)。 */
|
||||
public Object enableButton(String name, Object enabled) {
|
||||
return emit(truthy(enabled) ? "enabled" : "disabled", name, args("kind", "button"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// 3. 绑定装配:把 31 个动词作为 Groovy 闭包注入 Bindings
|
||||
// 复用 PoC 的 facade 闭包注入机制;每个闭包薄封装委托到本实例方法。
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* 构造注入了 facade 动词表的 {@link Bindings}。
|
||||
*
|
||||
* @param item 行数据上下文(脚本里的 {@code item})
|
||||
* @return 含 item + 31 动词闭包的 SimpleBindings
|
||||
*/
|
||||
public Bindings buildBindings(Map<String, Object> item) {
|
||||
SimpleBindings b = new SimpleBindings();
|
||||
b.put("item", this.item);
|
||||
|
||||
// 服务端语义动词
|
||||
bind(b, "getFieldValue", a -> getFieldValue(str(a, 0)));
|
||||
bind(b, "getFieldDataSource", a -> getFieldDataSource(str(a, 0)));
|
||||
bind(b, "getFieldDisplay", a -> getFieldDisplay(str(a, 0)));
|
||||
|
||||
// UI 语义动词(单参字段)
|
||||
bind(b, "clearFieldData", a -> clearFieldData(str(a, 0)));
|
||||
bind(b, "focusField", a -> focusField(str(a, 0)));
|
||||
bind(b, "reloadField", a -> reloadField(str(a, 0)));
|
||||
|
||||
// UI 语义动词(字段 + 1 参)
|
||||
bind(b, "setFieldVisible", a -> setFieldVisible(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldEnabled", a -> setFieldEnabled(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldReadOnly", a -> setFieldReadOnly(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldValue", a -> setFieldValue(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldConvertedValue", a -> setFieldConvertedValue(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldCaption", a -> setFieldCaption(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldRequired", a -> setFieldRequired(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldRequiredError", a -> setFieldRequiredError(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldFilter", a -> setFieldFilter(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldFilterMap", a -> setFieldFilterMap(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldDataFilter", a -> setFieldDataFilter(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldNullSelection", a -> setFieldNullSelection(str(a, 0), arg(a, 1)));
|
||||
bind(b, "removeFieldItem", a -> removeFieldItem(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setSubTableAddButtonVisible", a -> setSubTableAddButtonVisible(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setSubTableDeleteButtonVisible", a -> setSubTableDeleteButtonVisible(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setSubTableModifyButtonVisible", a -> setSubTableModifyButtonVisible(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setSubTableDetailButtonVisible", a -> setSubTableDetailButtonVisible(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldViewOnly", a -> setFieldViewOnly(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldWidth", a -> setFieldWidth(str(a, 0), arg(a, 1)));
|
||||
bind(b, "setFieldHeight", a -> setFieldHeight(str(a, 0), arg(a, 1)));
|
||||
|
||||
// UI 语义动词(字段 + 2 参)
|
||||
bind(b, "addFieldOption", a -> addFieldOption(str(a, 0), arg(a, 1), arg(a, 2)));
|
||||
bind(b, "addFieldButton", a -> addFieldButton(str(a, 0), arg(a, 1), arg(a, 2)));
|
||||
bind(b, "addSubTableButton", a -> addSubTableButton(str(a, 0), arg(a, 1), arg(a, 2)));
|
||||
|
||||
// 组级动词(无字段参)
|
||||
bind(b, "setGroupReadOnly", a -> setGroupReadOnly(arg(a, 0)));
|
||||
bind(b, "setGroupEnabled", a -> setGroupEnabled(arg(a, 0)));
|
||||
|
||||
// 通知/按钮/基础绑定
|
||||
bind(b, "showToast", a -> showToast(arg(a, 0)));
|
||||
bind(b, "enableButton", a -> enableButton(str(a, 0), arg(a, 1)));
|
||||
bind(b, "bindField", a -> bindField(str(a, 0), arg(a, 1)));
|
||||
|
||||
return b;
|
||||
}
|
||||
|
||||
// 简化闭包注入:把 VerbFn 包成可变参 Groovy Closure
|
||||
@FunctionalInterface
|
||||
private interface VerbFn {
|
||||
Object call(Object[] args);
|
||||
}
|
||||
|
||||
private void bind(Bindings b, String name, VerbFn fn) {
|
||||
b.put(name, new Closure<Object>(this) {
|
||||
@SuppressWarnings("unused")
|
||||
public Object doCall(Object... args) {
|
||||
return fn.call(args);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
private static Object arg(Object[] a, int i) {
|
||||
return a != null && i < a.length ? a[i] : null;
|
||||
}
|
||||
|
||||
private static String str(Object[] a, int i) {
|
||||
Object v = arg(a, i);
|
||||
return v == null ? null : String.valueOf(v);
|
||||
}
|
||||
|
||||
/**
|
||||
* 字段数据源句柄占位:服务端不持有 Vaadin 容器,仅在脚本以
|
||||
* {@code getFieldDataSource("X").removeAllItems()} 等链式调用时把动作折叠回 facade。
|
||||
* 改写器多数已在静态期把数据源链折叠为 addFieldOption/clearFieldData,本句柄兜底动态链。
|
||||
*/
|
||||
public static class FieldDataSourceHandle {
|
||||
private final String field;
|
||||
private final ScriptFacade facade;
|
||||
|
||||
FieldDataSourceHandle(String field, ScriptFacade facade) {
|
||||
this.field = field;
|
||||
this.facade = facade;
|
||||
}
|
||||
|
||||
public Object removeAllItems() {
|
||||
return facade.clearFieldData(field);
|
||||
}
|
||||
|
||||
public Object addItem(Object value) {
|
||||
return facade.addFieldOption(field, value, value);
|
||||
}
|
||||
|
||||
public Object setFilter(Object filter) {
|
||||
return facade.setFieldFilter(field, filter);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,134 @@
|
||||
package com.eip4.platform.metadata.web;
|
||||
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
import javax.script.Bindings;
|
||||
|
||||
import org.dom4j.Document;
|
||||
import org.dom4j.DocumentHelper;
|
||||
import org.dom4j.Element;
|
||||
import org.springframework.jdbc.core.JdbcTemplate;
|
||||
import org.springframework.web.bind.annotation.PostMapping;
|
||||
import org.springframework.web.bind.annotation.RequestBody;
|
||||
import org.springframework.web.bind.annotation.RequestParam;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
|
||||
import com.dsasp.server.dataDic.binding.ScriptingEnginesManager;
|
||||
import com.eip4.platform.metadata.script.ScriptFacade;
|
||||
|
||||
/**
|
||||
* 脚本执行端点(P4 脚本迁移线 任务2 集成)。
|
||||
*
|
||||
* <p>把(改写后的)Groovy 脚本经保真层 {@link ScriptingEnginesManager} 执行,行数据上下文 +
|
||||
* 31 个 facade 动词由 {@link ScriptFacade} 注入 {@link Bindings}:
|
||||
* <ul>
|
||||
* <li>服务端语义动词(getFieldValue 等)在服务端求值;</li>
|
||||
* <li>UI 语义动词(setFieldVisible/showToast/addSubTableButton…)捕获为 amis 事件动作
|
||||
* 指令 JSON 数组(actionType/componentId/args)返回前端。</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>架构:本控制器与 {@link ScriptFacade} 均在现代层 {@code com.eip4.*},仅向保真层注入闭包,
|
||||
* 不改 {@code com.dsasp} 源码。
|
||||
*/
|
||||
@RestController
|
||||
public class ScriptExecuteController {
|
||||
|
||||
private final JdbcTemplate jdbcTemplate;
|
||||
|
||||
public ScriptExecuteController(JdbcTemplate jdbcTemplate) {
|
||||
this.jdbcTemplate = jdbcTemplate;
|
||||
}
|
||||
|
||||
/**
|
||||
* 直接执行一段脚本(改写后的 FULL_AUTO 脚本验证用),行数据走请求体。
|
||||
*
|
||||
* 请求体:{"script":"...", "item":{"ISPLACE":"待归档", ...}}
|
||||
* 返回 :{"commands":[{actionType,componentId,args}, ...], "passed":true}
|
||||
*/
|
||||
@PostMapping("/api/script/execute")
|
||||
public Map<String, Object> execute(@RequestBody Map<String, Object> body) {
|
||||
Map<String, Object> resp = new LinkedHashMap<>();
|
||||
String script = body.get("script") == null ? null : String.valueOf(body.get("script"));
|
||||
if (script == null || script.isBlank()) {
|
||||
resp.put("passed", false);
|
||||
resp.put("error", "缺少 script");
|
||||
return resp;
|
||||
}
|
||||
@SuppressWarnings("unchecked")
|
||||
Map<String, Object> item = body.get("item") instanceof Map
|
||||
? (Map<String, Object>) body.get("item") : new LinkedHashMap<>();
|
||||
|
||||
try {
|
||||
List<Map<String, Object>> commands = runWithFacade(null, script, item);
|
||||
resp.put("passed", true);
|
||||
resp.put("item", item);
|
||||
resp.put("commands", commands);
|
||||
resp.put("commandCount", commands.size());
|
||||
resp.put("note", "脚本经 facade 动词表执行;UI 动作捕获为 amis 事件指令 JSON");
|
||||
} catch (Exception e) {
|
||||
resp.put("passed", false);
|
||||
resp.put("error", e.getMessage());
|
||||
}
|
||||
return resp;
|
||||
}
|
||||
|
||||
/**
|
||||
* 按模板名从客户库取真实脚本执行(改写后脚本挂回页面 schema 的端到端验证)。
|
||||
*
|
||||
* @param template 模板名(VIEW_TEMPLATE.NAME)
|
||||
* @param state 注入 item.ISPLACE 的取值,便于驱动分支
|
||||
*/
|
||||
@PostMapping("/api/script/execute-template")
|
||||
public Map<String, Object> executeTemplate(
|
||||
@RequestParam String template,
|
||||
@RequestParam(required = false) String state) throws Exception {
|
||||
Map<String, Object> resp = new LinkedHashMap<>();
|
||||
String script = extractScript(template);
|
||||
if (script == null) {
|
||||
resp.put("passed", false);
|
||||
resp.put("error", "模板无脚本: " + template);
|
||||
return resp;
|
||||
}
|
||||
Map<String, Object> item = new LinkedHashMap<>();
|
||||
if (state != null) {
|
||||
item.put("ISPLACE", state);
|
||||
}
|
||||
resp.put("template", template);
|
||||
resp.put("scriptSource", script);
|
||||
List<Map<String, Object>> commands = runWithFacade("tpl:" + template, script, item);
|
||||
resp.put("commands", commands);
|
||||
resp.put("commandCount", commands.size());
|
||||
resp.put("passed", true);
|
||||
return resp;
|
||||
}
|
||||
|
||||
/** 用 facade 动词表执行脚本,返回捕获的 amis 指令。 */
|
||||
private List<Map<String, Object>> runWithFacade(String key, String script, Map<String, Object> item) {
|
||||
ScriptFacade facade = new ScriptFacade(item);
|
||||
Bindings bindings = facade.buildBindings(item);
|
||||
ScriptingEnginesManager.getScriptingEnginesManager()
|
||||
.evaluateGroovy(key, script, bindings);
|
||||
return facade.getCommands();
|
||||
}
|
||||
|
||||
/** 从 VIEW_TEMPLATE 取模板第一段实质脚本(getText 保留换行,见迁移手册 5.3)。 */
|
||||
private String extractScript(String template) throws Exception {
|
||||
List<String> xmls = jdbcTemplate.queryForList(
|
||||
"SELECT xml::text FROM VIEW_TEMPLATE WHERE NAME=? AND xml IS NOT NULL",
|
||||
String.class, template);
|
||||
for (String xml : xmls) {
|
||||
Document doc = DocumentHelper.parseText(xml);
|
||||
for (org.dom4j.Node n : doc.selectNodes("//script")) {
|
||||
if (n instanceof Element e) {
|
||||
String t = e.getText().strip();
|
||||
if (t.length() > 10) {
|
||||
return t;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,253 @@
|
||||
package com.eip4.platform.metadata.script;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
import javax.script.Bindings;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import com.dsasp.server.dataDic.binding.ScriptingEnginesManager;
|
||||
|
||||
/**
|
||||
* P4 任务2 单测:31 个 facade 动词逐个验证。
|
||||
*
|
||||
* <p>验证口径分两类:
|
||||
* <ul>
|
||||
* <li>服务端语义动词(getFieldValue/getFieldDataSource/getFieldDisplay):直接返回行数据值,
|
||||
* 脚本可继续用其结果做分支,不产生 amis 指令。</li>
|
||||
* <li>UI 语义动词(其余 28 个):捕获为 amis 事件动作指令,断言 actionType/componentId/args
|
||||
* 符合 amis 事件动作协议口径。</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>每条测试都把真实的(改写后)Groovy 片段经保真层 {@link ScriptingEnginesManager} 跑通,
|
||||
* 是「换 facade 实现、脚本零改」的端到端验证(非纯 Java 直调)。
|
||||
*/
|
||||
class ScriptFacadeTest {
|
||||
|
||||
/** 跑一段 Groovy,注入 item + facade 动词,返回捕获的 amis 指令。 */
|
||||
private List<Map<String, Object>> run(String groovy, Map<String, Object> item) {
|
||||
ScriptFacade facade = new ScriptFacade(item);
|
||||
Bindings bindings = facade.buildBindings(item);
|
||||
ScriptingEnginesManager.getScriptingEnginesManager()
|
||||
.evaluateGroovy(null, groovy, bindings);
|
||||
return facade.getCommands();
|
||||
}
|
||||
|
||||
private Map<String, Object> item(Object... kv) {
|
||||
Map<String, Object> m = new LinkedHashMap<>();
|
||||
for (int i = 0; i + 1 < kv.length; i += 2) {
|
||||
m.put(String.valueOf(kv[i]), kv[i + 1]);
|
||||
}
|
||||
return m;
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// A. 服务端语义动词(3)
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void getFieldValue_returnsRowValueServerSide_noCommand() {
|
||||
// 脚本服务端读字段值并据此分支,不应产生 UI 指令
|
||||
List<Map<String, Object>> cmds = run(
|
||||
"def v = getFieldValue(\"STATUS\"); if (v == \"OPEN\") { setFieldVisible(\"BTN\", true) }",
|
||||
item("STATUS", "OPEN"));
|
||||
assertEquals(1, cmds.size(), "仅分支命中的 setFieldVisible 一条 UI 指令");
|
||||
assertEquals("show", cmds.get(0).get("actionType"));
|
||||
assertEquals("BTN", cmds.get(0).get("componentId"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void getFieldDisplay_returnsServerSide() {
|
||||
List<Map<String, Object>> cmds = run(
|
||||
"def d = getFieldDisplay(\"NAME\"); setFieldValue(\"COPY\", d)",
|
||||
item("NAME", "张三"));
|
||||
assertEquals(1, cmds.size());
|
||||
assertEquals("setValue", cmds.get(0).get("actionType"));
|
||||
assertEquals("COPY", cmds.get(0).get("componentId"));
|
||||
assertEquals("张三", ((Map<?, ?>) cmds.get(0).get("args")).get("value"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void getFieldDataSource_handleClearAndAddItem() {
|
||||
// 动态数据源链兜底:getFieldDataSource(...).removeAllItems()/addItem()
|
||||
List<Map<String, Object>> cmds = run(
|
||||
"def ds = getFieldDataSource(\"CITY\"); ds.removeAllItems(); ds.addItem(\"BJ\")",
|
||||
item());
|
||||
assertEquals(2, cmds.size());
|
||||
assertEquals("setOptions", cmds.get(0).get("actionType"));
|
||||
assertEquals("CITY", cmds.get(0).get("componentId"));
|
||||
assertEquals("addOption", cmds.get(1).get("actionType"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// B. UI 语义动词 — 显隐/启停/只读(状态类)
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void setFieldVisible_emitsShowOrHidden() {
|
||||
List<Map<String, Object>> on = run("setFieldVisible(\"A\", true)", item());
|
||||
assertEquals("show", on.get(0).get("actionType"));
|
||||
assertEquals("A", on.get(0).get("componentId"));
|
||||
List<Map<String, Object>> off = run("setFieldVisible(\"A\", false)", item());
|
||||
assertEquals("hidden", off.get(0).get("actionType"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void setFieldEnabled_emitsEnabledDisabled() {
|
||||
assertEquals("enabled", run("setFieldEnabled(\"A\", true)", item()).get(0).get("actionType"));
|
||||
assertEquals("disabled", run("setFieldEnabled(\"A\", false)", item()).get(0).get("actionType"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void setFieldReadOnly_and_viewOnly_emitStaticNonstatic() {
|
||||
assertEquals("static", run("setFieldReadOnly(\"A\", true)", item()).get(0).get("actionType"));
|
||||
assertEquals("nonstatic", run("setFieldReadOnly(\"A\", false)", item()).get(0).get("actionType"));
|
||||
assertEquals("static", run("setFieldViewOnly(\"A\", true)", item()).get(0).get("actionType"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// C. UI 语义动词 — 赋值/标题/必填类
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void setFieldValue_and_convertedValue_emitSetValue() {
|
||||
Map<String, Object> a = run("setFieldValue(\"A\", 42)", item()).get(0);
|
||||
assertEquals("setValue", a.get("actionType"));
|
||||
assertEquals(42, ((Map<?, ?>) a.get("args")).get("value"));
|
||||
Map<String, Object> c = run("setFieldConvertedValue(\"A\", 7)", item()).get(0);
|
||||
assertEquals("setValue", c.get("actionType"));
|
||||
assertEquals(Boolean.TRUE, ((Map<?, ?>) c.get("args")).get("converted"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void setFieldCaption_required_requiredError() {
|
||||
assertEquals("setLabel", run("setFieldCaption(\"A\", \"标题\")", item()).get(0).get("actionType"));
|
||||
Map<String, Object> r = run("setFieldRequired(\"A\", true)", item()).get(0);
|
||||
assertEquals("setRequired", r.get("actionType"));
|
||||
assertEquals(true, ((Map<?, ?>) r.get("args")).get("required"));
|
||||
Map<String, Object> re = run("setFieldRequiredError(\"A\", \"必填\")", item()).get(0);
|
||||
assertEquals("必填", ((Map<?, ?>) re.get("args")).get("errorMessage"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// D. UI 语义动词 — 数据源/选项/过滤类
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void setFieldFilter_filterMap_dataFilter_emitSetFilter() {
|
||||
assertEquals("setFilter", run("setFieldFilter(\"A\", [k:1])", item()).get(0).get("actionType"));
|
||||
assertEquals("setFilter", run("setFieldFilterMap(\"A\", [k:1])", item()).get(0).get("actionType"));
|
||||
Map<String, Object> df = run("setFieldDataFilter(\"A\", [k:1])", item()).get(0);
|
||||
assertEquals("setFilter", df.get("actionType"));
|
||||
assertEquals("A", df.get("componentId"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void clearFieldData_addFieldOption_removeFieldItem_nullSelection() {
|
||||
assertEquals("setOptions", run("clearFieldData(\"A\")", item()).get(0).get("actionType"));
|
||||
Map<String, Object> opt = run("addFieldOption(\"A\", \"v1\", \"显示1\")", item()).get(0);
|
||||
assertEquals("addOption", opt.get("actionType"));
|
||||
assertEquals("v1", ((Map<?, ?>) opt.get("args")).get("value"));
|
||||
assertEquals("显示1", ((Map<?, ?>) opt.get("args")).get("label"));
|
||||
assertEquals("removeOption", run("removeFieldItem(\"A\", \"v1\")", item()).get(0).get("actionType"));
|
||||
assertEquals("setNullSelection", run("setFieldNullSelection(\"A\", \"\")", item()).get(0).get("actionType"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// E. UI 语义动词 — 子表/按钮类
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void addSubTableButton_emitsTargetAndIndex() {
|
||||
Map<String, Object> c = run("addSubTableButton(\"LIST\", \"SEL\", 0)", item()).get(0);
|
||||
assertEquals("addSubTableButton", c.get("actionType"));
|
||||
assertEquals("LIST", c.get("componentId"));
|
||||
assertEquals("SEL", ((Map<?, ?>) c.get("args")).get("target"));
|
||||
assertEquals(0, ((Map<?, ?>) c.get("args")).get("index"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void subTableButtonVisibility_add_delete_modify_detail() {
|
||||
assertEquals("add", visBtn("setSubTableAddButtonVisible(\"L\", true)"));
|
||||
assertEquals("delete", visBtn("setSubTableDeleteButtonVisible(\"L\", false)"));
|
||||
assertEquals("modify", visBtn("setSubTableModifyButtonVisible(\"L\", true)"));
|
||||
assertEquals("detail", visBtn("setSubTableDetailButtonVisible(\"L\", false)"));
|
||||
}
|
||||
|
||||
private String visBtn(String groovy) {
|
||||
Map<String, Object> c = run(groovy, item()).get(0);
|
||||
assertEquals("setSubTableButtonVisible", c.get("actionType"));
|
||||
return (String) ((Map<?, ?>) c.get("args")).get("button");
|
||||
}
|
||||
|
||||
@Test
|
||||
void addFieldButton_focus_width_height_reload() {
|
||||
assertEquals("addButton", run("addFieldButton(\"A\", \"文案\", null)", item()).get(0).get("actionType"));
|
||||
assertEquals("focus", run("focusField(\"A\")", item()).get(0).get("actionType"));
|
||||
assertEquals("setStyle", run("setFieldWidth(\"A\", \"100px\")", item()).get(0).get("actionType"));
|
||||
assertEquals("100px", ((Map<?, ?>) run("setFieldWidth(\"A\", \"100px\")", item()).get(0).get("args")).get("width"));
|
||||
assertEquals("setStyle", run("setFieldHeight(\"A\", \"50px\")", item()).get(0).get("actionType"));
|
||||
assertEquals("reload", run("reloadField(\"A\")", item()).get(0).get("actionType"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// F. UI 语义动词 — 组级/通知/按钮
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void groupReadOnly_groupEnabled_scopeGroup() {
|
||||
Map<String, Object> ro = run("setGroupReadOnly(true)", item()).get(0);
|
||||
assertEquals("static", ro.get("actionType"));
|
||||
assertEquals("group", ((Map<?, ?>) ro.get("args")).get("scope"));
|
||||
Map<String, Object> en = run("setGroupEnabled(false)", item()).get(0);
|
||||
assertEquals("disabled", en.get("actionType"));
|
||||
assertEquals("group", ((Map<?, ?>) en.get("args")).get("scope"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void showToast_emitsToast() {
|
||||
Map<String, Object> c = run("showToast(\"已保存\")", item()).get(0);
|
||||
assertEquals("toast", c.get("actionType"));
|
||||
assertEquals("已保存", ((Map<?, ?>) c.get("args")).get("msg"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void enableButton_pocCompatibility() {
|
||||
// PoC 既有动词,保持兼容
|
||||
Map<String, Object> on = run("enableButton(\"SAVE\", true)", item()).get(0);
|
||||
assertEquals("enabled", on.get("actionType"));
|
||||
assertEquals("SAVE", on.get("componentId"));
|
||||
assertEquals("button", ((Map<?, ?>) on.get("args")).get("kind"));
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────
|
||||
// G. 端到端:真实改写后脚本组合多动词
|
||||
// ──────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void realRewrittenScript_multiVerbCombo_capturedAsAmisCommandArray() {
|
||||
// 形态取自真实 FULL_AUTO 改写产出(addSubTableButton + setFieldReadOnly + getFieldValue 分支)
|
||||
String groovy =
|
||||
"addSubTableButton(\"GOODSDETAIL\", \"SELECT\", 0);\n" +
|
||||
"def store = getFieldValue(\"STORE_ID\");\n" +
|
||||
"if (store != null) { setFieldReadOnly(\"OLD_STORE_ID\", true); }\n" +
|
||||
"setFieldVisible(\"NEXTDATE\", false);";
|
||||
List<Map<String, Object>> cmds = run(groovy, item("STORE_ID", "S001"));
|
||||
assertEquals(3, cmds.size(), "三条 UI 指令(子表按钮+只读+隐藏),getFieldValue 服务端求值不计指令");
|
||||
assertEquals("addSubTableButton", cmds.get(0).get("actionType"));
|
||||
assertEquals("static", cmds.get(1).get("actionType"));
|
||||
assertEquals("OLD_STORE_ID", cmds.get(1).get("componentId"));
|
||||
assertEquals("hidden", cmds.get(2).get("actionType"));
|
||||
// 每条都是 amis 事件动作协议形态:actionType 必填,componentId 存在
|
||||
for (Map<String, Object> c : cmds) {
|
||||
assertTrue(c.containsKey("actionType"));
|
||||
assertFalse(((String) c.get("actionType")).isBlank());
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user