P4-4: picker 选择窗数据源 + page schema 服务化两端点

- PickerController GET /api/picker/{entityOrRef}/list?q&page&perPage:
  契约定稿——dialogid 实为 view_template_id(侦察客户库纠偏,非 SYS_REFERENCE_ID),
  按 view_template根@entityid → ref → 直连实体表名三级解析;全入参过 P1-3 白名单,
  搜索值转义防 LIKE 裸拼注入,行级权限 ctx 三级优先(与 EntityController 同口径);
  返回 amis options/CRUD 双格式。转换器 source 生成零改动(契约对接落后端解析)。
- PageSchemaController GET /api/page/schema/{templateId}:带 ETag/304,404/503;
  与 eip4-web VITE_SCHEMA_SOURCE=backend 联调渲染通过。
- SYS_PAGE_SCHEMA 平台表(bootstrap SQL + 生产 DDL 落 docs,Flyway 引入列 P5);
  SchemaImportCli 把 1489 个转换产物幂等入库(etag=sha-256)。
- 单测 +19(picker 9/schema 7/导入 3),全模块 mvn install + ArchUnit 绿。
- 新坑进迁移手册 §8.7(dialogid=view_template_id)/§8.8(GeneralPO LIKE 裸拼)/§8.9(SYS_PAGE_SCHEMA)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 17:08:59 +08:00
parent 082b439179
commit e49b39f0cf
12 changed files with 1436 additions and 0 deletions

View File

