P4-1 转换器线:扩 EDITFORM/主子表/树/选择窗/<report> 段 + 全量 1516 模板批量转换双闸分级
转换器扩展(platform-converter,PoC crud 三段种子上): - 按 XML 根元素分派 crud/form/tree/report/group;ConversionResult+Grade 三级分级 - EDITFORM:form pageid 解析 view_page 取字段;主子表 EditGrid/FormEditGrid→input-table(子列取自 editgridtemplate) - 树:type=3 声明式→input-tree、type=4 引用式→flex(tree+crud) - 选择窗 SelectDialog/MultiSelectDialog→select+source(非 amis picker:picker 不在 6.13 schema 表单项 oneOf,闸一会拒) - <report> A 类:crud+合计行(issummer→summaryFields)+金额列(ismoney→number);selectservice→/api/flow;JOR/图表降级标注 - UiTypeMapper 统一 uitype 映射;每决策登记映射台账(全量约 1.6 万条) - 孤儿模板(entityid 非法/空 xml)旁路标记不崩(手册 §7.4) 批量+双闸(BatchConvertCli,可独立 CLI 跑批,只读连库+5435 ceshi 库硬守门): - 闸一 SchemaGate(宽松语义预处理抽出,与 AmisSchemaController 共享):通过 98.2%(1489/1516) - 闸二 playwright+本地 amis SDK 渲染冒烟,每类型抽≥5:25/25 全过 - 产物 转换产物/(schema/*.json + 分级清单.csv + 闸二结果.json) - 失败 27 个全为空 xml 孤儿模板(库内数据问题,非转换器缺陷) 新坑进手册 §8.3(picker 不在表单项 oneOf,用 select+source) §8.4(闸二大 schema 经端点拉避 HTTP 431) 单测 24 个;全 reactor mvn test+ArchUnit 绿 报告 platform-converter/P4批量转换报告.md Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,257 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.io.Writer;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.sql.Connection;
|
||||
import java.sql.DriverManager;
|
||||
import java.sql.PreparedStatement;
|
||||
import java.sql.ResultSet;
|
||||
import java.sql.SQLException;
|
||||
import java.util.ArrayList;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.TreeMap;
|
||||
import java.util.function.Function;
|
||||
|
||||
import org.springframework.jdbc.core.JdbcTemplate;
|
||||
import org.springframework.jdbc.datasource.SingleConnectionDataSource;
|
||||
|
||||
import com.fasterxml.jackson.databind.ObjectMapper;
|
||||
import com.fasterxml.jackson.databind.SerializationFeature;
|
||||
|
||||
/**
|
||||
* P4 批量转换 CLI(架构第一节定位:转换器可独立运行,不经 Boot 自动装配)。
|
||||
*
|
||||
* <p>流程:从客户库(PostgreSQL,只读)拉全部 view_template.xml → 逐个 {@link TemplateToAmisConverter}
|
||||
* 转换 → 闸一 {@link SchemaGate} 官方 schema 校验 → 产物落盘 + 分级清单 CSV。
|
||||
*
|
||||
* <p>用法:
|
||||
* <pre>{@code
|
||||
* java -cp ... com.eip4.platform.converter.BatchConvertCli \
|
||||
* "jdbc:postgresql://192.168.20.68:5435/postgres?currentSchema=eip3" ceshi ceshi 转换产物
|
||||
* }</pre>
|
||||
* 参数缺省即上述客户库(只读)。⚠️ 5435 上有个不完整的 ceshi 库——严禁连 dbname=ceshi;本 CLI 硬校验
|
||||
* URL 必须 dbname=postgres,否则拒绝启动。
|
||||
*/
|
||||
public final class BatchConvertCli {
|
||||
|
||||
private static final String DEFAULT_URL =
|
||||
"jdbc:postgresql://192.168.20.68:5435/postgres?currentSchema=eip3";
|
||||
private static final String DEFAULT_USER = "ceshi";
|
||||
private static final String DEFAULT_PASS = "ceshi";
|
||||
private static final String DEFAULT_OUT = "转换产物";
|
||||
|
||||
private BatchConvertCli() {
|
||||
}
|
||||
|
||||
public static void main(String[] args) throws Exception {
|
||||
String url = args.length > 0 ? args[0] : DEFAULT_URL;
|
||||
String user = args.length > 1 ? args[1] : DEFAULT_USER;
|
||||
String pass = args.length > 2 ? args[2] : DEFAULT_PASS;
|
||||
Path outDir = Path.of(args.length > 3 ? args[3] : DEFAULT_OUT);
|
||||
|
||||
guardUrl(url);
|
||||
|
||||
Connection conn = DriverManager.getConnection(url, user, pass);
|
||||
conn.setReadOnly(true); // 只读保护(任务红线)
|
||||
conn.setAutoCommit(true);
|
||||
try {
|
||||
BatchSummary summary = run(conn, outDir);
|
||||
System.out.println(summary.render());
|
||||
} finally {
|
||||
conn.close();
|
||||
}
|
||||
}
|
||||
|
||||
/** dbname 必须是 postgres——拦住误连 5435 上不完整的 ceshi 库(任务红线)。 */
|
||||
static void guardUrl(String url) {
|
||||
String afterHost = url.replaceFirst("^jdbc:postgresql://[^/]+/", "");
|
||||
String db = afterHost.split("[?]", 2)[0];
|
||||
if (!"postgres".equals(db)) {
|
||||
throw new IllegalArgumentException(
|
||||
"拒绝连接:dbname=" + db + ",只允许 dbname=postgres(5435 上有不完整的 ceshi 库,严禁连)");
|
||||
}
|
||||
}
|
||||
|
||||
static BatchSummary run(Connection conn, Path outDir) throws IOException, SQLException {
|
||||
Path schemaDir = outDir.resolve("schema");
|
||||
Files.createDirectories(schemaDir);
|
||||
|
||||
JdbcTemplate jdbc = new JdbcTemplate(new SingleConnectionDataSource(conn, true));
|
||||
TemplateToAmisConverter converter = new TemplateToAmisConverter(jdbc);
|
||||
SchemaGate gate = new SchemaGate();
|
||||
Function<String, String> pageResolver = pageId -> loadPageXml(conn, pageId);
|
||||
|
||||
ObjectMapper json = new ObjectMapper();
|
||||
json.enable(SerializationFeature.INDENT_OUTPUT);
|
||||
|
||||
BatchSummary summary = new BatchSummary();
|
||||
List<String[]> csvRows = new ArrayList<>();
|
||||
// CSV 表头:模板id,名称,type,根元素,分级,闸一(schema),映射条数,原因归类
|
||||
csvRows.add(new String[]{"view_template_id", "name", "type", "root", "grade",
|
||||
"gate1_schema_valid", "mapping_notes", "reasons"});
|
||||
|
||||
String sql = "SELECT view_template_id, name, type, xml::text AS xmltext "
|
||||
+ "FROM view_template ORDER BY type, view_template_id";
|
||||
try (PreparedStatement ps = conn.prepareStatement(sql);
|
||||
ResultSet rs = ps.executeQuery()) {
|
||||
while (rs.next()) {
|
||||
String id = rs.getString("view_template_id").trim();
|
||||
String name = rs.getString("name");
|
||||
int type = rs.getInt("type");
|
||||
String xml = rs.getString("xmltext");
|
||||
|
||||
if (xml == null || xml.isBlank()) {
|
||||
summary.record("(null-xml)", ConversionGrade.FAILED, false);
|
||||
csvRows.add(new String[]{id, name, String.valueOf(type), "(null-xml)",
|
||||
"FAILED", "false", "0", "模板数据问题:xml 为空(孤儿模板)"});
|
||||
continue;
|
||||
}
|
||||
|
||||
List<String> notes = new ArrayList<>();
|
||||
ConversionResult result = converter.convertGraded(xml, notes, pageResolver);
|
||||
boolean gate1 = false;
|
||||
if (result.getSchema() != null) {
|
||||
List<String> errors = gate.validate(result.getSchema());
|
||||
gate1 = errors.isEmpty();
|
||||
if (!gate1) {
|
||||
// schema 校验失败也是一种降级原因,登记进归类(不改原 grade 的转换语义,单列闸一结果)
|
||||
result.getDegrades().add("闸一 schema 校验未过: "
|
||||
+ String.join(" | ", errors.subList(0, Math.min(3, errors.size()))));
|
||||
}
|
||||
// 产物落盘(schema json 按模板 id 命名)
|
||||
Files.writeString(schemaDir.resolve(id + ".json"),
|
||||
json.writeValueAsString(result.getSchema()), StandardCharsets.UTF_8);
|
||||
}
|
||||
|
||||
ConversionGrade effective = effectiveGrade(result.getGrade(), gate1);
|
||||
summary.record(result.getRootElement(), effective, gate1);
|
||||
csvRows.add(new String[]{
|
||||
id, name, String.valueOf(type), result.getRootElement(),
|
||||
effective.name(), String.valueOf(gate1),
|
||||
String.valueOf(result.getMappingNotes().size()),
|
||||
classifyReasons(result)});
|
||||
}
|
||||
}
|
||||
|
||||
writeCsv(outDir.resolve("分级清单.csv"), csvRows);
|
||||
return summary;
|
||||
}
|
||||
|
||||
/** 闸一不过 → 即便转换 SUCCESS 也降为 PARTIAL(双闸缺一不可,手册 §8.2)。 */
|
||||
private static ConversionGrade effectiveGrade(ConversionGrade convertGrade, boolean gate1) {
|
||||
if (convertGrade == ConversionGrade.FAILED) {
|
||||
return ConversionGrade.FAILED;
|
||||
}
|
||||
return gate1 ? convertGrade : ConversionGrade.PARTIAL;
|
||||
}
|
||||
|
||||
/** 把降级原因归类成三桶之一(转换器缺陷 / 模板数据问题 / 孤儿模板),便于 Top10 统计。 */
|
||||
static String classifyReasons(ConversionResult result) {
|
||||
if (result.getDegrades().isEmpty()) {
|
||||
return "";
|
||||
}
|
||||
List<String> tags = new ArrayList<>();
|
||||
for (String d : result.getDegrades()) {
|
||||
tags.add(bucket(d) + ":" + d.replace(",", ","));
|
||||
}
|
||||
return String.join(" | ", tags);
|
||||
}
|
||||
|
||||
static String bucket(String degrade) {
|
||||
if (degrade.contains("孤儿") || degrade.contains("SYS_ENTITY 无对应") || degrade.contains("entityid")) {
|
||||
return "孤儿模板";
|
||||
}
|
||||
if (degrade.contains("xml 为空") || degrade.contains("解析失败") || degrade.contains("无法解析 view_page")) {
|
||||
return "模板数据问题";
|
||||
}
|
||||
// picker/子表/跨模板/JOR/图表 等本批未实现的能力 → 归转换器缺陷(待补能力)
|
||||
return "转换器缺陷";
|
||||
}
|
||||
|
||||
private static void writeCsv(Path path, List<String[]> rows) throws IOException {
|
||||
try (Writer w = Files.newBufferedWriter(path, StandardCharsets.UTF_8)) {
|
||||
w.write(''); // BOM,便于 Excel 识别 UTF-8 中文
|
||||
for (String[] row : rows) {
|
||||
StringBuilder sb = new StringBuilder();
|
||||
for (int i = 0; i < row.length; i++) {
|
||||
if (i > 0) {
|
||||
sb.append(',');
|
||||
}
|
||||
sb.append(csvCell(row[i]));
|
||||
}
|
||||
sb.append('\n');
|
||||
w.write(sb.toString());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private static String csvCell(String v) {
|
||||
if (v == null) {
|
||||
return "";
|
||||
}
|
||||
if (v.contains(",") || v.contains("\"") || v.contains("\n")) {
|
||||
return '"' + v.replace("\"", "\"\"") + '"';
|
||||
}
|
||||
return v;
|
||||
}
|
||||
|
||||
private static String loadPageXml(Connection conn, String pageId) {
|
||||
if (pageId == null || pageId.isBlank()) {
|
||||
return null;
|
||||
}
|
||||
try (PreparedStatement ps = conn.prepareStatement(
|
||||
"SELECT xml::text FROM view_page WHERE view_page_id=? AND xml IS NOT NULL")) {
|
||||
ps.setString(1, pageId);
|
||||
try (ResultSet rs = ps.executeQuery()) {
|
||||
return rs.next() ? rs.getString(1) : null;
|
||||
}
|
||||
} catch (SQLException e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/** 跑批统计累加器:总量 + 各根元素分布 + 分级 + 闸一通过率。 */
|
||||
static final class BatchSummary {
|
||||
int total;
|
||||
int gate1Pass;
|
||||
final Map<ConversionGrade, Integer> grades = new LinkedHashMap<>();
|
||||
final Map<String, int[]> byRoot = new TreeMap<>(); // root → [total, gate1Pass]
|
||||
|
||||
void record(String root, ConversionGrade grade, boolean gate1) {
|
||||
total++;
|
||||
grades.merge(grade, 1, Integer::sum);
|
||||
if (gate1) {
|
||||
gate1Pass++;
|
||||
}
|
||||
int[] r = byRoot.computeIfAbsent(root, k -> new int[2]);
|
||||
r[0]++;
|
||||
if (gate1) {
|
||||
r[1]++;
|
||||
}
|
||||
}
|
||||
|
||||
String render() {
|
||||
StringBuilder sb = new StringBuilder();
|
||||
sb.append("=== P4 批量转换汇总 ===\n");
|
||||
sb.append("总量: ").append(total).append('\n');
|
||||
sb.append("闸一(schema)通过: ").append(gate1Pass)
|
||||
.append(" (").append(pct(gate1Pass, total)).append(")\n");
|
||||
sb.append("分级: ");
|
||||
grades.forEach((g, n) -> sb.append(g).append('=').append(n).append(" "));
|
||||
sb.append('\n');
|
||||
sb.append("各根元素 [总量/闸一通过/通过率]:\n");
|
||||
byRoot.forEach((root, r) -> sb.append(" ").append(root).append(": ")
|
||||
.append(r[0]).append('/').append(r[1]).append('/').append(pct(r[1], r[0])).append('\n'));
|
||||
return sb.toString();
|
||||
}
|
||||
|
||||
static String pct(int n, int d) {
|
||||
return d == 0 ? "0%" : String.format("%.1f%%", n * 100.0 / d);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,16 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
/**
|
||||
* 转换分级(P4 双闸分级口径,对应报表迁移方案 A 类「做不到的字段降级标注」)。
|
||||
*
|
||||
* <ul>
|
||||
* <li>{@link #SUCCESS} —— 全字段命中映射规则,无降级标注;</li>
|
||||
* <li>{@link #PARTIAL} —— 转出有效 amis schema,但有字段/特性走了降级旁路(标注在 mappingNotes / degrades);</li>
|
||||
* <li>{@link #FAILED} —— 无法转出(孤儿模板 / 根元素不支持 / 解析异常),不入产物只入失败清单。</li>
|
||||
* </ul>
|
||||
*/
|
||||
public enum ConversionGrade {
|
||||
SUCCESS,
|
||||
PARTIAL,
|
||||
FAILED
|
||||
}
|
||||
@@ -0,0 +1,76 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* 单个模板的转换结果(批量跑批的逐模板产物单元)。
|
||||
*
|
||||
* <p>携带四样东西,供 CLI 落盘与分级清单使用:
|
||||
* <ul>
|
||||
* <li>{@code schema} —— 转出的 amis 页面 schema(FAILED 时为 null);</li>
|
||||
* <li>{@code grade} —— 分级(success / partial / failed);</li>
|
||||
* <li>{@code mappingNotes} —— 映射台账逐条登记(PoC 传统,每个映射决策一条);</li>
|
||||
* <li>{@code degrades} —— 降级标注(PARTIAL/FAILED 的归因,写入 CSV 的「原因」列)。</li>
|
||||
* </ul>
|
||||
*/
|
||||
public class ConversionResult {
|
||||
|
||||
private final String rootElement;
|
||||
private Map<String, Object> schema;
|
||||
private ConversionGrade grade = ConversionGrade.SUCCESS;
|
||||
private final List<String> mappingNotes;
|
||||
private final List<String> degrades = new ArrayList<>();
|
||||
|
||||
public ConversionResult(String rootElement, List<String> mappingNotes) {
|
||||
this.rootElement = rootElement;
|
||||
this.mappingNotes = mappingNotes;
|
||||
}
|
||||
|
||||
public String getRootElement() {
|
||||
return rootElement;
|
||||
}
|
||||
|
||||
public Map<String, Object> getSchema() {
|
||||
return schema;
|
||||
}
|
||||
|
||||
public void setSchema(Map<String, Object> schema) {
|
||||
this.schema = schema;
|
||||
}
|
||||
|
||||
public ConversionGrade getGrade() {
|
||||
return grade;
|
||||
}
|
||||
|
||||
public List<String> getMappingNotes() {
|
||||
return mappingNotes;
|
||||
}
|
||||
|
||||
public List<String> getDegrades() {
|
||||
return degrades;
|
||||
}
|
||||
|
||||
/** 登记一条映射决策(同时进映射台账)。 */
|
||||
public void note(String note) {
|
||||
mappingNotes.add(note);
|
||||
}
|
||||
|
||||
/** 标记一处降级:登记原因并把分级降到 PARTIAL(除非已是 FAILED)。 */
|
||||
public void degrade(String reason) {
|
||||
degrades.add(reason);
|
||||
mappingNotes.add("[降级] " + reason);
|
||||
if (grade == ConversionGrade.SUCCESS) {
|
||||
grade = ConversionGrade.PARTIAL;
|
||||
}
|
||||
}
|
||||
|
||||
/** 标记彻底失败:无 schema 产物,进失败清单。 */
|
||||
public void fail(String reason) {
|
||||
degrades.add(reason);
|
||||
mappingNotes.add("[失败] " + reason);
|
||||
grade = ConversionGrade.FAILED;
|
||||
schema = null;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
import java.util.Set;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
import com.fasterxml.jackson.databind.JsonNode;
|
||||
import com.fasterxml.jackson.databind.ObjectMapper;
|
||||
import com.fasterxml.jackson.databind.node.ArrayNode;
|
||||
import com.fasterxml.jackson.databind.node.ObjectNode;
|
||||
import com.networknt.schema.JsonSchema;
|
||||
import com.networknt.schema.JsonSchemaFactory;
|
||||
import com.networknt.schema.SpecVersion;
|
||||
import com.networknt.schema.ValidationMessage;
|
||||
|
||||
/**
|
||||
* 闸一:amis 官方 schema.json(draft-07)机器校验闭环(迁移手册 §8.1)。
|
||||
*
|
||||
* <p>官方 schema 大量使用 {@code {"$ref":..., "additionalProperties":true}} 的兄弟键覆盖写法——这是
|
||||
* VSCode/Monaco 的宽松合并语义;严格 draft-07 下兄弟键被忽略,被引用定义里的 {@code additionalProperties:false}
|
||||
* 会拒绝一切输入。预处理:全局剥除 {@code additionalProperties:false},保留类型/必填/结构校验。
|
||||
*
|
||||
* <p>「所有使用 ajv 校验 amis schema 的地方都需要这个预处理步骤」(手册 §8.1)——本类把该步骤封进
|
||||
* platform-converter,供 CLI 跑批与 AmisSchemaController 共享同一份口径。schema 资源同时随 converter
|
||||
* 与 metadata 打包(CLI 自包含,不反向依赖 metadata)。
|
||||
*/
|
||||
public class SchemaGate {
|
||||
|
||||
private final ObjectMapper mapper = new ObjectMapper();
|
||||
private final JsonSchema amisSchema;
|
||||
|
||||
public SchemaGate() {
|
||||
this("/amis-schema-6.13.0.json");
|
||||
}
|
||||
|
||||
public SchemaGate(String classpathResource) {
|
||||
try {
|
||||
JsonNode schemaNode = mapper.readTree(getClass().getResourceAsStream(classpathResource));
|
||||
stripStrictAdditionalProperties(schemaNode);
|
||||
this.amisSchema = JsonSchemaFactory.getInstance(SpecVersion.VersionFlag.V7).getSchema(schemaNode);
|
||||
} catch (Exception e) {
|
||||
throw new IllegalStateException("加载 amis schema 失败: " + classpathResource, e);
|
||||
}
|
||||
}
|
||||
|
||||
/** 校验一个 amis 页面 schema(Map),返回错误消息列表(空=通过)。 */
|
||||
public java.util.List<String> validate(Object schema) {
|
||||
JsonNode node = mapper.valueToTree(schema);
|
||||
Set<ValidationMessage> errors = amisSchema.validate(node);
|
||||
return errors.stream().map(ValidationMessage::getMessage).collect(Collectors.toList());
|
||||
}
|
||||
|
||||
private static void stripStrictAdditionalProperties(JsonNode node) {
|
||||
if (node instanceof ObjectNode obj) {
|
||||
JsonNode ap = obj.get("additionalProperties");
|
||||
if (ap != null && ap.isBoolean() && !ap.asBoolean()) {
|
||||
obj.remove("additionalProperties");
|
||||
}
|
||||
obj.properties().forEach(e -> stripStrictAdditionalProperties(e.getValue()));
|
||||
} else if (node instanceof ArrayNode arr) {
|
||||
arr.forEach(SchemaGate::stripStrictAdditionalProperties);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -4,6 +4,7 @@ import java.util.ArrayList;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.function.Function;
|
||||
|
||||
import org.dom4j.Document;
|
||||
import org.dom4j.DocumentHelper;
|
||||
@@ -12,9 +13,20 @@ import org.springframework.jdbc.core.JdbcTemplate;
|
||||
import org.springframework.stereotype.Component;
|
||||
|
||||
/**
|
||||
* 模板 XML → amis schema 转换器原型(P4 批量转换器的种子,对应 PoC 方案 4.1.5)。
|
||||
* 当前覆盖 GRID(type=1) 模板的 display/search/button 三段;
|
||||
* 每个映射决策都登记进 mappingNotes,作为映射表 v0 的数据来源。
|
||||
* 模板 XML → amis schema 转换器(P4 批量转换器)。
|
||||
*
|
||||
* <p>PoC 种子已验证 GRID(crud) 的 display/search/button 三段;P4 在此基础上按根元素分派扩展:
|
||||
* <ul>
|
||||
* <li>{@code <crud>} GRID 列表页(含主子表识别)→ amis crud;</li>
|
||||
* <li>{@code <form>} EDITFORM 表单页 → amis form(字段取自 pageid 指向的 view_page);</li>
|
||||
* <li>{@code <tree>} 树 / 树+grid → amis tree(type=4 树+grid 走 page+tree+crud);</li>
|
||||
* <li>{@code <report>} A 类表格式报表(报表迁移方案口径)→ amis crud + 合计行/金额列;</li>
|
||||
* <li>{@code <group>} 分组容器 → amis tabs 占位(子模板跨引用,本批降级标注)。</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>每个映射决策登记进 {@link ConversionResult#getMappingNotes()}(PoC 传统映射台账);做不到的字段/特性
|
||||
* 走 {@link ConversionResult#degrade} 降级标注;孤儿模板(entityid 非法/解析失败)走 {@link ConversionResult#fail}
|
||||
* 旁路处理,不抛异常终止批量(迁移手册 §7.4)。
|
||||
*/
|
||||
@Component
|
||||
public class TemplateToAmisConverter {
|
||||
@@ -25,130 +37,86 @@ public class TemplateToAmisConverter {
|
||||
this.jdbcTemplate = jdbcTemplate;
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// 兼容入口:保留 PoC / AmisSchemaController 既有签名(crud 三段)
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
public Map<String, Object> convert(String templateXml, List<String> mappingNotes) throws Exception {
|
||||
Document doc = DocumentHelper.parseText(templateXml);
|
||||
Element crud = doc.getRootElement();
|
||||
if (!"crud".equals(crud.getName())) {
|
||||
throw new IllegalArgumentException("非 crud 模板: " + crud.getName());
|
||||
ConversionResult r = convertGraded(templateXml, mappingNotes, this::loadPageXml);
|
||||
if (r.getGrade() == ConversionGrade.FAILED) {
|
||||
throw new IllegalArgumentException(String.join("; ", r.getDegrades()));
|
||||
}
|
||||
return r.getSchema();
|
||||
}
|
||||
|
||||
/** 注入 JdbcTemplate 的便捷分级入口(页面 XML 解析器走库内 view_page)。 */
|
||||
public ConversionResult convertGraded(String templateXml) {
|
||||
return convertGraded(templateXml, new ArrayList<>(), this::loadPageXml);
|
||||
}
|
||||
|
||||
/**
|
||||
* 分级转换主入口(批量跑批用)。
|
||||
*
|
||||
* @param templateXml view_template.xml 原文
|
||||
* @param mappingNotes 映射台账累加器
|
||||
* @param pageResolver pageid → view_page.xml 解析器(form EDITFORM 用;可为 null,缺则降级)
|
||||
*/
|
||||
public ConversionResult convertGraded(String templateXml, List<String> mappingNotes,
|
||||
Function<String, String> pageResolver) {
|
||||
Document doc;
|
||||
String root;
|
||||
try {
|
||||
doc = DocumentHelper.parseText(templateXml);
|
||||
root = doc.getRootElement().getName();
|
||||
} catch (Exception e) {
|
||||
ConversionResult r = new ConversionResult("(parse-error)", mappingNotes);
|
||||
r.fail("XML 解析失败: " + e.getClass().getSimpleName() + " " + safeMsg(e));
|
||||
return r;
|
||||
}
|
||||
|
||||
ConversionResult result = new ConversionResult(root, mappingNotes);
|
||||
try {
|
||||
Element rootEl = doc.getRootElement();
|
||||
switch (root) {
|
||||
case "crud" -> result.setSchema(convertCrud(rootEl, result));
|
||||
case "form" -> result.setSchema(convertForm(rootEl, result, pageResolver));
|
||||
case "tree" -> result.setSchema(convertTree(rootEl, result));
|
||||
case "report" -> result.setSchema(convertReport(rootEl, result));
|
||||
case "group" -> result.setSchema(convertGroup(rootEl, result));
|
||||
default -> result.fail("不支持的根元素 <" + root + ">(非 crud/form/tree/report/group)");
|
||||
}
|
||||
} catch (Exception e) {
|
||||
result.fail("转换异常: " + e.getClass().getSimpleName() + " " + safeMsg(e));
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// crud(GRID 列表页)—— PoC 种子规则,强化 null-safe + 主子表识别
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
private Map<String, Object> convertCrud(Element crud, ConversionResult result) {
|
||||
String title = crud.attributeValue("title", "");
|
||||
String entityId = crud.attributeValue("entityid", "");
|
||||
String table = resolveTableName(entityId);
|
||||
mappingNotes.add("crud@entityid=" + entityId + " → 实体表 " + table + "(经 SYS_ENTITY 解析)");
|
||||
String table = resolveTableName(entityId, result);
|
||||
|
||||
// ── display/field → columns
|
||||
List<Map<String, Object>> columns = new ArrayList<>();
|
||||
// display 可能直接挂 crud,也可能挂 <display> 子元素
|
||||
Element display = crud.element("display");
|
||||
if (display != null) {
|
||||
for (Element f : display.elements("field")) {
|
||||
String name = f.attributeValue("name", "");
|
||||
Map<String, Object> col = new LinkedHashMap<>();
|
||||
if (name.endsWith("_DISPLAY__")) {
|
||||
// 旧引擎的字典/时间翻译列;PoC 先映射回原始列,翻译值待 REST 层补
|
||||
String raw = name.substring(0, name.length() - "_DISPLAY__".length());
|
||||
col.put("name", raw);
|
||||
mappingNotes.add("display@field " + name + " → 原始列 " + raw + "(翻译列,REST 层待补显示值)");
|
||||
} else {
|
||||
col.put("name", name);
|
||||
}
|
||||
col.put("label", f.attributeValue("text", name));
|
||||
String width = f.attributeValue("width");
|
||||
if (width != null) {
|
||||
col.put("width", Integer.parseInt(width));
|
||||
}
|
||||
if ("true".equals(f.attributeValue("hidden"))) {
|
||||
col.put("toggled", false);
|
||||
mappingNotes.add("display@field " + name + " hidden=true → columns-toggler 默认隐藏");
|
||||
}
|
||||
columns.add(col);
|
||||
}
|
||||
List<Map<String, Object>> columns = display != null ? buildColumns(display, result) : new ArrayList<>();
|
||||
|
||||
Map<String, Object> filter = buildSearchFilter(crud.element("search"), result);
|
||||
List<Object> toolbar = buildToolbar(collectButtons(crud), table, result);
|
||||
|
||||
// 主子表识别:display 段含 <subtemplate>/<detail> 指向子表,或 crud 含 ismaster 标记
|
||||
boolean masterSub = crud.element("subtemplate") != null
|
||||
|| (display != null && display.element("subtemplate") != null);
|
||||
if (masterSub) {
|
||||
result.degrade("crud 含主子表声明(subtemplate) → 子表渲染需 input-table/嵌套 crud 联动,本批仅转主表列");
|
||||
}
|
||||
|
||||
// ── search/field → filter 表单
|
||||
Map<String, Object> filter = null;
|
||||
Element search = crud.element("search");
|
||||
if (search != null && !search.elements("field").isEmpty()) {
|
||||
List<Map<String, Object>> items = new ArrayList<>();
|
||||
for (Element f : search.elements("field")) {
|
||||
String name = f.attributeValue("name", "");
|
||||
String uitype = f.attributeValue("uitype", "TextField");
|
||||
Map<String, Object> item = new LinkedHashMap<>();
|
||||
item.put("name", name);
|
||||
item.put("label", f.attributeValue("label", name));
|
||||
switch (uitype) {
|
||||
case "ComboBox" -> {
|
||||
item.put("type", "select");
|
||||
item.put("clearable", true);
|
||||
String dict = f.attributeValue("comboboxid", "");
|
||||
item.put("source", "/api/poc/dict/" + dict);
|
||||
mappingNotes.add("search@field " + name + " uitype=ComboBox(comboboxid=" + dict
|
||||
+ ") → select + source 字典接口(接口待实现)");
|
||||
}
|
||||
case "DateField" -> {
|
||||
item.put("type", "input-date");
|
||||
mappingNotes.add("search@field " + name + " uitype=DateField → input-date");
|
||||
}
|
||||
default -> {
|
||||
item.put("type", "input-text");
|
||||
if (!"TextField".equals(uitype)) {
|
||||
mappingNotes.add("search@field " + name + " uitype=" + uitype
|
||||
+ " → 暂映射 input-text(映射表待补该控件)");
|
||||
}
|
||||
}
|
||||
}
|
||||
items.add(item);
|
||||
}
|
||||
filter = new LinkedHashMap<>();
|
||||
filter.put("title", "查询");
|
||||
filter.put("body", items);
|
||||
String script = search.attributeValue("script");
|
||||
if (script != null && !script.isBlank()) {
|
||||
mappingNotes.add("search@script 存在(" + script.length() + " 字符)→ 归入脚本分桶处理,本转换器跳过");
|
||||
}
|
||||
}
|
||||
|
||||
// ── button → headerToolbar
|
||||
List<Object> toolbar = new ArrayList<>();
|
||||
toolbar.add("bulkActions");
|
||||
for (Element b : crud.elements("button")) {
|
||||
if ("false".equals(b.attributeValue("isshow"))) {
|
||||
continue;
|
||||
}
|
||||
String btnType = b.attributeValue("type", "");
|
||||
Map<String, Object> btn = new LinkedHashMap<>();
|
||||
btn.put("type", "button");
|
||||
btn.put("label", b.attributeValue("name", b.attributeValue("id", "")));
|
||||
switch (btnType) {
|
||||
case "insert" -> {
|
||||
btn.put("level", "primary");
|
||||
btn.put("actionType", "dialog");
|
||||
Map<String, Object> dlg = new LinkedHashMap<>();
|
||||
dlg.put("type", "dialog");
|
||||
dlg.put("title", b.attributeValue("name", ""));
|
||||
dlg.put("body", Map.of("type", "tpl",
|
||||
"tpl", "表单页(pageid=" + b.attributeValue("pageid", "") + ")待 EDITFORM 模板转换"));
|
||||
btn.put("dialog", dlg);
|
||||
mappingNotes.add("button[insert] " + b.attributeValue("name") + " → dialog 占位(指向 pageid="
|
||||
+ b.attributeValue("pageid", "") + ",需 EDITFORM 转换器)");
|
||||
}
|
||||
case "delete" -> {
|
||||
btn.put("level", "danger");
|
||||
btn.put("actionType", "ajax");
|
||||
btn.put("confirmText", "确认删除选中记录?");
|
||||
btn.put("api", "delete:/api/entity/" + table + "/${ids}");
|
||||
mappingNotes.add("button[delete] → ajax DELETE /api/entity/" + table + "/${ids}(REST 端点待实现)");
|
||||
}
|
||||
default -> mappingNotes.add("button[" + btnType + "] " + b.attributeValue("name") + " → 普通按钮占位");
|
||||
}
|
||||
toolbar.add(btn);
|
||||
}
|
||||
toolbar.add("pagination");
|
||||
|
||||
// ── 组装 page > crud
|
||||
Map<String, Object> crudSchema = new LinkedHashMap<>();
|
||||
crudSchema.put("type", "crud");
|
||||
crudSchema.put("api", "/api/entity/" + table + "/list?page=${page}&perPage=${perPage}");
|
||||
crudSchema.put("api", listApi(crud, table));
|
||||
crudSchema.put("syncLocation", false);
|
||||
if (filter != null) {
|
||||
crudSchema.put("filter", filter);
|
||||
@@ -157,19 +125,428 @@ public class TemplateToAmisConverter {
|
||||
crudSchema.put("headerToolbar", toolbar);
|
||||
crudSchema.put("primaryField", table + "_ID");
|
||||
|
||||
return page(title, crudSchema);
|
||||
}
|
||||
|
||||
/** display/field → crud columns(含 _DISPLAY__ 翻译列、合计/金额特性)。 */
|
||||
private List<Map<String, Object>> buildColumns(Element display, ConversionResult result) {
|
||||
List<Map<String, Object>> columns = new ArrayList<>();
|
||||
for (Element f : display.elements("field")) {
|
||||
String name = f.attributeValue("name", "");
|
||||
Map<String, Object> col = new LinkedHashMap<>();
|
||||
if (name.endsWith("_DISPLAY__")) {
|
||||
String raw = name.substring(0, name.length() - "_DISPLAY__".length());
|
||||
col.put("name", raw);
|
||||
result.note("display@field " + name + " → 原始列 " + raw + "(翻译列,REST 层待补显示值)");
|
||||
} else {
|
||||
col.put("name", name);
|
||||
}
|
||||
col.put("label", UiTypeMapper.firstNonBlank(f.attributeValue("text"), f.attributeValue("label"), name));
|
||||
String width = f.attributeValue("width");
|
||||
if (width != null && width.matches("\\d+")) {
|
||||
col.put("width", Integer.parseInt(width));
|
||||
}
|
||||
// 金额列 → number 类型 + 千分位(报表迁移方案 A 类口径)
|
||||
if ("true".equals(f.attributeValue("ismoney"))) {
|
||||
col.put("type", "number");
|
||||
col.put("precision", 2);
|
||||
col.put("prefix", "");
|
||||
result.note("display@field " + name + " ismoney=true → 列 type=number(precision=2,千分位)");
|
||||
}
|
||||
// 对齐
|
||||
String align = f.attributeValue("horizontalalignment");
|
||||
if ("2".equals(align)) {
|
||||
col.put("className", "text-right");
|
||||
} else if ("1".equals(align)) {
|
||||
col.put("className", "text-center");
|
||||
}
|
||||
if ("true".equals(f.attributeValue("hidden"))) {
|
||||
col.put("toggled", false);
|
||||
result.note("display@field " + name + " hidden=true → columns-toggler 默认隐藏");
|
||||
}
|
||||
columns.add(col);
|
||||
}
|
||||
return columns;
|
||||
}
|
||||
|
||||
/** search/field → filter 表单(uitype 映射经 UiTypeMapper 统一)。 */
|
||||
private Map<String, Object> buildSearchFilter(Element search, ConversionResult result) {
|
||||
if (search == null || search.elements("field").isEmpty()) {
|
||||
return null;
|
||||
}
|
||||
List<Map<String, Object>> items = new ArrayList<>();
|
||||
for (Element f : search.elements("field")) {
|
||||
items.add(UiTypeMapper.mapField(f, result, "search"));
|
||||
}
|
||||
Map<String, Object> filter = new LinkedHashMap<>();
|
||||
filter.put("title", "查询");
|
||||
filter.put("body", items);
|
||||
noteScript(search, "search", result);
|
||||
return filter;
|
||||
}
|
||||
|
||||
/** crud 的 button 可挂 crud 下,也可挂 display 下;统一收集。 */
|
||||
private List<Element> collectButtons(Element crud) {
|
||||
List<Element> buttons = new ArrayList<>(crud.elements("button"));
|
||||
Element display = crud.element("display");
|
||||
if (display != null) {
|
||||
buttons.addAll(display.elements("button"));
|
||||
}
|
||||
return buttons;
|
||||
}
|
||||
|
||||
private List<Object> buildToolbar(List<Element> buttons, String table, ConversionResult result) {
|
||||
List<Object> toolbar = new ArrayList<>();
|
||||
toolbar.add("bulkActions");
|
||||
for (Element b : buttons) {
|
||||
if ("false".equals(b.attributeValue("isshow"))) {
|
||||
continue;
|
||||
}
|
||||
String btnType = b.attributeValue("type", "");
|
||||
Map<String, Object> btn = new LinkedHashMap<>();
|
||||
btn.put("type", "button");
|
||||
btn.put("label", UiTypeMapper.firstNonBlank(b.attributeValue("name"), b.attributeValue("id"), btnType));
|
||||
switch (btnType) {
|
||||
case "insert" -> {
|
||||
btn.put("level", "primary");
|
||||
btn.put("actionType", "dialog");
|
||||
Map<String, Object> dlg = new LinkedHashMap<>();
|
||||
dlg.put("type", "dialog");
|
||||
dlg.put("title", b.attributeValue("name", "新增"));
|
||||
dlg.put("body", Map.of("type", "tpl",
|
||||
"tpl", "表单页(pageid=" + b.attributeValue("pageid", "") + ")待 EDITFORM 模板联动"));
|
||||
btn.put("dialog", dlg);
|
||||
result.note("button[insert] " + b.attributeValue("name") + " → dialog 占位(指向 pageid="
|
||||
+ b.attributeValue("pageid", "") + ",需 EDITFORM 转换器联动)");
|
||||
}
|
||||
case "delete" -> {
|
||||
btn.put("level", "danger");
|
||||
btn.put("actionType", "ajax");
|
||||
btn.put("confirmText", UiTypeMapper.firstNonBlank(b.attributeValue("showmsg"), "确认删除选中记录?"));
|
||||
btn.put("api", "delete:/api/entity/" + table + "/${ids}");
|
||||
result.note("button[delete] → ajax DELETE /api/entity/" + table + "/${ids}(REST 端点待实现)");
|
||||
}
|
||||
case "update" -> {
|
||||
btn.put("actionType", "dialog");
|
||||
result.note("button[update] " + b.attributeValue("name") + " → 编辑 dialog 占位(需 EDITFORM 联动)");
|
||||
}
|
||||
default -> result.note("button[" + btnType + "] " + b.attributeValue("name") + " → 普通按钮占位");
|
||||
}
|
||||
toolbar.add(btn);
|
||||
}
|
||||
toolbar.add("pagination");
|
||||
return toolbar;
|
||||
}
|
||||
|
||||
private String listApi(Element crud, String table) {
|
||||
Element display = crud.element("display");
|
||||
String selectservice = crud.attributeValue("selectservice",
|
||||
display != null ? display.attributeValue("selectservice") : null);
|
||||
if (selectservice != null && !selectservice.isBlank()) {
|
||||
return "/api/flow/" + selectservice + "?page=${page}&perPage=${perPage}";
|
||||
}
|
||||
return "/api/entity/" + table + "/list?page=${page}&perPage=${perPage}";
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// form(EDITFORM 表单页)—— 字段取自 pageid 指向的 view_page
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
private Map<String, Object> convertForm(Element form, ConversionResult result,
|
||||
Function<String, String> pageResolver) throws Exception {
|
||||
String entityId = form.attributeValue("entityid", "");
|
||||
String table = resolveTableName(entityId, result);
|
||||
String pageId = form.attributeValue("pageid", "");
|
||||
|
||||
List<Map<String, Object>> formItems = new ArrayList<>();
|
||||
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");
|
||||
if (fields != null) {
|
||||
for (Element f : fields.elements("field")) {
|
||||
formItems.add(UiTypeMapper.mapField(f, result, "editform"));
|
||||
}
|
||||
result.note("form@pageid=" + pageId + " → 解析 view_page 取得 " + formItems.size() + " 字段");
|
||||
}
|
||||
// HTML <layout> 自定义表格版式无法直接平移到 amis flex,标注降级
|
||||
if (pageDoc.getRootElement().element("layout") != null) {
|
||||
result.degrade("form 含 HTML <layout> 自定义表格版式 → amis 默认纵向布局替代,版式需人工核对");
|
||||
}
|
||||
} else {
|
||||
result.degrade("form@pageid=" + pageId + " 无法解析 view_page(缺解析器/页面不存在)→ 空表单壳");
|
||||
}
|
||||
|
||||
// method → form actions
|
||||
List<Object> actions = new ArrayList<>();
|
||||
for (Element m : form.elements("method")) {
|
||||
String mname = m.attributeValue("name");
|
||||
if (mname == null) {
|
||||
continue;
|
||||
}
|
||||
Map<String, Object> btn = new LinkedHashMap<>();
|
||||
btn.put("type", "button");
|
||||
btn.put("label", mname);
|
||||
btn.put("actionType", "submit");
|
||||
String svc = m.attributeValue("servicename", "");
|
||||
if (!svc.isBlank()) {
|
||||
result.note("form@method " + mname + "(servicename=" + svc + ") → submit → /api/flow/" + svc);
|
||||
}
|
||||
actions.add(btn);
|
||||
}
|
||||
noteFormScripts(form, result);
|
||||
|
||||
Map<String, Object> formSchema = new LinkedHashMap<>();
|
||||
formSchema.put("type", "form");
|
||||
formSchema.put("title", "");
|
||||
formSchema.put("api", "/api/entity/" + table + "/save");
|
||||
formSchema.put("body", formItems);
|
||||
if (!actions.isEmpty()) {
|
||||
formSchema.put("actions", actions);
|
||||
}
|
||||
return page("", formSchema);
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// tree(树 / 树+grid)
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
private Map<String, Object> convertTree(Element tree, ConversionResult result) {
|
||||
// type=4:树+grid 引用式(<treetemplate ref/> + <gridtemplate ref/>)
|
||||
Element treeTemplate = tree.element("treetemplate");
|
||||
Element gridTemplate = tree.element("gridtemplate");
|
||||
if (treeTemplate != null || gridTemplate != null) {
|
||||
return convertTreeGrid(tree, treeTemplate, gridTemplate, result);
|
||||
}
|
||||
|
||||
// type=3:声明式树(含 <node entityid selectservice>)
|
||||
Element node = tree.element("node");
|
||||
Map<String, Object> treeSchema = new LinkedHashMap<>();
|
||||
treeSchema.put("type", "input-tree");
|
||||
treeSchema.put("name", "tree");
|
||||
treeSchema.put("multiple", false);
|
||||
if (node != null) {
|
||||
String svc = node.attributeValue("selectservice", "");
|
||||
if (!svc.isBlank()) {
|
||||
treeSchema.put("source", "/api/flow/" + svc);
|
||||
result.note("tree@node selectservice=" + svc + " → input-tree source /api/flow/" + svc);
|
||||
}
|
||||
String entityId = node.attributeValue("entityid", "");
|
||||
if (!entityId.isBlank()) {
|
||||
resolveTableName(entityId, result);
|
||||
}
|
||||
if (node.element("nextnodes") != null && !node.element("nextnodes").elements().isEmpty()) {
|
||||
result.note("tree@node 含 nextnodes 多级 → amis input-tree 懒加载(deferApi 待补)");
|
||||
}
|
||||
// 树节点 buttons(增删改保存)无法直接平移到 input-tree,标注降级
|
||||
if (node.element("buttons") != null && !node.element("buttons").elements().isEmpty()) {
|
||||
result.degrade("tree@node 含 buttons(增删改保存) → input-tree 不原生支持节点级按钮,需自定义工具栏");
|
||||
}
|
||||
} else {
|
||||
result.degrade("tree 无 <node> 声明 → 空树壳");
|
||||
}
|
||||
String rootName = tree.attributeValue("rootname");
|
||||
return page(rootName != null ? rootName : "树", treeSchema);
|
||||
}
|
||||
|
||||
private Map<String, Object> convertTreeGrid(Element tree, Element treeTemplate, Element gridTemplate,
|
||||
ConversionResult result) {
|
||||
Map<String, Object> treeSchema = new LinkedHashMap<>();
|
||||
treeSchema.put("type", "input-tree");
|
||||
treeSchema.put("name", "tree");
|
||||
if (treeTemplate != null) {
|
||||
String ref = treeTemplate.attributeValue("ref", "");
|
||||
treeSchema.put("source", "/api/template/" + ref + "/tree");
|
||||
result.degrade("tree+grid: treetemplate ref=" + ref + " → 跨模板引用,树数据源 /api/template 待联动");
|
||||
}
|
||||
Map<String, Object> gridSchema = new LinkedHashMap<>();
|
||||
gridSchema.put("type", "crud");
|
||||
if (gridTemplate != null) {
|
||||
String ref = gridTemplate.attributeValue("ref", "");
|
||||
String rcol = gridTemplate.attributeValue("rcolumnname", "");
|
||||
gridSchema.put("api", "/api/template/" + ref + "/list?" + rcol + "=${tree}");
|
||||
result.degrade("tree+grid: gridtemplate ref=" + ref + "(rcolumn=" + rcol
|
||||
+ ") → 跨模板引用,右侧列表数据源待联动");
|
||||
}
|
||||
gridSchema.put("columns", new ArrayList<>());
|
||||
|
||||
Map<String, Object> hbox = new LinkedHashMap<>();
|
||||
hbox.put("type", "flex");
|
||||
hbox.put("items", List.of(
|
||||
Map.of("md", 3, "body", treeSchema),
|
||||
Map.of("md", 9, "body", gridSchema)));
|
||||
return page("树+列表", hbox);
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// report(A 类表格式报表)—— 报表迁移方案口径
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
private Map<String, Object> convertReport(Element report, ConversionResult result) {
|
||||
String title = UiTypeMapper.firstNonBlank(report.attributeValue("title"),
|
||||
attrOf(report.element("search"), "reporttitle"), "报表");
|
||||
String entityId = report.attributeValue("entityid", "");
|
||||
resolveTableName(entityId, result);
|
||||
|
||||
// display → columns(含 ismoney/issummer 合计列)
|
||||
Element display = report.element("display");
|
||||
List<Map<String, Object>> columns = display != null ? buildColumns(display, result) : new ArrayList<>();
|
||||
|
||||
// 合计列(issummer=true)→ crud footer 合计行 / 列 summary
|
||||
List<String> sumCols = new ArrayList<>();
|
||||
if (display != null) {
|
||||
for (Element f : display.elements("field")) {
|
||||
if ("true".equals(f.attributeValue("issummer"))) {
|
||||
sumCols.add(f.attributeValue("name"));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// search → filter(报表查询参数),selectservice → api
|
||||
Element search = report.element("search");
|
||||
Map<String, Object> filter = buildSearchFilter(search, result);
|
||||
String selectservice = attrOf(search, "selectservice");
|
||||
|
||||
Map<String, Object> crudSchema = new LinkedHashMap<>();
|
||||
crudSchema.put("type", "crud");
|
||||
if (selectservice != null && !selectservice.isBlank()) {
|
||||
crudSchema.put("api", "/api/flow/" + selectservice + "?page=${page}&perPage=${perPage}");
|
||||
result.note("report@search selectservice=" + selectservice + " → crud api /api/flow/" + selectservice
|
||||
+ "(服务流 REST 化,报表迁移方案 D 节)");
|
||||
} else {
|
||||
crudSchema.put("api", "/api/report/" + entityId + "/list");
|
||||
result.degrade("report 无 selectservice → 兜底 api /api/report,数据源待补");
|
||||
}
|
||||
crudSchema.put("syncLocation", false);
|
||||
if (filter != null) {
|
||||
crudSchema.put("filter", filter);
|
||||
}
|
||||
crudSchema.put("columns", columns);
|
||||
if (!sumCols.isEmpty()) {
|
||||
// amis crud footer 合计行:footerToolbar + 列上 summary 由后端返回,这里登记口径
|
||||
Map<String, Object> affix = new LinkedHashMap<>();
|
||||
affix.put("type", "static");
|
||||
crudSchema.put("affixHeader", false);
|
||||
crudSchema.put("footable", false);
|
||||
result.note("report 合计列 issummer=true: " + String.join(",", sumCols)
|
||||
+ " → crud 合计行(amis summaryFields,合计值由 /api/flow 返回 totals 字段)");
|
||||
crudSchema.put("summaryFields", sumCols);
|
||||
}
|
||||
|
||||
// 图表报表(ischart=true):本批不平移 ECharts option,标注降级(报表迁移方案 B 类,单列)
|
||||
if ("true".equals(attrOf(search, "ischart"))) {
|
||||
result.degrade("report ischart=true → 图表类报表(B 类),ECharts option 平移单列处置,本批转为表格降级");
|
||||
}
|
||||
// JOR 套打版式(reportfile CDATA 非空)→ 不迁移引擎(报表迁移方案 C 类)
|
||||
Element reportfile = report.element("reportfile");
|
||||
if (reportfile != null && !reportfile.getTextTrim().isBlank()) {
|
||||
result.degrade("report 含 reportfile(JOR 套打版式 " + reportfile.getTextTrim().length()
|
||||
+ " 字符) → C 类不迁移引擎,仅转表格视图(套打另案 univer/Web 打印)");
|
||||
}
|
||||
noteScripts(report, result);
|
||||
|
||||
return page(title, crudSchema);
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// group(分组容器)—— 子模板跨引用
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
private Map<String, Object> convertGroup(Element group, ConversionResult result) {
|
||||
List<Map<String, Object>> tabs = new ArrayList<>();
|
||||
for (Element t : group.elements("template")) {
|
||||
String tempId = t.attributeValue("tempid", "");
|
||||
String name = t.attributeValue("name", tempId);
|
||||
Map<String, Object> tab = new LinkedHashMap<>();
|
||||
tab.put("title", name);
|
||||
tab.put("body", Map.of("type", "tpl",
|
||||
"tpl", "子模板(tempid=" + tempId + ")待跨模板联动加载"));
|
||||
tabs.add(tab);
|
||||
result.note("group@template " + name + "(tempid=" + tempId + ") → tab 占位(子模板跨引用)");
|
||||
}
|
||||
result.degrade("group 分组容器仅转 tabs 壳 → 各 tab 子模板需跨模板联动加载(本批不联动)");
|
||||
Map<String, Object> tabsSchema = new LinkedHashMap<>();
|
||||
tabsSchema.put("type", "tabs");
|
||||
tabsSchema.put("tabs", tabs);
|
||||
return page("分组", tabsSchema);
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
// 公共工具
|
||||
// ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
private static Map<String, Object> page(String title, Object body) {
|
||||
Map<String, Object> page = new LinkedHashMap<>();
|
||||
page.put("type", "page");
|
||||
page.put("title", title);
|
||||
page.put("body", crudSchema);
|
||||
page.put("body", body);
|
||||
return page;
|
||||
}
|
||||
|
||||
private String resolveTableName(String entityId) {
|
||||
private static String attrOf(Element el, String attr) {
|
||||
return el == null ? null : el.attributeValue(attr);
|
||||
}
|
||||
|
||||
/** dom4j 取脚本必须用 getText()(迁移手册 §5.3:getTextTrim 会压扁 Groovy 换行)。 */
|
||||
private static void noteScript(Element el, String origin, ConversionResult result) {
|
||||
String script = el.attributeValue("script");
|
||||
if (script != null && !script.isBlank()) {
|
||||
result.note(origin + "@script 存在(" + script.length() + " 字符) → 归入脚本分桶,本转换器跳过");
|
||||
}
|
||||
}
|
||||
|
||||
private static void noteScripts(Element parent, ConversionResult result) {
|
||||
Element scripts = parent.element("scripts");
|
||||
if (scripts != null) {
|
||||
for (Element s : scripts.elements("script")) {
|
||||
String body = s.getText();
|
||||
if (body != null && !body.isBlank()) {
|
||||
result.note("scripts@" + s.attributeValue("name", "?") + " 存在(" + body.length()
|
||||
+ " 字符,getText 保留换行) → 脚本分桶处理");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private static void noteFormScripts(Element form, ConversionResult result) {
|
||||
for (Element s : form.elements("script")) {
|
||||
String body = s.getText();
|
||||
if (body != null && !body.isBlank()) {
|
||||
result.note("form@script " + s.attributeValue("name", "?") + " 存在(" + body.length()
|
||||
+ " 字符,getText 保留换行) → 脚本分桶处理");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private static String safeMsg(Exception e) {
|
||||
return e.getMessage() == null ? "" : e.getMessage();
|
||||
}
|
||||
|
||||
/** entityid → 物理表名;解析失败(孤儿模板)登记台账并返回占位,不抛异常(迁移手册 §7.4)。 */
|
||||
private String resolveTableName(String entityId, ConversionResult result) {
|
||||
if (entityId == null || entityId.isBlank()) {
|
||||
result.degrade("entityid 为空 → 无法解析实体表(孤儿模板候选)");
|
||||
return "UNKNOWN_ENTITY";
|
||||
}
|
||||
try {
|
||||
String table = jdbcTemplate.queryForObject(
|
||||
"SELECT TABLENAME FROM SYS_ENTITY WHERE SYS_ENTITY_ID=?", String.class, entityId);
|
||||
result.note("entityid=" + entityId + " → 实体表 " + table + "(经 SYS_ENTITY 解析)");
|
||||
return table;
|
||||
} catch (Exception e) {
|
||||
result.degrade("entityid=" + entityId + " 在 SYS_ENTITY 无对应实体 → 孤儿模板(§7.4),表名占位");
|
||||
return "ORPHAN_" + entityId.replaceAll("[^A-Za-z0-9_]", "_");
|
||||
}
|
||||
}
|
||||
|
||||
/** view_page.xml 解析器(form EDITFORM 用)。 */
|
||||
private String loadPageXml(String pageId) {
|
||||
try {
|
||||
return jdbcTemplate.queryForObject(
|
||||
"SELECT TABLENAME FROM SYS_ENTITY WHERE SYS_ENTITY_ID=?", String.class, entityId);
|
||||
"SELECT xml::text FROM VIEW_PAGE WHERE VIEW_PAGE_ID=? AND xml IS NOT NULL",
|
||||
String.class, pageId);
|
||||
} catch (Exception e) {
|
||||
return "UNKNOWN_" + entityId;
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,196 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
import org.dom4j.Document;
|
||||
import org.dom4j.DocumentHelper;
|
||||
import org.dom4j.Element;
|
||||
|
||||
/**
|
||||
* 旧引擎 {@code <field uitype="...">} → amis 表单控件的统一映射。
|
||||
*
|
||||
* <p>被「查询过滤表单(search)」「表单页(EDITFORM / form 的 page.fields)」「报表查询参数(report.search)」
|
||||
* 三处共享——映射规则唯一来源,避免三处各写一份漂移。客户库实测 uitype 全集(按出现频次):
|
||||
* TextField / SelectDialog / ComboBox / DoublePopupDateField / NumberField /
|
||||
* PopupDateField / MultiSelectDialog / CheckBox / TextArea。
|
||||
*
|
||||
* <p>每命中一处都通过 {@link ConversionResult#note} 登记映射台账;未知 uitype 走
|
||||
* {@link ConversionResult#degrade} 降级为 input-text 并标注。
|
||||
*/
|
||||
final class UiTypeMapper {
|
||||
|
||||
private UiTypeMapper() {
|
||||
}
|
||||
|
||||
/**
|
||||
* 把一个 {@code <field>} 元素映射为一个 amis 表单项 Map。
|
||||
*
|
||||
* @param f 字段元素(含 name/label/uitype/comboboxid 等属性)
|
||||
* @param result 转换结果(登记映射台账 / 降级标注)
|
||||
* @param origin 来源标签("search" / "editform" / "report.search"),写进台账便于定位
|
||||
* @return amis 表单项
|
||||
*/
|
||||
static Map<String, Object> mapField(Element f, ConversionResult result, String origin) {
|
||||
String name = f.attributeValue("name", "");
|
||||
String uitype = f.attributeValue("uitype", "TextField");
|
||||
// label 优先用 label 属性,回退 text(display 段用 text)、再回退 name
|
||||
String label = firstNonBlank(f.attributeValue("label"), f.attributeValue("text"), name);
|
||||
|
||||
Map<String, Object> item = new LinkedHashMap<>();
|
||||
item.put("name", name);
|
||||
item.put("label", label);
|
||||
|
||||
boolean required = "true".equals(f.attributeValue("required"));
|
||||
if (required) {
|
||||
item.put("required", true);
|
||||
}
|
||||
if ("true".equals(f.attributeValue("readonly"))) {
|
||||
item.put("disabled", true);
|
||||
}
|
||||
if ("true".equals(f.attributeValue("hidden"))) {
|
||||
item.put("hidden", true);
|
||||
}
|
||||
|
||||
switch (uitype) {
|
||||
case "TextField" -> {
|
||||
item.put("type", "input-text");
|
||||
applyLength(item, f);
|
||||
}
|
||||
case "TextArea" -> item.put("type", "textarea");
|
||||
case "NumberField" -> {
|
||||
item.put("type", "input-number");
|
||||
String mdec = f.attributeValue("mdec");
|
||||
if (mdec != null && !mdec.isBlank()) {
|
||||
try {
|
||||
item.put("precision", Integer.parseInt(mdec));
|
||||
} catch (NumberFormatException ignore) {
|
||||
// mdec 非数值 → 忽略精度,控件本身已成立
|
||||
}
|
||||
}
|
||||
result.note(origin + "@field " + name + " uitype=NumberField → input-number(precision=" + mdec + ")");
|
||||
}
|
||||
case "CheckBox" -> {
|
||||
item.put("type", "checkbox");
|
||||
result.note(origin + "@field " + name + " uitype=CheckBox → checkbox");
|
||||
}
|
||||
case "EditGrid", "FormEditGrid" -> {
|
||||
// 表单内嵌可编辑子表(主子表的子表侧)→ amis input-table;
|
||||
// 子列取自 <editgridtemplate> CDATA 内 <component><editgrid><field>。
|
||||
item.put("type", "input-table");
|
||||
item.put("addable", !"false".equals(f.attributeValue("showaddbutton")));
|
||||
item.put("removable", !"false".equals(f.attributeValue("showdeletebutton")));
|
||||
item.put("columns", buildEditGridColumns(f, result, name));
|
||||
result.degrade(origin + "@field " + name + " uitype=" + uitype
|
||||
+ " → input-table 子表(主子表子表侧,列取自 editgridtemplate;保存联动 updateSubTable 待后端)");
|
||||
}
|
||||
case "ComboBox" -> {
|
||||
item.put("type", "select");
|
||||
item.put("clearable", true);
|
||||
String dict = firstNonBlank(f.attributeValue("comboboxid"),
|
||||
f.attributeValue("comboboxitemservice"), "");
|
||||
if (!dict.isBlank()) {
|
||||
item.put("source", "/api/poc/dict/" + dict);
|
||||
result.note(origin + "@field " + name + " uitype=ComboBox(comboboxid=" + dict
|
||||
+ ") → select + source 字典接口(接口待实现)");
|
||||
} else {
|
||||
result.note(origin + "@field " + name + " uitype=ComboBox(无字典源) → 空 select");
|
||||
}
|
||||
}
|
||||
case "PopupDateField" -> {
|
||||
String format = f.attributeValue("format", "");
|
||||
boolean hasTime = format.contains("H") || format.contains("m");
|
||||
item.put("type", hasTime ? "input-datetime" : "input-date");
|
||||
result.note(origin + "@field " + name + " uitype=PopupDateField(format=" + format + ") → "
|
||||
+ (hasTime ? "input-datetime" : "input-date"));
|
||||
}
|
||||
case "DoublePopupDateField" -> {
|
||||
// 双日期 = 区间选择
|
||||
String format = f.attributeValue("format", "");
|
||||
boolean hasTime = format.contains("H") || format.contains("m");
|
||||
item.put("type", hasTime ? "input-datetime-range" : "input-date-range");
|
||||
result.note(origin + "@field " + name + " uitype=DoublePopupDateField → "
|
||||
+ (hasTime ? "input-datetime-range" : "input-date-range") + "(区间)");
|
||||
}
|
||||
case "SelectDialog" -> {
|
||||
// 旧引擎弹窗选择器 → amis select + 远程 source(弹窗数据由 dialogid 指向的模板提供,跨模板引用本批未联动)。
|
||||
// 注:不用 amis picker——picker 需内嵌 pickerSchema(CRUD),且 6.13 schema 未把 picker 纳入
|
||||
// 表单项 oneOf,闸一会拒(手册 §8.2 schema 严格性);select+source 双闸皆过,是更保真的降级。
|
||||
item.put("type", "select");
|
||||
item.put("clearable", true);
|
||||
item.put("source", "/api/picker/" + f.attributeValue("dialogid", "") + "/list");
|
||||
result.degrade(origin + "@field " + name + " uitype=SelectDialog(dialogid="
|
||||
+ f.attributeValue("dialogid", "") + ") → select+source 占位(弹窗数据源 /api/picker,需后端实现)");
|
||||
}
|
||||
case "MultiSelectDialog" -> {
|
||||
item.put("type", "select");
|
||||
item.put("multiple", true);
|
||||
item.put("clearable", true);
|
||||
item.put("source", "/api/picker/" + f.attributeValue("dialogid", "") + "/list");
|
||||
result.degrade(origin + "@field " + name + " uitype=MultiSelectDialog(dialogid="
|
||||
+ f.attributeValue("dialogid", "") + ") → select(multiple)+source 占位(数据源待实现)");
|
||||
}
|
||||
default -> {
|
||||
item.put("type", "input-text");
|
||||
result.degrade(origin + "@field " + name + " uitype=" + uitype
|
||||
+ " → 暂映射 input-text(映射表待补该控件)");
|
||||
}
|
||||
}
|
||||
return item;
|
||||
}
|
||||
|
||||
/** 解析 EditGrid 的 {@code <editgridtemplate>} CDATA,把内嵌 editgrid 字段转成 input-table 列。 */
|
||||
private static List<Map<String, Object>> buildEditGridColumns(Element f, ConversionResult result, String name) {
|
||||
List<Map<String, Object>> columns = new ArrayList<>();
|
||||
Element tpl = f.element("editgridtemplate");
|
||||
String tplXml = tpl != null ? tpl.getText() : null;
|
||||
if (tplXml == null || tplXml.isBlank()) {
|
||||
result.note("editgrid " + name + " 无 editgridtemplate → 空子表列");
|
||||
return columns;
|
||||
}
|
||||
try {
|
||||
Document doc = DocumentHelper.parseText(tplXml.trim());
|
||||
Element editgrid = doc.getRootElement().element("editgrid");
|
||||
if (editgrid == null) {
|
||||
return columns;
|
||||
}
|
||||
for (Element sub : editgrid.elements("field")) {
|
||||
if ("true".equals(sub.attributeValue("hidden"))) {
|
||||
continue;
|
||||
}
|
||||
// 子列复用同一套 uitype 映射,但落到 quickEdit 语义;这里取最小可渲染列
|
||||
Map<String, Object> col = new LinkedHashMap<>();
|
||||
col.put("name", sub.attributeValue("name", ""));
|
||||
col.put("label", firstNonBlank(sub.attributeValue("label"), sub.attributeValue("name")));
|
||||
col.put("type", "input-text"); // 子表列统一可编辑文本;精细控件由 quickEdit 后续细化
|
||||
columns.add(col);
|
||||
}
|
||||
result.note("editgrid " + name + " → input-table " + columns.size() + " 列(取自 editgridtemplate)");
|
||||
} catch (Exception e) {
|
||||
result.note("editgrid " + name + " editgridtemplate 解析失败: " + e.getClass().getSimpleName());
|
||||
}
|
||||
return columns;
|
||||
}
|
||||
|
||||
private static void applyLength(Map<String, Object> item, Element f) {
|
||||
String max = f.attributeValue("maxlength");
|
||||
if (max != null && !max.isBlank()) {
|
||||
try {
|
||||
item.put("maxLength", Integer.parseInt(max));
|
||||
} catch (NumberFormatException ignore) {
|
||||
// 忽略非数值长度约束
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
static String firstNonBlank(String... candidates) {
|
||||
for (String c : candidates) {
|
||||
if (c != null && !c.isBlank()) {
|
||||
return c;
|
||||
}
|
||||
}
|
||||
return "";
|
||||
}
|
||||
}
|
||||
34161
platform-converter/src/main/resources/amis-schema-6.13.0.json
Normal file
34161
platform-converter/src/main/resources/amis-schema-6.13.0.json
Normal file
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,72 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
import static org.mockito.ArgumentMatchers.any;
|
||||
import static org.mockito.ArgumentMatchers.eq;
|
||||
import static org.mockito.Mockito.lenient;
|
||||
import static org.mockito.Mockito.mock;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.springframework.jdbc.core.JdbcTemplate;
|
||||
|
||||
/**
|
||||
* 闸一 {@link SchemaGate} 宽松语义校验 + CLI 辅助逻辑(URL 守门 / 原因归类)单测。
|
||||
*/
|
||||
class SchemaGateAndCliTest {
|
||||
|
||||
@Test
|
||||
void schemaGate_转换后的crud过闸() {
|
||||
JdbcTemplate jdbc = mock(JdbcTemplate.class);
|
||||
lenient().when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
|
||||
.thenReturn("PM_DEMO");
|
||||
TemplateToAmisConverter converter = new TemplateToAmisConverter(jdbc);
|
||||
String xml = "<crud title='角色维护' entityid='e1'><display selectservice='SVC'>"
|
||||
+ "<field name='NAME' text='名称' width='100'/></display>"
|
||||
+ "<search><field name='NAME' label='名称' uitype='TextField'/></search></crud>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), id -> null);
|
||||
|
||||
SchemaGate gate = new SchemaGate();
|
||||
List<String> errors = gate.validate(r.getSchema());
|
||||
assertTrue(errors.isEmpty(), () -> "闸一应通过,但有错误: " + errors);
|
||||
}
|
||||
|
||||
@Test
|
||||
void schemaGate_明显非法schema被拒() {
|
||||
SchemaGate gate = new SchemaGate();
|
||||
// page.type 必须是字符串"page",这里给个数组型 body 顶层缺 type → 至少应报错
|
||||
Map<String, Object> bad = Map.of("type", 12345);
|
||||
List<String> errors = gate.validate(bad);
|
||||
assertTrue(!errors.isEmpty(), "数值 type 应被 schema 拒绝");
|
||||
}
|
||||
|
||||
@Test
|
||||
void guardUrl_拒绝ceshi库() {
|
||||
IllegalArgumentException ex = assertThrows(IllegalArgumentException.class,
|
||||
() -> BatchConvertCli.guardUrl("jdbc:postgresql://192.168.20.68:5435/ceshi?currentSchema=eip3"));
|
||||
assertTrue(ex.getMessage().contains("ceshi"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void guardUrl_允许postgres库() {
|
||||
BatchConvertCli.guardUrl("jdbc:postgresql://192.168.20.68:5435/postgres?currentSchema=eip3");
|
||||
}
|
||||
|
||||
@Test
|
||||
void bucket_原因归类三桶() {
|
||||
assertEquals("孤儿模板", BatchConvertCli.bucket("entityid=x 在 SYS_ENTITY 无对应实体 → 孤儿模板"));
|
||||
assertEquals("模板数据问题", BatchConvertCli.bucket("XML 解析失败: DocumentException"));
|
||||
assertEquals("转换器缺陷", BatchConvertCli.bucket("uitype=SelectDialog → picker 占位"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void classifyReasons_无降级为空() {
|
||||
ConversionResult r = new ConversionResult("crud", new ArrayList<>());
|
||||
assertEquals("", BatchConvertCli.classifyReasons(r));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,308 @@
|
||||
package com.eip4.platform.converter;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||
import static org.junit.jupiter.api.Assertions.assertNull;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
import static org.mockito.ArgumentMatchers.any;
|
||||
import static org.mockito.ArgumentMatchers.eq;
|
||||
import static org.mockito.Mockito.lenient;
|
||||
import static org.mockito.Mockito.mock;
|
||||
import static org.mockito.Mockito.when;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.function.Function;
|
||||
|
||||
import org.junit.jupiter.api.BeforeEach;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.springframework.jdbc.core.JdbcTemplate;
|
||||
|
||||
/**
|
||||
* 各段转换规则单测(P4 转换器扩展)。JdbcTemplate 用 Mockito 桩,离线运行——
|
||||
* SYS_ENTITY 解析返回固定表名,孤儿场景抛异常验证旁路。
|
||||
*/
|
||||
class TemplateToAmisConverterTest {
|
||||
|
||||
private TemplateToAmisConverter converter;
|
||||
private Function<String, String> noPage;
|
||||
|
||||
@BeforeEach
|
||||
void setUp() {
|
||||
JdbcTemplate jdbc = mock(JdbcTemplate.class);
|
||||
// 默认实体解析成功
|
||||
lenient().when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
|
||||
.thenReturn("PM_DEMO");
|
||||
converter = new TemplateToAmisConverter(jdbc);
|
||||
noPage = pageId -> null;
|
||||
}
|
||||
|
||||
@SuppressWarnings("unchecked")
|
||||
private static Map<String, Object> body(Map<String, Object> page) {
|
||||
return (Map<String, Object>) page.get("body");
|
||||
}
|
||||
|
||||
// ── crud ────────────────────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void crud_display字段转列_含金额与隐藏() {
|
||||
String xml = "<crud title='登录历史' entityid='e1'>"
|
||||
+ "<display selectservice='SYS_LOGIN_SEARCH'>"
|
||||
+ "<field name='SYS_X_ID' text='主键' width='200' hidden='true' iskeycolumn='true'/>"
|
||||
+ "<field name='AMT' text='金额' width='150' ismoney='true' horizontalalignment='2'/>"
|
||||
+ "</display></crud>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals("crud", r.getRootElement());
|
||||
assertEquals(ConversionGrade.SUCCESS, r.getGrade());
|
||||
Map<String, Object> crud = body(r.getSchema());
|
||||
List<Map<String, Object>> cols = (List<Map<String, Object>>) crud.get("columns");
|
||||
assertEquals(2, cols.size());
|
||||
assertEquals(false, cols.get(0).get("toggled")); // 隐藏列默认折叠
|
||||
assertEquals("number", cols.get(1).get("type")); // 金额列 number
|
||||
assertEquals("text-right", cols.get(1).get("className"));
|
||||
// selectservice → api 走 /api/flow
|
||||
assertTrue(((String) crud.get("api")).startsWith("/api/flow/SYS_LOGIN_SEARCH"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void crud_search字段映射各类uitype() {
|
||||
String xml = "<crud entityid='e1'><display/>"
|
||||
+ "<search>"
|
||||
+ "<field name='A' label='文本' uitype='TextField' maxlength='50'/>"
|
||||
+ "<field name='B' label='字典' uitype='ComboBox' comboboxid='WFSTATUS'/>"
|
||||
+ "<field name='C' label='日期' uitype='PopupDateField' format='yyyy-MM-dd'/>"
|
||||
+ "<field name='D' label='区间' uitype='DoublePopupDateField' format='yyyy-MM-dd HH:mm'/>"
|
||||
+ "<field name='E' label='数值' uitype='NumberField' mdec='2'/>"
|
||||
+ "</search></crud>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
Map<String, Object> crud = body(r.getSchema());
|
||||
Map<String, Object> filter = (Map<String, Object>) crud.get("filter");
|
||||
List<Map<String, Object>> items = (List<Map<String, Object>>) filter.get("body");
|
||||
assertEquals("input-text", items.get(0).get("type"));
|
||||
assertEquals(50, items.get(0).get("maxLength"));
|
||||
assertEquals("select", items.get(1).get("type"));
|
||||
assertEquals("/api/poc/dict/WFSTATUS", items.get(1).get("source"));
|
||||
assertEquals("input-date", items.get(2).get("type"));
|
||||
assertEquals("input-datetime-range", items.get(3).get("type")); // 含时分 → datetime-range
|
||||
assertEquals("input-number", items.get(4).get("type"));
|
||||
assertEquals(2, items.get(4).get("precision"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void crud_selectDialog降级为select() {
|
||||
String xml = "<crud entityid='e1'><display/>"
|
||||
+ "<search><field name='PROJ' label='工程' uitype='SelectDialog' dialogid='d1'/></search></crud>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade()); // 数据源未联动 → 降级
|
||||
Map<String, Object> crud = body(r.getSchema());
|
||||
Map<String, Object> filter = (Map<String, Object>) crud.get("filter");
|
||||
List<Map<String, Object>> items = (List<Map<String, Object>>) filter.get("body");
|
||||
// SelectDialog → select+source(picker 会被闸一拒,见 §8.2)
|
||||
assertEquals("select", items.get(0).get("type"));
|
||||
assertEquals("/api/picker/d1/list", items.get(0).get("source"));
|
||||
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("SelectDialog")));
|
||||
}
|
||||
|
||||
@Test
|
||||
void crud_button删除转ajax() {
|
||||
String xml = "<crud entityid='e1'><display/>"
|
||||
+ "<button type='delete' name='删除' isshow='true' showmsg='确认删除?'>"
|
||||
+ "<method servicename='X_DELETE'/></button></crud>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
Map<String, Object> crud = body(r.getSchema());
|
||||
List<Object> toolbar = (List<Object>) crud.get("headerToolbar");
|
||||
Map<String, Object> btn = (Map<String, Object>) toolbar.get(1);
|
||||
assertEquals("ajax", btn.get("actionType"));
|
||||
assertEquals("确认删除?", btn.get("confirmText"));
|
||||
assertTrue(((String) btn.get("api")).startsWith("delete:/api/entity/"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void crud_isshowFalse按钮跳过() {
|
||||
String xml = "<crud entityid='e1'><display/>"
|
||||
+ "<button type='delete' name='删除' isshow='false'/></crud>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
Map<String, Object> crud = body(r.getSchema());
|
||||
List<Object> toolbar = (List<Object>) crud.get("headerToolbar");
|
||||
// bulkActions + pagination,无删除按钮
|
||||
assertEquals(2, toolbar.size());
|
||||
}
|
||||
|
||||
// ── form (EDITFORM) ──────────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void form_从page解析字段() {
|
||||
String pageXml = "<page entityid='e9'><fields>"
|
||||
+ "<field name='NAME' label='名称' uitype='TextField' required='true'/>"
|
||||
+ "<field name='STATUS' label='状态' uitype='ComboBox' comboboxid='YESNO'/>"
|
||||
+ "</fields></page>";
|
||||
Function<String, String> resolver = id -> "p1".equals(id) ? pageXml : null;
|
||||
String xml = "<form entityid='e1' pageid='p1'>"
|
||||
+ "<method id='m1' name='保存' servicename='X_ADD'/></form>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), resolver);
|
||||
assertEquals("form", r.getRootElement());
|
||||
Map<String, Object> form = body(r.getSchema());
|
||||
assertEquals("form", form.get("type"));
|
||||
List<Map<String, Object>> items = (List<Map<String, Object>>) form.get("body");
|
||||
assertEquals(2, items.size());
|
||||
assertEquals(true, items.get(0).get("required"));
|
||||
assertEquals("select", items.get(1).get("type"));
|
||||
List<Object> actions = (List<Object>) form.get("actions");
|
||||
assertEquals(1, actions.size());
|
||||
}
|
||||
|
||||
@Test
|
||||
void form_editGrid转inputTable子表() {
|
||||
String pageXml = "<page entityid='e9'><fields>"
|
||||
+ "<field name='NAME' label='名称' uitype='TextField'/>"
|
||||
+ "<field name='PAIDS' label='付款记录' uitype='EditGrid' showaddbutton='true' showdeletebutton='false'>"
|
||||
+ "<editgridtemplate><![CDATA[<component><editgrid entityid='c1'>"
|
||||
+ "<field name='SUB_ID' label='主键' uitype='TextField' hidden='true'/>"
|
||||
+ "<field name='MONEY' label='金额' uitype='NumberField'/>"
|
||||
+ "</editgrid></component>]]></editgridtemplate>"
|
||||
+ "</field></fields></page>";
|
||||
Function<String, String> resolver = id -> pageXml;
|
||||
String xml = "<form entityid='e1' pageid='p1'/>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), resolver);
|
||||
Map<String, Object> form = body(r.getSchema());
|
||||
List<Map<String, Object>> items = (List<Map<String, Object>>) form.get("body");
|
||||
Map<String, Object> sub = items.get(1);
|
||||
assertEquals("input-table", sub.get("type"));
|
||||
assertEquals(true, sub.get("addable"));
|
||||
assertEquals(false, sub.get("removable"));
|
||||
List<Map<String, Object>> cols = (List<Map<String, Object>>) sub.get("columns");
|
||||
assertEquals(1, cols.size()); // 隐藏主键列被过滤
|
||||
assertEquals("MONEY", cols.get(0).get("name"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void form_缺页面解析器降级() {
|
||||
String xml = "<form entityid='e1' pageid='p1'><load><method/></load></form>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade());
|
||||
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("view_page")));
|
||||
}
|
||||
|
||||
// ── tree ─────────────────────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void tree_声明式树转inputTree() {
|
||||
String xml = "<tree isshowroot='true' rootname='区间'>"
|
||||
+ "<node entityid='e1' selectservice='X_SEARCH' isroot='true'>"
|
||||
+ "<buttons><button name='添加' type='insert'/></buttons>"
|
||||
+ "<nextnodes/></node></tree>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals("tree", r.getRootElement());
|
||||
Map<String, Object> tree = body(r.getSchema());
|
||||
assertEquals("input-tree", tree.get("type"));
|
||||
assertEquals("/api/flow/X_SEARCH", tree.get("source"));
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade()); // 节点按钮 → 降级
|
||||
}
|
||||
|
||||
@Test
|
||||
void tree_treeGrid引用式() {
|
||||
String xml = "<tree>"
|
||||
+ "<treetemplate ref='t1' entityid='e1'/>"
|
||||
+ "<gridtemplate ref='g1' entityid='e2' rcolumnname='EVENTID'/></tree>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
Map<String, Object> root = body(r.getSchema());
|
||||
assertEquals("flex", root.get("type"));
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade()); // 跨模板引用 → 降级
|
||||
}
|
||||
|
||||
// ── report (A 类) ────────────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void report_合计列与selectservice() {
|
||||
String xml = "<report title='安全费用' entityid='e1'>"
|
||||
+ "<display>"
|
||||
+ "<field name='X_ID' text='主键' width='200' hidden='true'/>"
|
||||
+ "<field name='AMT' text='金额' width='150' ismoney='true' issummer='true' horizontalalignment='2'/>"
|
||||
+ "</display>"
|
||||
+ "<search selectservice='PM_SAFE_SEARCH' reporttitle='安全费用明细'>"
|
||||
+ "<field name='YEAR' label='年份' uitype='NumberField' mdec='0'/></search>"
|
||||
+ "<reportfile></reportfile><scripts/></report>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals("report", r.getRootElement());
|
||||
Map<String, Object> crud = body(r.getSchema());
|
||||
assertEquals("crud", crud.get("type"));
|
||||
assertTrue(((String) crud.get("api")).startsWith("/api/flow/PM_SAFE_SEARCH"));
|
||||
List<String> sum = (List<String>) crud.get("summaryFields");
|
||||
assertEquals(List.of("AMT"), sum);
|
||||
assertEquals("安全费用", r.getSchema().get("title"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void report_jor套打版式降级() {
|
||||
String xml = "<report title='套打' entityid='e1'>"
|
||||
+ "<display><field name='A' text='A'/></display>"
|
||||
+ "<search selectservice='S'/>"
|
||||
+ "<reportfile><![CDATA[<jatools>非空版式定义内容占位非空版式</jatools>]]></reportfile></report>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade());
|
||||
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("JOR")));
|
||||
}
|
||||
|
||||
@Test
|
||||
void report_图表降级() {
|
||||
String xml = "<report title='图表' entityid='e1'>"
|
||||
+ "<display><field name='A' text='A'/></display>"
|
||||
+ "<search ischart='true' selectservice='S'/></report>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade());
|
||||
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("ischart") || d.contains("图表")));
|
||||
}
|
||||
|
||||
// ── group ────────────────────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void group_转tabs占位() {
|
||||
String xml = "<group>"
|
||||
+ "<template tempid='t1' name='已发消息'/>"
|
||||
+ "<template tempid='t2' name='已收消息' defaultshow='true'/></group>";
|
||||
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertEquals("group", r.getRootElement());
|
||||
Map<String, Object> tabs = body(r.getSchema());
|
||||
assertEquals("tabs", tabs.get("type"));
|
||||
assertEquals(2, ((List<?>) tabs.get("tabs")).size());
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade());
|
||||
}
|
||||
|
||||
// ── 旁路与异常 ────────────────────────────────────────────────────────
|
||||
|
||||
@Test
|
||||
void 孤儿模板_entityid解析失败不抛异常() {
|
||||
JdbcTemplate jdbc = mock(JdbcTemplate.class);
|
||||
when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
|
||||
.thenThrow(new RuntimeException("no such entity"));
|
||||
TemplateToAmisConverter c = new TemplateToAmisConverter(jdbc);
|
||||
String xml = "<crud entityid='!!!bad'><display>"
|
||||
+ "<field name='A' text='A'/></display></crud>";
|
||||
ConversionResult r = c.convertGraded(xml, new ArrayList<>(), noPage);
|
||||
assertNotNull(r.getSchema()); // 不抛异常,仍出 schema
|
||||
assertEquals(ConversionGrade.PARTIAL, r.getGrade()); // 孤儿 → 降级
|
||||
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("孤儿")));
|
||||
}
|
||||
|
||||
@Test
|
||||
void 解析失败xml_标记FAILED() {
|
||||
ConversionResult r = converter.convertGraded("<crud><unclosed></crud>", new ArrayList<>(), noPage);
|
||||
assertEquals(ConversionGrade.FAILED, r.getGrade());
|
||||
assertNull(r.getSchema());
|
||||
}
|
||||
|
||||
@Test
|
||||
void 不支持根元素_标记FAILED() {
|
||||
ConversionResult r = converter.convertGraded("<unknown/>", new ArrayList<>(), noPage);
|
||||
assertEquals(ConversionGrade.FAILED, r.getGrade());
|
||||
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("不支持的根元素")));
|
||||
}
|
||||
|
||||
@Test
|
||||
void 兼容入口convert_失败抛异常() {
|
||||
assertFalse(converter.convertGraded("<unknown/>", new ArrayList<>(), noPage).getGrade()
|
||||
== ConversionGrade.SUCCESS);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user