转换器 convertForm 解析 view_page <layout> 多 <tab> → amis tabs

72 页多页签编辑表单原 convertForm 跳过 <layout>、全塌平为单一两栏平铺(多 tab 丢失)。
新增 buildFormBody:
- <layout> 多 <tab> → amis tabs;字段按各 tab 内 <div location="X"> 文档序归位
  (正则提取 location,规避 CDATA 内 HTML 的 &nbsp; 等非严格 XML 实体导致的解析失败)
- 单 tab 不套 tabs 壳(按 layout 排序两栏);无 layout 退回原 buildFormRows(零回归)
- 未被任何 <div location> 引用的字段(隐藏主键/未布局)收尾追加末 tab,不丢失

本轮范围:多页签 + 字段归位(修功能性缺陷);width/colspan 像素级版面(875/1241 页,
低 ROI)暂按两栏近似,不降级仅记 note,留后续专项。

新增多页签单测;platform-converter 70 测试全绿,amis tabs 经 amis 6.13 SchemaGate 闸一确认合法。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-13 23:09:49 +08:00
parent b28bff2f46
commit 3735a9ba9a
2 changed files with 135 additions and 7 deletions

View File

@@ -3,8 +3,10 @@ package com.eip4.platform.converter;
import java.util.ArrayList;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.function.Function;
import org.dom4j.Document;
@@ -722,10 +724,11 @@ public class TemplateToAmisConverter {
String pageId = form.attributeValue("pageid", "");
List<Map<String, Object>> formItems = new ArrayList<>();
Element pageRoot = null;
String pageXml = (pageResolver != null && !pageId.isBlank()) ? pageResolver.apply(pageId) : null;
if (pageXml != null && !pageXml.isBlank()) {
Document pageDoc = DocumentHelper.parseText(pageXml);
Element fields = pageDoc.getRootElement().element("fields");
pageRoot = DocumentHelper.parseText(pageXml).getRootElement();
Element fields = pageRoot.element("fields");
if (fields != null) {
// 列元数据(含 enumeratetype):供 ComboBox 缺省 comboboxid 但 itemisenumerate=true 取枚举字典源
Map<String, String[]> colMeta = loadColumnMeta(entityId, result);
@@ -734,10 +737,7 @@ public class TemplateToAmisConverter {
}
result.note("form@pageid=" + pageId + " → 解析 view_page 取得 " + formItems.size() + " 字段");
}
// HTML <layout> 自定义表格版式由下方两栏横排模式接管,不再记为降级
if (pageDoc.getRootElement().element("layout") != null) {
result.note("form 含 HTML <layout> → 已用 amis 两栏横排模式替代,版式无需人工核对");
}
// <layout> 多 <tab> 由 buildFormBody 解析为 amis tabs(见该方法);无 layout 退两栏排版
} else {
result.degrade("form@pageid=" + pageId + " 无法解析 view_page(缺解析器/页面不存在)→ 空表单壳");
}
@@ -792,7 +792,7 @@ public class TemplateToAmisConverter {
Map<String, Object> labelAlign = new LinkedHashMap<>();
labelAlign.put("leftFixed", 120);
formSchema.put("horizontal", labelAlign);
formSchema.put("body", buildFormRows(formItems));
formSchema.put("body", buildFormBody(pageRoot, formItems, result));
// 服务流提交按钮(每个带 name 的 method 一个);无 name 方法或无 method → 空 actions
formSchema.put("actions", formActions);
return page(formTitle, formSchema);
@@ -853,6 +853,91 @@ public class TemplateToAmisConverter {
};
}
/**
* 表单 body 构建:有 view_page {@code <layout>} 多 {@code <tab>} 时 → amis {@code tabs}
* (字段按各 tab 内 {@code <div location="X">} 文档序归位);无 layout/tab → 退回
* {@link #buildFormRows} 两栏排版。
*
* <p>tab body 是 CDATA 包裹的 HTML 表格,用正则提取 {@code location}(规避 {@code &nbsp;} 等
* 非严格 XML 实体导致的 HTML 解析失败)。未被任何 {@code <div location>} 引用的字段
* (隐藏主键/未布局)收尾追加到末 tab,确保不丢失。
*
* <p><b>本轮范围</b>:只还原「多页签 + 字段归位」——修 72 页多 tab 原塌平为单一平铺的
* 功能性缺陷。width/colspan 像素级精度(875/1241 页纯版面,低 ROI)暂未还原,仍按两栏近似,
* 留后续专项;故此处不降级,仅以 note 标注。
*/
@SuppressWarnings("unchecked")
private static List<Map<String, Object>> buildFormBody(Element pageRoot,
List<Map<String, Object>> formItems, ConversionResult result) {
Element layout = pageRoot != null ? pageRoot.element("layout") : null;
List<Element> tabEls = layout != null ? layout.elements("tab") : List.of();
if (tabEls.isEmpty()) {
return buildFormRows(formItems); // 无 layout/tab → 原两栏排版
}
Map<String, Map<String, Object>> byName = new LinkedHashMap<>();
for (Map<String, Object> it : formItems) {
byName.put(String.valueOf(it.get("name")), it);
}
Set<String> placed = new LinkedHashSet<>();
List<Map<String, Object>> tabSchemas = new ArrayList<>();
for (Element tabEl : tabEls) {
String title = tabEl.attributeValue("name");
if (title == null || title.isBlank()) {
title = "页面";
}
List<Map<String, Object>> tabItems = new ArrayList<>();
for (String nm : extractLocations(tabEl.getText())) {
Map<String, Object> it = byName.get(nm);
if (it != null && placed.add(nm)) {
tabItems.add(it);
}
}
Map<String, Object> tabSchema = new LinkedHashMap<>();
tabSchema.put("title", title);
tabSchema.put("body", buildFormRows(tabItems));
tabSchemas.add(tabSchema);
}
// 未被任何 <div location> 引用的字段(隐藏主键/未布局)收尾追加到末 tab,不丢失
List<Map<String, Object>> leftovers = new ArrayList<>();
for (Map<String, Object> it : formItems) {
if (!placed.contains(String.valueOf(it.get("name")))) {
leftovers.add(it);
}
}
if (!leftovers.isEmpty()) {
Map<String, Object> lastTab = tabSchemas.get(tabSchemas.size() - 1);
((List<Map<String, Object>>) lastTab.get("body")).addAll(buildFormRows(leftovers));
}
result.note("form <layout> → " + tabSchemas.size() + " 个 amis tab(字段按 <div location> 归位"
+ (leftovers.isEmpty() ? "" : ";" + leftovers.size() + " 个未布局字段收尾追加")
+ ";width/colspan 像素版面暂按两栏近似,后续专项)");
if (tabSchemas.size() == 1) {
return (List<Map<String, Object>>) tabSchemas.get(0).get("body"); // 单 tab 不套 tabs 壳
}
Map<String, Object> tabsWrapper = new LinkedHashMap<>();
tabsWrapper.put("type", "tabs");
tabsWrapper.put("tabs", tabSchemas);
List<Map<String, Object>> bodyList = new ArrayList<>();
bodyList.add(tabsWrapper);
return bodyList;
}
private static final java.util.regex.Pattern LOCATION_ATTR =
java.util.regex.Pattern.compile("location\\s*=\\s*\"([^\"]+)\"");
/** 从 tab 的 HTML(CDATA)文本按文档序提取 {@code <div location="X">} 的字段名。 */
private static List<String> extractLocations(String html) {
List<String> names = new ArrayList<>();
if (html == null || html.isBlank()) {
return names;
}
java.util.regex.Matcher m = LOCATION_ATTR.matcher(html);
while (m.find()) {
names.add(m.group(1));
}
return names;
}
/**
* 安全中和:判断 type=delete 按钮是否为真删除(name 严格属于删除语义词汇表)。
*