@@ -0,0 +1,214 @@
package com.eip4.platform.metadata.schema;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.SQLException;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Stream;
/**
* 页面 schema 导入 CLI(P4-4):把 platform-converter 的转换产物
* ({@code 转换产物/schema/{view_template_id}.json},1489 个)批量入库 {@code SYS_PAGE_SCHEMA},
* 供 {@code GET /api/page/schema/{templateId}} 在线下发。
*
* <p>幂等:每条 upsert({@code ON CONFLICT (template_id) DO UPDATE}),同模板重导入时
* 仅当内容指纹({@code schema_etag})变化才 +1 版本并刷新;内容未变则版本不动(避免无谓版本膨胀)。
* 建表 DDL 与 {@code bootstrap-page-schema.sql} 同口径,CLI 启动时 {@code CREATE TABLE IF NOT EXISTS}
* 兜底(本地/CI 自举库可能未跑 bootstrap)。
*
* <p>用法:
* <pre>{@code
* java -cp ... com.eip4.platform.metadata.schema.SchemaImportCli \
* "jdbc:postgresql://localhost:5433/eip4m0" zhengwr "" \
* ../platform-converter/转换产物/schema \
* ../platform-converter/转换产物/分级清单.csv
* }</pre>
* 第 4 参为产物 schema 目录,第 5 参(可选)为分级清单 CSV(取模板名称,缺省则 name 留空)。
* <b>导入目标是本地/平台库(可写),不是只读客户库</b>——客户库红线由 BatchConvertCli 守,本 CLI 只写平台表。
*/
public final class SchemaImportCli {
/** 与 bootstrap-page-schema.sql / docs/sql/SYS_PAGE_SCHEMA.sql 完全一致的建表 DDL(CLI 自举兜底)。 */
static final String CREATE_DDL = """
CREATE TABLE IF NOT EXISTS sys_page_schema (
template_id character varying(64) NOT NULL,
name character varying(255),
schema_json jsonb NOT NULL,
schema_etag character varying(64) NOT NULL,
version integer NOT NULL DEFAULT 1,
update_time bigint NOT NULL,
CONSTRAINT pk_sys_page_schema PRIMARY KEY (template_id)
)""";
private static final String UPSERT = """
INSERT INTO sys_page_schema (template_id, name, schema_json, schema_etag, version, update_time)
VALUES (?, ?, ?::jsonb, ?, 1, ?)
ON CONFLICT (template_id) DO UPDATE SET
name = EXCLUDED.name,
schema_json = EXCLUDED.schema_json,
schema_etag = EXCLUDED.schema_etag,
version = sys_page_schema.version + 1,
update_time = EXCLUDED.update_time
WHERE sys_page_schema.schema_etag <> EXCLUDED.schema_etag""";
private SchemaImportCli() {
}
public static void main(String[] args) throws Exception {
if (args.length < 4) {
System.err.println("用法: SchemaImportCli <jdbcUrl> <user> <pass> <schemaDir> [csvFile]");
System.exit(2);
return;
}
String url = args[0];
String user = args[1];
String pass = args[2];
Path schemaDir = Path.of(args[3]);
Path csvFile = args.length > 4 && !args[4].isBlank() ? Path.of(args[4]) : null;
try (Connection conn = DriverManager.getConnection(url, user, pass)) {
conn.setAutoCommit(true);
Summary summary = importAll(conn, schemaDir, csvFile);
System.out.println(summary.render());
}
}
/**
* 把 {@code schemaDir} 下全部 {@code *.json} 入库。
*
* @param conn 目标平台库连接(可写)
* @param schemaDir 转换产物 schema 目录(文件名 {templateId}.json)
* @param csvFile 分级清单 CSV(可选,取 view_template_id→name;列序 id,name,...)
* @return 导入汇总
*/
public static Summary importAll(Connection conn, Path schemaDir, Path csvFile)
throws IOException, SQLException {
try (PreparedStatement ddl = conn.prepareStatement(CREATE_DDL)) {
ddl.execute();
}
Map<String, String> nameById = csvFile != null ? loadNames(csvFile) : Map.of();
long now = System.currentTimeMillis();
Summary summary = new Summary();
try (Stream<Path> files = Files.list(schemaDir);
PreparedStatement ps = conn.prepareStatement(UPSERT)) {
List<Path> jsons = files
.filter(p -> p.getFileName().toString().endsWith(".json"))
.sorted()
.toList();
for (Path file : jsons) {
String fileName = file.getFileName().toString();
String templateId = fileName.substring(0, fileName.length() - ".json".length());
String json = Files.readString(file, StandardCharsets.UTF_8);
String etag = sha256Hex(json);
String name = nameById.get(templateId);
ps.setString(1, templateId);
ps.setString(2, name);
ps.setString(3, json);
ps.setString(4, etag);
ps.setLong(5, now);
int affected = ps.executeUpdate();
summary.total++;
if (affected > 0) {
summary.upserted++;
} else {
summary.unchanged++; // ON CONFLICT WHERE etag 相同 → 0 行(内容未变)
}
}
}
return summary;
}
/** 计算内容指纹(sha-256 hex),与 PageSchemaController 的 ETag 同源。 */
static String sha256Hex(String content) {
try {
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] digest = md.digest(content.getBytes(StandardCharsets.UTF_8));
StringBuilder sb = new StringBuilder(digest.length * 2);
for (byte b : digest) {
sb.append(Character.forDigit((b >> 4) & 0xF, 16));
sb.append(Character.forDigit(b & 0xF, 16));
}
return sb.toString();
} catch (NoSuchAlgorithmException e) {
throw new IllegalStateException("SHA-256 不可用", e);
}
}
/**
* 从分级清单 CSV 取 {@code view_template_id → name}。CSV 首列 id、次列 name(见
* 转换产物/分级清单.csv 表头),含引号/逗号的名称按 RFC4180 最小解析前两列。
*/
static Map<String, String> loadNames(Path csvFile) throws IOException {
Map<String, String> map = new HashMap<>();
List<String> lines = Files.readAllLines(csvFile, StandardCharsets.UTF_8);
for (int i = 1; i < lines.size(); i++) { // 跳表头
String line = lines.get(i);
if (line.isBlank()) {
continue;
}
// BOM 在首行表头,数据行无需处理;最小解析前两个 CSV 字段
String[] firstTwo = parseFirstTwoCsv(line);
if (firstTwo[0] != null && !firstTwo[0].isBlank()) {
map.put(firstTwo[0].trim(), firstTwo[1]);
}
}
return map;
}
/** 最小 CSV 解析:取前两字段(支持双引号包裹与字段内逗号)。 */
private static String[] parseFirstTwoCsv(String line) {
String[] result = new String[2];
int field = 0;
boolean inQuotes = false;
StringBuilder cur = new StringBuilder();
for (int i = 0; i < line.length() && field < 2; i++) {
char c = line.charAt(i);
if (inQuotes) {
if (c == '"') {
if (i + 1 < line.length() && line.charAt(i + 1) == '"') {
cur.append('"');
i++;
} else {
inQuotes = false;
}
} else {
cur.append(c);
}
} else if (c == '"') {
inQuotes = true;
} else if (c == ',') {
result[field++] = cur.toString();
cur.setLength(0);
} else {
cur.append(c);
}
}
if (field < 2) {
result[field] = cur.toString();
}
return result;
}
/** 导入汇总(total=扫到的产物文件数;upserted=新增或内容变更入库;unchanged=内容未变跳过)。 */
public static final class Summary {
public int total;
public int upserted;
public int unchanged;
public String render() {
return "SchemaImportCli 导入汇总: 扫描 " + total + " 个产物, 入库/更新 " + upserted
+ " 个, 内容未变跳过 " + unchanged + " 个";
}
}
}

