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:
2026-06-11 16:10:22 +08:00
parent 3a13c50a01
commit aefb0e2eb9
1552 changed files with 41290 additions and 2 deletions

View File

@@ -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);
}
}
}

View File

@@ -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;
}
}

View File

@@ -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());
}
}
}