P4-5: 实装改写后脚本挂回 amis onEvent 重放链路
转换器侧(事件段):TemplateToAmisConverter.attachScriptOnEvent 在页面
body 挂 inited+change 两类 onEvent,动作链 ajax 调 /api/script/execute-template
(传 templateId/seq/item:${&})→ replayScriptCommands 重放返回指令。
执行端点:ScriptExecuteController /api/script/execute-template 改接
{templateId,seq,item},RewrittenScriptStore 按 (tid,seq) 从改写产物
output/rewritten 取脚本正文(去头注释)经 facade 执行;原按名端点改
-by-name 保留 P4-2 兼容。
测试:RewrittenScriptStoreTest 4 + ScriptExecuteControllerTest 4 +
TemplateToAmisConverterTest 新增 4 onEvent 例;converter 28 / metadata 77 /
ArchUnit 1 全绿。
出入回写报告第五章 §5.3;新坑入手册 §8.5(组件级动作路由)/§8.6(改写产物取数键)。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
18
docs/迁移手册.md
18
docs/迁移手册.md
@@ -671,6 +671,24 @@ com.dsasp.* com.eip4.*
|
||||
| **对策** | schema 经**独立端点**(`/schema?id=<模板id>` 后端读文件返回)拉取,URL 只传短 id;宿主 `fetch('/schema?id=…')` 后再 `amis.embed`。改后该类模板渲染恢复正常(form 抽样 4/5 → 5/5) |
|
||||
| **影响范围** | P4 闸二冒烟宿主(已修,见 `platform-converter/gate2-smoke/{host.html,smoke.mjs}`);任何用 query 串传 schema 给 headless 宿主的渲染验证脚本 |
|
||||
|
||||
### 8.5 amis show/hidden/setValue/static 不是顶层注册动作,须经组件级路由(脚本挂回重放坑)[NEW 2026-06-11]
|
||||
|
||||
| 栏目 | 内容 |
|
||||
|------|------|
|
||||
| **现象** | P4-5 改写后脚本挂回 onEvent 重放:把 facade 返回的指令(`{actionType:"hidden",componentId:"BEGINDATE"}` 等)当成顶层 amis 动作直接派发时,担心 `registerAction` 列表里查不到 show/hidden/setValue/static/reload 而失效 |
|
||||
| **根因** | amis 6.13 SDK `registerAction(...)` 注册的**顶层动作**仅 `ajax/dialog/toast/copy/broadcast/component/...` 等(实测 30 个,无 show/hidden/setValue/static/reload);显隐/赋值/只读/重载是**组件级动作**——动作对象带 `componentId` 时由 amis 路由到该组件实例的 `doAction`,actionType 名(show/hidden/static/nonstatic/setValue/reload)由组件自身识别。`toast` 是少数顶层动作之一(无 componentId,走 args.msg) |
|
||||
| **对策** | 自定义重放动作 `replayScriptCommands` 里对每条指令调 amis-core `runActions(action, renderer, event)`:带 `componentId` 的自动走组件级路由(show/hidden/setValue/static/reload 生效),`toast` 走顶层。componentId 用改写器输出的大写列名,与 amis 字段 `name` 同源天然对齐,无需映射表。实测 inited 隐藏字段、change 回填字段值均生效(见 `tools/s3_rewriter/P4脚本挂回实测报告.md`) |
|
||||
| **影响范围** | eip4-web `src/amis/{scriptCommands.ts,registerReplayAction.ts}`;任何把后端 UI 动词指令重放到 amis 的胶水层;setOptions/addOption 等「改组件 options」类动词在原生 amis 无对应组件动作,select 选项联动需后端 source 或 amis `setValue` 整体替换 options(非逐条 addOption),落 P4 中段后续 |
|
||||
|
||||
### 8.6 改写后脚本挂回走「改写产物按 templateId+seq 取数」而非「库内 XML 原始脚本」[NEW 2026-06-11]
|
||||
|
||||
| 栏目 | 内容 |
|
||||
|------|------|
|
||||
| **现象** | 报告第五章 §5.2 把衔接接口写成 `/api/script/execute`(带 `{script,item}`,前端直传脚本文本);端到端 §3.2 又用 `/api/script/execute-template?template=<名>`(按模板名从库 XML 取**原始** S3 脚本)。两者都不是「挂回改写后脚本」的正解 |
|
||||
| **根因** | 挂回链路要挂的是**改写后脚本**(`output/rewritten/<tid>/<seq>.FULL_AUTO.groovy` 去头注释正文),不是库内原始 S3 脚本(含未改写的 Vaadin S3 动词);且前端直传脚本文本不安全(任意脚本注入面)。正确取数键是 `(templateId, seq)`——与改写产物落盘命名一致 |
|
||||
| **对策** | P4-5 实装把 `/api/script/execute-template` 改为接受 `{templateId, seq, item}`(RequestBody),后端 `RewrittenScriptStore` 按 `(tid,seq)` 从改写产物取脚本正文执行;原「按模板名取库内 XML 脚本」端点路径区隔为 `/api/script/execute-template-by-name`(保留 P4-2 兼容)。转换器 `attachScriptOnEvent` 生成的 onEvent 即调前者,`item:${&}` 传当前全量表单数据作脚本上下文。出入点已回写报告第五章 |
|
||||
| **影响范围** | `platform-metadata` ScriptExecuteController + RewrittenScriptStore;`platform-converter` TemplateToAmisConverter.attachScriptOnEvent;改写产物落盘根经 `eip4.script.rewritten-root` 配置(默认 `tools/s3_rewriter/output/rewritten`),部署须确保改写产物随应用可达 |
|
||||
|
||||
---
|
||||
|
||||
## 九、待补章节占位
|
||||
|
||||
Reference in New Issue
Block a user