View File

@@ -0,0 +1,107 @@
package com.eip4.platform.metadata.web;
import java.util.List;
import java.util.Map;
import org.springframework.dao.DataAccessException;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.v3.oas.annotations.Operation;
/**
* 页面 schema 服务化端点(P4-4 切流前公共端点之一)。
*
* <p>把 platform-converter 的转换产物({@code 转换产物/schema/{view_template_id}.json},1489 个)
* 经 {@code SchemaImportCli} 入库 {@code SYS_PAGE_SCHEMA} 后,由本端点在线下发——前端
* eip4-web 在 {@code VITE_SCHEMA_SOURCE=backend} 时读这里(契约见 ../eip4-web/README.md「与后端契约清单」
* 与 src/api/schema.ts)。
*
* <p><b>契约</b>(与 eip4-web/src/api/schema.ts 对齐):
* <ul>
* <li>{@code GET /api/page/schema/{templateId}} → 200 直接返回 amis 页面 schema(JSON,顶层 type:page);</li>
* <li>{@code 404}:模板不存在(库内无该 templateId 记录);</li>
* <li>{@code 503}:schema 存储不可用(SYS_PAGE_SCHEMA 表缺失/库异常,即「转换器/产物不可用」)。</li>
* </ul>
*
* <p><b>ETag/304</b>:amis schema 不小(KB 级),入库时已算内容指纹({@code schema_etag}=sha-256 hex)。
* 响应带 {@code ETag} 强校验;请求带匹配的 {@code If-None-Match} 时回 304(空体),省去重复下发与解析。
*/
@RestController
public class PageSchemaController {
private final JdbcTemplate jdbcTemplate;
public PageSchemaController(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@Operation(summary = "下发页面 amis schema(带 ETag/304)",
description = "VITE_SCHEMA_SOURCE=backend 时前端读此端点;404=模板不存在,503=schema 存储不可用")
@GetMapping("/api/page/schema/{templateId}")
public ResponseEntity<String> schema(@PathVariable String templateId,
@RequestHeader(value = HttpHeaders.IF_NONE_MATCH, required = false)
String ifNoneMatch) {
List<Map<String, Object>> rows;
try {
rows = jdbcTemplate.queryForList(
"SELECT schema_json::text AS schema_json, schema_etag FROM sys_page_schema WHERE template_id = ?",
templateId);
} catch (DataAccessException ex) {
// SYS_PAGE_SCHEMA 表缺失或库异常 → schema 存储不可用(等价契约「503 转换器不可用」)
return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE)
.contentType(MediaType.APPLICATION_JSON)
.body("{\"status\":2,\"msg\":\"schema 存储不可用\"}");
}
if (rows.isEmpty()) {
return ResponseEntity.status(HttpStatus.NOT_FOUND)
.contentType(MediaType.APPLICATION_JSON)
.body("{\"status\":1,\"msg\":\"模板不存在\"}");
}
Map<String, Object> row = rows.get(0);
String etagValue = String.valueOf(row.get("schema_etag"));
// 强校验 ETag,带引号(RFC 7232)
String etag = "\"" + etagValue + "\"";
// 命中缓存:If-None-Match 与当前 ETag 一致 → 304 空体(仍回 ETag,便于代理缓存续期)
if (ifNoneMatch != null && etagMatches(ifNoneMatch, etag)) {
return ResponseEntity.status(HttpStatus.NOT_MODIFIED)
.eTag(etag)
.build();
}
String schemaJson = String.valueOf(row.get("schema_json"));
return ResponseEntity.ok()
.eTag(etag)
.contentType(MediaType.APPLICATION_JSON)
.body(schemaJson);
}
/** If-None-Match 可为逗号分隔多值或 {@code *};任一匹配即命中。 */
private boolean etagMatches(String ifNoneMatch, String etag) {
String header = ifNoneMatch.trim();
if ("*".equals(header)) {
return true;
}
for (String candidate : header.split(",")) {
String c = candidate.trim();
// 容忍弱校验前缀 W/(本端点只发强 ETag,但请求可能带 W/)
if (c.startsWith("W/")) {
c = c.substring(2).trim();
}
if (c.equals(etag)) {
return true;
}
}
return false;
}
}

