feat(converter): 机制①整页改写器 + 功能模板下载门控(去添加按钮/改标题)

EngineclassDelta 原仅支持「crud 工具栏追加按钮」。新增 MUTATORS 注册表
(engineclass FQN → 整页 schema 改写器),apply 拆为 applyToolbarButtons
(crud 加按钮,行为不变)+ applyMutators(任意 body 整页改写),覆盖非
crud 加按钮类 delta。

注册 FuncDownloadComponent(功能模板下载模板管理 0246d4bd / 设置 13accf09,
type=3 树页 grid → 左 input-tree + 右 button-toolbar[添加] + form):复刻
refreshRightLayout —— ① 移除右表单「添加/删除」按钮(附件随菜单/实体生成
不应手工增删,老 cl.removeComponent(insert)/(del)),空 toolbar 整条移除;
② 右表单标题改「编辑模板附件」(老 panel.setCaption)。改写器重建列表回填,
兼容转换器的不可变 List.of 列 body(原地 removeIf 会 UOE)。

未做:老「仅 VIEW_TEMPLATEID 非空才显示右表单」门控——amis form visibleOn
依赖自身 initApi 数据成循环,正解需树节点携带该列(改 TemplateTreeController),
价值低暂延后。

另核对:实体分类-枚举组(b114351f) 老 EntityEnumerateType 用 UUID 当树节点 id
(Vaadin 懒加载防重复 addItem),EIP4 树端点用 PK 唯一 + 跨级去重 + 一次性全量
建树,结构上天然规避,实测 598 节点零重复 → 已覆盖,无需移植。

全量重转 dry-run 深度 diff 确认语义仅 2 页变(余 2725 页保真),已重导上线
(live 实证 13accf09 无「添加」按钮 + 标题「编辑模板附件」)。converter 156 测试绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-17 16:57:44 +08:00
parent 17c449cbf5
commit b5fe995344
2 changed files with 176 additions and 4 deletions

View File