View File

@@ -0,0 +1,343 @@
package com.eip4.platform.metadata.web;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Properties;
import org.dom4j.Document;
import org.dom4j.DocumentHelper;
import org.springframework.dao.DataAccessException;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.dsasp.server.common.dataDic.bean.GeneralPOJO;
import com.dsasp.server.common.dataDic.bean.POJOInfo;
import com.dsasp.server.common.dataDic.bean.SYS_Entity;
import com.dsasp.server.common.dataDic.service.DataDicService;
import com.dsasp.server.common.dataDic.service.POJOCRUDService;
import com.dsasp.server.common.user.service.LoggedInUser;
import com.dsasp.server.common.util.UserSession;
import com.dsasp.server.dataDic.bean.POInfo;
import com.eip4.platform.metadata.security.IdentifierWhitelist;
import com.eip4.platform.metadata.security.IllegalIdentifierException;
/**
* 选择窗数据源端点(P4-4 切流前公共端点之一)。
*
* <p>老系统 {@code SelectDialog / MultiSelectDialog} 语义 = 「从引用实体/数据源弹窗里选记录」。
* P4 批量转换器把这两类 uitype 降级为 amis {@code select + 远程 source},source 形如
* {@code /api/picker/{dialogid}/list}(见 platform-converter/P4批量转换报告.md §四第 1/3 行、
* UiTypeMapper.java 第 123/131 行)。
*
* <p><b>契约口径(侦察客户库实测定稿,见 P4衔接-picker与schema接口报告.md)</b>:转换器 source 里的
* {@code dialogid} 取自旧引擎模板 XML 里 SelectDialog 的 {@code dialogid} 属性,其值是一个
* <b>{@code view_template_id}</b>——即「弹窗用哪个列表模板渲染」,<i>而非</i> SYS_REFERENCE_ID。
* 该被引用模板的 XML 根元素({@code <crud entityid="...">} 等)携带 {@code entityid},那才是弹窗
* 数据源实体。客户库 244 个真实 picker dialogid 全部经此路径解析到实体(PM_PROJECT/SYS_ORG/VIEW_SYS_USER 等)。
*
* <p>本端点即「契约对接点」:path 变量 {@code entityOrRef} 按以下优先级解析为实体表名——
* <ol>
* <li><b>view_template_id</b>(转换器产物的主路径,覆盖全部存量 source)→ 读其 XML 根 {@code @entityid}
* → {@link DataDicService#getSYSEntity} 取实体表名;</li>
* <li><b>SYS_REFERENCE_ID</b>(兼容旧引擎引用语义)→ {@link DataDicService#getReferenceEntityTableName} 反解;</li>
* <li><b>实体表名</b>(直接以实体作数据源)→ 直接命中。</li>
* </ol>
* 解析出的表名必须经 {@link IdentifierWhitelist}(P1-3 安全第 1 层白名单)确认为已登记实体,否则 400。
*
* <p>返回 amis CRUD/options 双兼容格式 {@code {status,msg,data:{items,total,options}}}:
* <ul>
* <li>{@code options}:{@code [{label,value}]},amis {@code select} 的 source 直接消费;</li>
* <li>{@code items/total}:amis {@code crud}/{@code picker} 内嵌 CRUD 直接消费(同一端点两用)。</li>
* </ul>
*
* <p><b>安全</b>:全部入参过白名单(表名 / 搜索列名),搜索值 {@code q} 经
* {@link #escapeLikeValue} 转义后才进引擎的 LIKE 拼接点(引擎 {@code GeneralPO} 对 String 条件
* 走 {@code col like '%值%'} 裸拼,见 GeneralPO.java:1940——必须先转义单引号/通配符);
* 行级权限 {@link #buildCtx} 走与 {@link EntityController} 同口径的三级优先(asUser → JWT 绑定 → ADMIN)。
*/
@RestController
@RequestMapping("/api/picker")
public class PickerController {
private final POJOCRUDService pojoCRUDService;
private final DataDicService dataDicService;
private final IdentifierWhitelist identifierWhitelist;
private final JdbcTemplate jdbcTemplate;
public PickerController(POJOCRUDService pojoCRUDService,
DataDicService dataDicService,
IdentifierWhitelist identifierWhitelist,
JdbcTemplate jdbcTemplate) {
this.pojoCRUDService = pojoCRUDService;
this.dataDicService = dataDicService;
this.identifierWhitelist = identifierWhitelist;
this.jdbcTemplate = jdbcTemplate;
}
/**
* 选择窗数据源:{@code GET /api/picker/{entityOrRef}/list?q=&page=&perPage=}。
*
* <p>转换器产物用的就是 {@code /api/picker/{dialogid}/list} 这条路径(契约基准),故端点带
* {@code /list} 后缀以与全部存量 source 对齐;同时接受 {@code q/page/perPage} 三参(amis select
* 的 searchable/分页透传)。
*
* @param entityOrRef SYS_REFERENCE_ID 或实体表名
* @param q 模糊搜索关键字(按引用实体的标识列做 LIKE,已转义)
* @param page 页码(1 起)
* @param perPage 每页条数
* @param asUser 行级权限测试通道:显式当前用户(非 ADMIN 视角,触发行级过滤)
* @param roles 行级权限测试通道:逗号分隔角色
* @param asDepart 多维测试通道:当前部门
* @param asOrg 多维测试通道:当前机构
*/
@GetMapping("/{entityOrRef}/list")
public Map<String, Object> list(@PathVariable String entityOrRef,
@RequestParam(required = false) String q,
@RequestParam(defaultValue = "1") int page,
@RequestParam(defaultValue = "20") int perPage,
@RequestParam(required = false) String asUser,
@RequestParam(required = false) String roles,
@RequestParam(required = false) String asDepart,
@RequestParam(required = false) String asOrg) {
String table = resolveTable(entityOrRef);
// 安全第 1 层:解析出的表名必须存在于 SYS_ENTITY,否则 400(非法表名不进引擎拼接)
identifierWhitelist.requireLegalTable(table);
POJOInfo info = POInfo.getPOInfo(table);
if (info == null || !info.hasKeyColumn()) {
// 引用实体无主键(MIDTABLE 等)→ 无法作选择窗数据源,按非法实体拒绝(不回显细节)
throw new IllegalIdentifierException("引用实体不可作选择窗数据源(无主键): "
+ table.replaceAll("[^A-Z0-9_]", "?"));
}
String keyColumn = info.getKeyColumnName();
String labelColumn = displayColumn(info, keyColumn);
Properties ctx = buildCtx(asUser, roles, asDepart, asOrg);
Map<String, Object> cond = new HashMap<>();
cond.put(POJOCRUDService.PAGE_START, (page - 1) * perPage);
cond.put(POJOCRUDService.PAGE_SIZE, perPage);
// 模糊搜索:仅当有关键字且存在可读标识列时下推 LIKE。q 经转义后进引擎(引擎对 String 条件裸拼
// col like '%值%',转义单引号与 LIKE 通配符,杜绝注入与通配符逃逸)。标识列名本身来自元数据,天然合法。
if (q != null && !q.isBlank() && labelColumn != null) {
cond.put(labelColumn, escapeLikeValue(q.trim()));
}
Map<String, Object> result = pojoCRUDService.listSelect(cond, table, ctx);
List<Map<String, Object>> rows = toRows(result.get(POJOCRUDService.LIST_RESULT));
List<Map<String, Object>> options = new ArrayList<>();
for (Map<String, Object> row : rows) {
Map<String, Object> opt = new LinkedHashMap<>();
Object value = row.get("_id");
Object label = labelColumn != null ? row.get(labelColumn) : null;
opt.put("label", label != null && !String.valueOf(label).isBlank() ? label : value);
opt.put("value", value);
options.add(opt);
}
Map<String, Object> data = new HashMap<>();
data.put("items", rows); // amis crud/picker 内嵌 CRUD 直接消费
data.put("options", options); // amis select 的 source 直接消费
data.put("total", result.get(POJOCRUDService.PAGE_COUNT));
Map<String, Object> resp = new HashMap<>();
resp.put("status", 0);
resp.put("msg", "");
resp.put("data", data);
return resp;
}
/**
* 解析 path 变量为实体表名(优先级见类注释):
* <ol>
* <li>view_template_id → 读其 XML 根 {@code @entityid} → 实体表名(转换器产物主路径);</li>
* <li>SYS_REFERENCE_ID → {@link DataDicService#getReferenceEntityTableName} 反解;</li>
* <li>退化:直接当实体表名(由后续白名单校验是否登记)。</li>
* </ol>
*/
private String resolveTable(String entityOrRef) {
if (entityOrRef == null || entityOrRef.isBlank()) {
throw new IllegalIdentifierException("选择窗数据源标识为空");
}
// 1) view_template_id → 根 @entityid → 实体表名(转换器 source 里的 dialogid 主路径)
String byTemplate = resolveByViewTemplate(entityOrRef);
if (byTemplate != null && !byTemplate.isBlank()) {
return byTemplate.toUpperCase();
}
// 2) SYS_REFERENCE_ID 反解(兼容旧引擎引用语义)
String byRef = dataDicService.getReferenceEntityTableName(entityOrRef);
if (byRef != null && !byRef.isBlank()) {
return byRef.toUpperCase();
}
// 3) 退化:直接当实体表名(以实体作数据源的场景)
return entityOrRef.toUpperCase();
}
/**
* 把 {@code dialogid}(= view_template_id)解析为弹窗数据源实体表名:
* 取该模板 XML 根元素的 {@code @entityid} 属性 → {@link DataDicService#getSYSEntity} 取 TABLENAME。
* 非模板 id / 模板无 entityid / 实体不存在 → 返回 null(交上层走下一路径)。
*
* <p>PG {@code xml} 物理类型须以 {@code xml::text} 取出再解析(迁移手册 §5.33)。
*/
private String resolveByViewTemplate(String maybeTemplateId) {
String xml;
try {
List<String> xmls = jdbcTemplate.queryForList(
"SELECT xml::text FROM VIEW_TEMPLATE WHERE VIEW_TEMPLATE_ID = ? AND xml IS NOT NULL",
String.class, maybeTemplateId);
if (xmls.isEmpty()) {
return null;
}
xml = xmls.get(0);
} catch (DataAccessException ex) {
// VIEW_TEMPLATE 表缺失或库异常 → 视为非模板路径,交由 ref/直连退化
return null;
}
if (xml == null || xml.isBlank()) {
return null;
}
String entityId;
try {
Document doc = DocumentHelper.parseText(xml.trim());
entityId = doc.getRootElement().attributeValue("entityid");
} catch (Exception e) {
return null;
}
if (entityId == null || entityId.isBlank()) {
return null;
}
SYS_Entity entity = dataDicService.getSYSEntity(entityId);
if (entity == null || entity.getPo() == null) {
return null;
}
Object tableName = entity.getPo().get_Value("TABLENAME");
return tableName != null ? tableName.toString() : null;
}
/**
* 选用作 label 的「可读标识列」:优先实体声明的标识列(isidentifier),
* 回退实体的显示列(getDisplayIndex),再回退首个非主键的 String 列;都没有则返回 null
* (此时 label 回落为主键值)。
*/
private String displayColumn(POJOInfo info, String keyColumn) {
int count = info.getColumnCount();
// 1) 标识列(isidentifier=true)
for (int i = 0; i < count; i++) {
if (info.isIdentifier(i)) {
String name = info.getColumnName(i);
if (name != null && !name.equalsIgnoreCase(keyColumn)) {
return name.toUpperCase();
}
}
}
// 2) 实体声明的显示列
int di = info.getDisplayIndex();
if (di >= 0 && di < count) {
String name = info.getColumnName(di);
if (name != null && !name.equalsIgnoreCase(keyColumn)) {
return name.toUpperCase();
}
}
// 3) 首个非主键 String 列
for (int i = 0; i < count; i++) {
String name = info.getColumnName(i);
if (name != null && !name.equalsIgnoreCase(keyColumn)
&& info.getColumnClass(i) == String.class) {
return name.toUpperCase();
}
}
return null;
}
/**
* 转义进引擎 LIKE 裸拼点的搜索值(引擎 {@code GeneralPO} 对 String 条件做 {@code col like '%值%'}
* 字符串拼接,见 GeneralPO.java:1940):单引号双写防 SQL 注入,{@code %}/{@code _} 转义防通配符逃逸。
* 注:引擎当前 LIKE 未带 ESCAPE 子句,本转义把 {@code %_} 替换为下划线占位的等价语义降级,
* 优先保证安全(注入/逃逸不可发生)而非通配符可搜——这是切流前数据源端点的安全基线。
*/
static String escapeLikeValue(String raw) {
if (raw == null) {
return "";
}
StringBuilder sb = new StringBuilder(raw.length());
for (int i = 0; i < raw.length(); i++) {
char c = raw.charAt(i);
switch (c) {
case '\'' -> sb.append("''"); // 单引号双写,闭合引擎拼接的字符串字面量,杜绝注入
case '%', '_' -> sb.append(' '); // LIKE 通配符 → 空格(引擎 LIKE 无 ESCAPE,转义不可行,降级为不可作通配)
case '\\' -> sb.append(' '); // 反斜杠同样剔除,避免后端方言转义歧义
default -> sb.append(c);
}
}
return sb.toString();
}
/**
* 行级权限上下文构造,与 {@link EntityController#buildCtx} 同口径(三级优先):
* <ol>
* <li>显式 {@code asUser}(对拍测试通道)→ 非 ADMIN 视角,触发行级过滤;</li>
* <li>JWT 过滤器已绑定的请求级上下文(真实用户,非 ADMIN)→ 复用;</li>
* <li>都没有 → ADMIN 视角(不过滤)。</li>
* </ol>
*/
private Properties buildCtx(String asUser, String roles, String asDepart, String asOrg) {
if (asUser != null && !asUser.isBlank()) {
Properties ctx = new Properties();
ctx.setProperty(LoggedInUser.CURRENTUSER, asUser);
if (asDepart != null && !asDepart.isBlank()) {
ctx.setProperty(LoggedInUser.CURRENTDEPART, asDepart);
}
if (asOrg != null && !asOrg.isBlank()) {
ctx.setProperty(LoggedInUser.CURRENTORG, asOrg);
}
List<String> roleList = new ArrayList<>();
if (roles != null && !roles.isBlank()) {
for (String r : roles.split(",")) {
if (!r.isBlank()) {
roleList.add(r.trim());
}
}
}
ctx.put(LoggedInUser.ROLES, roleList);
return ctx;
}
Properties bound = UserSession.get();
if (bound != null) {
String cu = bound.getProperty(LoggedInUser.CURRENTUSER);
if (cu != null && !cu.isBlank() && !LoggedInUser.ADMIN.trim().equals(cu.trim())) {
return bound;
}
}
return UserSession.getAdmin();
}
@SuppressWarnings("unchecked")
private List<Map<String, Object>> toRows(Object listResult) {
List<Map<String, Object>> rows = new ArrayList<>();
if (listResult instanceof List<?> list) {
for (Object o : list) {
if (o instanceof GeneralPOJO p) {
rows.add(toRow(p));
}
}
}
return rows;
}
private Map<String, Object> toRow(GeneralPOJO p) {
Map<String, Object> row = new LinkedHashMap<>();
row.put("_id", p.get_ID());
for (int i = 0; i < p.get_ColumnCount(); i++) {
row.put(p.get_ColumnName(i), p.get_Value(i));
}
return row;
}
}