@@ -1,9 +1,11 @@
package com.eip4.platform.converter;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.function.BiConsumer;
import java.util.function.Function;
/**
@@ -26,6 +28,12 @@ public final class EngineclassDelta {
/** engineclass FQN → 该视图要在默认工具栏之上追加的定制按钮 builder 列表(入参=primaryField)。 */
private static final Map<String, List<Function<String, Map<String, Object>>>> REGISTRY = new HashMap<>();
/**
* engineclass FQN → 整页 schema 改写器列表。用于「非 crud 加按钮」类 delta:移除/改写默认引擎页已生成的
* 元素(如 type=3 树页移除右表单增删按钮、改标题)。入参=(整页 schema, ConversionResult 供记 note)。
*/
private static final Map<String, List<BiConsumer<Map<String, Object>, ConversionResult>>> MUTATORS = new HashMap<>();
static {
// 用户管理:Java engineclass(UserManageView.bindingToolbar)在默认页之上加 2 个按钮。
// ①设置主岗位(SYS_POSITIONUSER_SEARCH/UPDATEMASTER 保真层已就绪);
@@ -50,6 +58,12 @@ public final class EngineclassDelta {
// 登录历史(edc05980),带选中行用户 id(USERID)+本页 OPTIMES 时间区间(LOGINTIME)作默认查询。
register("com.dsasp.client.datadic.view.SysUserLoginInfoMainView",
EngineclassDelta::loginInfoViewHistoryButton);
// 功能模板下载模板管理(0246d4bd)/设置(13accf09):同 engineclass。FuncDownloadComponent.refreshRightLayout
// 在默认树页之上——移除右表单「添加/删除」按钮(附件随菜单/实体生成不应手工增删)+ 右表单标题改「编辑模板附件」。
// 非 crud 加按钮,走整页改写器(MUTATORS)。
registerMutator("com.dsasp.client.viewframework.component.FuncDownloadComponent",
EngineclassDelta::funcDownloadDelta);
}
private EngineclassDelta() {
@@ -60,14 +74,29 @@ public final class EngineclassDelta {
REGISTRY.put(fqn, List.of(builders));
}
@SafeVarargs
private static void registerMutator(String fqn, BiConsumer<Map<String, Object>, ConversionResult>... mutators) {
MUTATORS.put(fqn, List.of(mutators));
}
/**
* 把 {@code engineclass} 注册的定制按钮注入 {@code schema}(默认引擎已转好的页)的 crud 工具栏。
* 仅对 {@code body.type=crud} 列表页生效;插在 {@code pagination} 之前;未注册/非 crud → no-op。
* 把 {@code engineclass} 的定制 delta 注入 {@code schema}(默认引擎已转好的页):
* ① crud 列表页 → 工具栏追加按钮({@link #REGISTRY});② 任意页 → 整页改写({@link #MUTATORS},
* 如 type=3 树页移除增删按钮/改标题)。未注册 → no-op。
*/
@SuppressWarnings("unchecked")
public static void apply(Map<String, Object> schema, String engineclass, ConversionResult result) {
if (schema == null || engineclass == null) {
return;
}
applyToolbarButtons(schema, engineclass, result);
applyMutators(schema, engineclass, result);
}
/** ① crud 工具栏追加按钮:仅 {@code body.type=crud},插在 {@code pagination} 之前;未注册/非 crud → no-op。 */
@SuppressWarnings("unchecked")
private static void applyToolbarButtons(Map<String, Object> schema, String engineclass, ConversionResult result) {
List<Function<String, Map<String, Object>>> builders = REGISTRY.get(engineclass);
if (builders == null || builders.isEmpty() || schema == null) {
if (builders == null || builders.isEmpty()) {
return;
}
Object bodyObj = schema.get("body");
@@ -97,6 +126,103 @@ public final class EngineclassDelta {
}
}
/** ② 整页改写器:对注册的 mutator 逐个施加到整页 schema(任意 body 类型);未注册 → no-op。 */
private static void applyMutators(Map<String, Object> schema, String engineclass, ConversionResult result) {
List<BiConsumer<Map<String, Object>, ConversionResult>> mutators = MUTATORS.get(engineclass);
if (mutators == null || mutators.isEmpty()) {
return;
}
for (BiConsumer<Map<String, Object>, ConversionResult> m : mutators) {
m.accept(schema, result);
}
}
// ── 功能模板下载模板管理/设置 · 去增删按钮 + 改标题 ─────────────────────────
/**
* FuncDownloadComponent.refreshRightLayout 的 EIP4 等价改写。转换后 type=3 树页结构=
* {@code grid → 列[左 input-tree][右 button-toolbar[添加] + form]}。改写:
* <ul>
* <li>① 移除右侧 button-toolbar 内「添加/删除」按钮(老 cl.removeComponent(insert)/(del)——附件记录随
* 菜单/实体生成不应手工增删);toolbar 因此变空则整条移除。</li>
* <li>② 右表单标题改「编辑模板附件」(老 panel.setCaption("编辑模板附件"))。</li>
* </ul>
* <b>未做</b>:老「仅 pojo.VIEW_TEMPLATEID 非空才显示右表单」的门控——amis 表单 {@code visibleOn} 依赖
* 自身 initApi 数据成循环(隐藏则不 fetch),正解需树节点携带 VIEW_TEMPLATEID(改 TemplateTreeController),
* 价值低,暂延后。
*/
@SuppressWarnings("unchecked")
private static void funcDownloadDelta(Map<String, Object> schema, ConversionResult result) {
Object bodyObj = schema.get("body");
if (!(bodyObj instanceof Map)) {
return;
}
Object colsObj = ((Map<String, Object>) bodyObj).get("columns");
if (!(colsObj instanceof List)) {
return;
}
// 注:转换器的列 body 是不可变 List.of(...)(buildEditableTreeMasterDetail),不能原地 removeIf;
// 列 map 本身是可变 LinkedHashMap → 重建 body 列表回填。
for (Object colObj : (List<Object>) colsObj) {
if (!(colObj instanceof Map)) {
continue;
}
Map<String, Object> col = (Map<String, Object>) colObj;
Object colBodyObj = col.get("body");
if (!(colBodyObj instanceof List)) {
continue;
}
List<Object> rebuilt = new ArrayList<>();
for (Object n : (List<Object>) colBodyObj) {
if (n instanceof Map) {
Map<String, Object> m = (Map<String, Object>) n;
if ("button-toolbar".equals(m.get("type"))) {
if (stripToolbarAddDel(m, result)) {
continue; // ① 剥「添加/删除」后空 toolbar → 丢弃整条
}
} else if ("form".equals(m.get("type"))) {
// ② 右表单标题改「编辑模板附件」
Object old = m.put("title", "编辑模板附件");
if (result != null) {
result.note("engineclass[FuncDownloadComponent] 右表单标题改写: "
+ old + " → 编辑模板附件");
}
}
}
rebuilt.add(n);
}
col.put("body", rebuilt);
}
}
/**
* 剥除 button-toolbar 内「添加/删除」按钮(重建 buttons 列表回填,兼容不可变源);剥后为空返回 true(供丢弃整条)。
*/
@SuppressWarnings("unchecked")
private static boolean stripToolbarAddDel(Map<String, Object> toolbar, ConversionResult result) {
Object btnsObj = toolbar.get("buttons");
if (!(btnsObj instanceof List)) {
return false;
}
List<Object> kept = new ArrayList<>();
boolean removed = false;
for (Object b : (List<Object>) btnsObj) {
if (b instanceof Map
&& ("添加".equals(((Map<String, Object>) b).get("label"))
|| "删除".equals(((Map<String, Object>) b).get("label")))) {
removed = true;
continue;
}
kept.add(b);
}
if (removed) {
toolbar.put("buttons", kept);
if (result != null) {
result.note("engineclass[FuncDownloadComponent] 移除右表单「添加/删除」按钮");
}
}
return kept.isEmpty();
}
// ── 用户管理 · 设置主岗位 ──────────────────────────────────────────────
/**
* 「设置主岗位」按钮:选 1 用户 → 弹窗 form。initApi 拉该用户岗位(SYS_POSITIONUSER_SEARCH by USERID),

View File

@@ -14,6 +14,7 @@ import static org.mockito.Mockito.when;
import java.sql.ResultSet;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.function.Function;
@@ -912,6 +913,51 @@ class TemplateToAmisConverterTest {
"下钻应内嵌登录历史(edc05980) schema");
}
/**
* engineclass=FuncDownloadComponent(功能模板下载模板管理/设置,type=3 树页)→ 整页改写器(机制① MUTATORS):
* 移除右表单「添加」按钮(空 toolbar 整条移除)+ 右表单标题改「编辑模板附件」。复刻 refreshRightLayout。
*/
@Test
@SuppressWarnings("unchecked")
void engineclass_FuncDownload_去添加按钮并改标题() {
// 模拟转换后 type=3 树页:grid → 列[左 input-tree][右 button-toolbar[添加] + form]
Map<String, Object> addBtn = new LinkedHashMap<>();
addBtn.put("type", "button");
addBtn.put("label", "添加");
Map<String, Object> toolbar = new LinkedHashMap<>();
toolbar.put("type", "button-toolbar");
toolbar.put("buttons", new ArrayList<>(List.of(addBtn)));
Map<String, Object> form = new LinkedHashMap<>();
form.put("type", "form");
form.put("title", "功能模板下载模板设置");
Map<String, Object> rightCol = new LinkedHashMap<>();
rightCol.put("body", new ArrayList<>(List.of(toolbar, form)));
Map<String, Object> tree = new LinkedHashMap<>();
tree.put("type", "input-tree");
Map<String, Object> leftCol = new LinkedHashMap<>();
leftCol.put("body", new ArrayList<>(List.of(tree)));
Map<String, Object> grid = new LinkedHashMap<>();
grid.put("type", "grid");
grid.put("columns", new ArrayList<>(List.of(leftCol, rightCol)));
Map<String, Object> schema = new LinkedHashMap<>();
schema.put("type", "page");
schema.put("body", grid);
EngineclassDelta.apply(schema,
"com.dsasp.client.viewframework.component.FuncDownloadComponent", null);
List<Object> rb = (List<Object>) rightCol.get("body");
boolean hasToolbar = rb.stream()
.anyMatch(o -> o instanceof Map && "button-toolbar".equals(((Map<String, Object>) o).get("type")));
assertFalse(hasToolbar, "添加按钮已删 → 空 button-toolbar 应整条移除");
assertEquals("编辑模板附件", form.get("title"), "右表单标题应改为「编辑模板附件」");
// 左树不受影响、表单仍在
assertEquals("input-tree", tree.get("type"));
boolean hasForm = rb.stream()
.anyMatch(o -> o instanceof Map && "form".equals(((Map<String, Object>) o).get("type")));
assertTrue(hasForm, "右表单应保留(仅去增删按钮+改标题)");
}
/** navigation isneedselected=false → 独立导航,不注入选中行主键、按钮不随选中态禁用。 */
@Test
@SuppressWarnings("unchecked")