View File

@@ -0,0 +1,29 @@
-- ============================================================================
-- eip4-platform 平台表 SYS_PAGE_SCHEMA —— bootstrap-page-schema.sql
-- ----------------------------------------------------------------------------
-- 用途:页面 schema 服务化(P4-4)。把 platform-converter 的转换产物
-- (转换产物/schema/{view_template_id}.json,1489 个) 作为初始数据源导入,
-- 由 GET /api/page/schema/{templateId} 在线下发(amis SDK 直接渲染)。
--
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管,业务表由引擎动态建。
-- 本工程当前尚未引入 Flyway —— 本次按「bootstrap SQL(本地/CI 自举) + 生产建表脚本
-- (docs/sql/SYS_PAGE_SCHEMA.sql) 落 docs」落地,Flyway 引入列 P5 待办
-- (见 platform-metadata/P4衔接-picker与schema接口报告.md「Flyway 待办」)。
--
-- 纪律:可重复执行(CREATE TABLE IF NOT EXISTS / DROP INDEX IF EXISTS);
-- 表名/列名一律小写(PG 不区分大小写,引擎与现代层 SQL 大小写混用,小写建库两侧皆命中)。
-- schema 列用 jsonb(amis 页面 schema 不小,jsonb 便于校验/索引,且导入侧用 ::jsonb 强校验 JSON 合法)。
-- ============================================================================
CREATE TABLE IF NOT EXISTS sys_page_schema (
template_id character varying(64) NOT NULL, -- view_template_id(转换产物文件名去 .json)
name character varying(255), -- 模板名称(取自分级清单.csv,便于运维检索)
schema_json jsonb NOT NULL, -- amis 页面 schema(顶层 type:page)
schema_etag character varying(64) NOT NULL, -- schema_json 的内容指纹(sha-256 hex),用于 HTTP ETag/304
version integer NOT NULL DEFAULT 1, -- 单调递增版本(同模板重导入 +1)
update_time bigint NOT NULL, -- epoch 毫秒(与引擎 DATE 列同口径)
CONSTRAINT pk_sys_page_schema PRIMARY KEY (template_id)
);
-- 按名称检索(运维/联调按模板名找 templateId)
CREATE INDEX IF NOT EXISTS idx_sys_page_schema_name ON sys_page_schema (name);