feat(metadata): picker 值→显名解析(对齐老系统 DialogDisplayUtil)+ 实体加载 CHAR trim

PickerController 加 GET /api/picker/{dialogId}/resolve?value=(支持逗号多值,返 [{_id,_label}],查不到回退{_id:v,_label:v}),并让 /list 认 op=loadOptions 短路为按值解析(amis picker 原生回环口径),复用 /list 的 dialog 配置(实体表/keyColumn/displayColumn)WHERE keyColumn IN,_label 与 /list 同源。等价老系统 DialogDisplayUtil.parseDisplay(dialogid,value)→getDisplay()。EntityController.toRow 对 String 列 stripTrailing 去 CHAR(n) 尾补白——修主从/编辑表单经 /api/entity 回填引用字段时 CHAR 补白值(如 MENUROOT='MESSAGE        ')与已 trim 的 picker 选项 _id 永不匹配致只显裸 id(根级菜单显 MESSAGE)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-16 16:40:02 +08:00
parent 84a64624ff
commit 9d05894e9d
3 changed files with 568 additions and 18 deletions

View File

@@ -193,10 +193,21 @@ public class EntityController {
private Map<String, Object> toRow(GeneralPOJO p) {
Map<String, Object> row = new LinkedHashMap<>();
row.put("_id", p.get_ID());
row.put("_id", trimChar(p.get_ID()));
for (int i = 0; i < p.get_ColumnCount(); i++) {
row.put(p.get_ColumnName(i), p.get_Value(i));
row.put(p.get_ColumnName(i), trimChar(p.get_Value(i)));
}
return row;
}
/**
* 去 CHAR 列尾部补白:DB CHAR(n) 主键/引用值带尾空格(如 {@code "MESSAGE "}),而
* picker 选项 {@code _id}(PickerController 已 .trim())与表单提交值均为无补白形态。表单加载
* (master-detail/编辑页)经本端点回填引用字段时若带补白,picker valueField=_id 永不匹配选项
* → 加载只显裸 id 而非名称(如根级菜单显 MESSAGE)。故按值统一去尾补白对齐。仅 String 生效、
* 只去尾(stripTrailing)不动头,非 String(数字/日期/布尔)原样返回。
*/
private static Object trimChar(Object v) {
return v instanceof String s ? s.stripTrailing() : v;
}
}

View File

@@ -11,6 +11,7 @@ import org.dom4j.Document;
import org.dom4j.DocumentHelper;
import org.springframework.dao.DataAccessException;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.util.MultiValueMap;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;
@@ -89,10 +90,23 @@ public class PickerController {
* {@code /list} 后缀以与全部存量 source 对齐;同时接受 {@code q/page/perPage} 三参(amis select
* 的 searchable/分页透传)。
*
* <p><b>amis picker 加载已存值自动显名({@code op=loadOptions})</b>:amis 的 OptionsControl picker
* 在「加载一个已存值」时(mount / value 变化)会原生用本 {@code source} 发一次请求,query 带
* {@code op=loadOptions&value=<v>&_id=<v>}(amis-core formItem.fetchOptions/loadOptions 约定),
* 期望响应只回该值对应的选项,再经 {@code setOptions} 合并 → 选中项显示人可读名而非裸 id(picker
* 不像 select 那样自动拉 source 解析 label,全靠这一原生回环)。本端点据此在 {@code op=loadOptions}
* 时短路到 {@link #resolveValuesToOptions}(与独立 {@code /resolve} 端点同源口径),返回
* {@code {status,data:{options:[{label,value}]}}}——这就是「全站可编辑引用 picker 加载即显名」的落点,
* 无需重转换、无需改前端 source,存量 883 页 picker 即时生效。普通弹窗 CRUD 不带 {@code op},列表/
* 搜索/分页路径不受影响(对齐老系统 DialogDisplayUtil「dialog 自己按 dialogid 解析显示名」)。
*
* @param entityOrRef SYS_REFERENCE_ID 或实体表名
* @param q 模糊搜索关键字(按引用实体的标识列做 LIKE,已转义)
* @param page 页码(1 起)
* @param perPage 每页条数
* @param op amis 操作标记:{@code loadOptions} 时短路为「按值解析显示名」(picker 加载已存值)
* @param value amis loadOptions 透传的已存值(与 {@code idValue} 同义,取其一),支持逗号分隔多值
* @param idValue amis loadOptions 透传的 {@code _id}(valueField=_id);与 {@code value} 互为兜底
* @param asUser 行级权限测试通道:显式当前用户(非 ADMIN 视角,触发行级过滤)
* @param roles 行级权限测试通道:逗号分隔角色
* @param asDepart 多维测试通道:当前部门
@@ -103,10 +117,37 @@ public class PickerController {
@RequestParam(required = false) String q,
@RequestParam(defaultValue = "1") int page,
@RequestParam(defaultValue = "20") int perPage,
@RequestParam(required = false) String op,
@RequestParam(required = false) String value,
@RequestParam(name = "_id", required = false) String idValue,
@RequestParam(required = false) String asUser,
@RequestParam(required = false) String roles,
@RequestParam(required = false) String asDepart,
@RequestParam(required = false) String asOrg) {
@RequestParam(required = false) String asOrg,
@RequestParam(required = false) MultiValueMap<String, String> allParams) {
// amis picker 加载已存值:op=loadOptions 短路到「按值解析显示名」,返回 options,
// 让 picker 选中项原生显名而非裸 id(与 /resolve 同源口径)。
if ("loadOptions".equalsIgnoreCase(op)) {
// 取值口径兼容 amis 单选/多选两种序列化:
// - 单选:value=<v> / _id=<v>(scalar);
// - 多选:amis qs(arrayFormat=indices) 产 value[0]=v1&value[1]=v2 / _id[0]=...(indexed)。
// 合并成逗号串交 resolveValuesToOptions(其内部按逗号拆分+保序去重+CHAR trim)。
String wanted = collectLoadOptionsValues(value, idValue, allParams);
List<Map<String, Object>> resolved = resolveValuesToOptions(
entityOrRef, wanted, asUser, roles, asDepart, asOrg, "_label", "_id");
// 每个选项同时带 _id/_label(转换器 picker 的 valueField=_id/labelField=_label)与 value/label
// (amis 默认 field)两套键——使 picker 无论 field 配置如何,loadOptions 回来的选项都能按值匹配
// 并显名(转换器产物用 _id/_label;缺省/历史 schema 用 value/label)。这是「全站任意 picker 通用」
// 的关键:amis 按各自 valueField 匹配选中值,两套键全覆盖。
for (Map<String, Object> o : resolved) {
o.put("value", o.get("_id"));
o.put("label", o.get("_label"));
}
Map<String, Object> data = new HashMap<>();
data.put("options", resolved);
return ok(data);
}
String table = resolveTable(entityOrRef);
// 安全第 1 层:解析出的表名必须存在于 SYS_ENTITY,否则 400(非法表名不进引擎拼接)
identifierWhitelist.requireLegalTable(table);
@@ -156,16 +197,16 @@ public class PickerController {
List<Map<String, Object>> rows = toRows(result.get(POJOCRUDService.LIST_RESULT));
List<Map<String, Object>> options = new ArrayList<>();
for (Map<String, Object> row : rows) {
Object value = row.get("_id");
Object rowId = row.get("_id");
Object label = labelColumn != null ? row.get(labelColumn) : null;
String labelStr = label != null ? String.valueOf(label).trim() : "";
String display = !labelStr.isBlank() ? labelStr : String.valueOf(value).trim();
String display = !labelStr.isBlank() ? labelStr : String.valueOf(rowId).trim();
// _label:统一显示值字段。picker 用 labelField="_label" 显示选中项人可读名(与 select 的
// option.label 同口径),避免依赖各 dialog 实体显示列名(转换器无从得知)。
row.put("_label", display);
Map<String, Object> opt = new LinkedHashMap<>();
opt.put("label", display);
opt.put("value", value);
opt.put("value", rowId);
options.add(opt);
}
@@ -187,6 +228,182 @@ public class PickerController {
return resp;
}
/**
* 选择窗回显解析:{@code GET /api/picker/{entityOrRef}/resolve?value=}。
*
* <p>对齐老系统 {@code DialogDisplayUtil.parseDisplay}——「dialog 按自己的 dialogid 配置把已存
* 裸 id 解析成显示名」。amis {@code picker} 加载一个已存值时只显裸 id(不像 {@code select} 那样
* 自动拉 source 解析 label),故前端宿主在 picker 加载有值时调本端点,按 dialog 同源口径拿
* {@code _label} 回填选中项显示名(提交值仍为 {@code _id}=裸 id,不变)。
*
* <p><b>口径与 {@link #list} 完全一致</b>:复用同一 {@link #resolveTable}(dialogid→实体表)、
* 同一 {@link #displayColumn}(显示列优先于标识列)、同一 {@link #isUserDirectoryTable} 上下文策略、
* 同一 {@link #trimId} CHAR 主键去补白——保证 resolve 出的 {@code _label} 与弹窗 {@code /list}
* 里同一行的 {@code _label} 字字相同(同 dialog 同显示名)。
*
* <p>语义细节:
* <ul>
* <li>{@code value} 支持逗号分隔多值(多选 picker),按 keyColumn {@code IN (...)} 一次查回;</li>
* <li>返回顺序尽量对齐入参顺序(按 value 在入参里的位置重排查询结果);</li>
* <li>查不到的 value 兜底返回 {@code {_id:value,_label:value}}(不丢值、不报错,picker 至少显裸 id);</li>
* <li>CHAR(36) 主键库内尾空格补白:入参 trim 后比对、返回 {@code _id} 经 {@link #trimId} 去补白。</li>
* </ul>
*
* @param entityOrRef dialogid(= view_template_id)/ SYS_REFERENCE_ID / 实体表名(同 {@link #list})
* @param value 已存裸 id,支持逗号分隔多值
* @param asUser 行级权限测试通道(同 {@link #list})
* @param roles 行级权限测试通道
* @param asDepart 行级权限测试通道
* @param asOrg 行级权限测试通道
*/
@GetMapping("/{entityOrRef}/resolve")
public Map<String, Object> resolve(@PathVariable String entityOrRef,
@RequestParam(required = false) String value,
@RequestParam(required = false) String asUser,
@RequestParam(required = false) String roles,
@RequestParam(required = false) String asDepart,
@RequestParam(required = false) String asOrg) {
// 独立端点:返回 [{_id,_label}](valueField=_id/labelField=_label 口径,picker chip 直接消费)
List<Map<String, Object>> data = resolveValuesToOptions(
entityOrRef, value, asUser, roles, asDepart, asOrg, "_label", "_id");
return ok(data);
}
/**
* 收集 amis loadOptions 透传的待解析值,兼容单选/多选两种序列化,合并为逗号串:
* <ul>
* <li>单选:scalar {@code value=<v>} / {@code _id=<v>}({@code value}/{@code idValue} 形参已绑);</li>
* <li>多选:amis 用 {@code qs(arrayFormat=indices)} 序列化数组 → {@code value[0]=v1&value[1]=v2}
* /{@code _id[0]=...}(indexed),Spring 标量形参绑不到,从 {@code allParams} 里捞 {@code value[*]}
* /{@code _id[*]} 全部键。</li>
* </ul>
* 优先 {@code value} 族(amis ctx 主键),无则回退 {@code _id} 族(valueField=_id 透传)。下游
* {@link #resolveValuesToOptions} 再做逗号拆分 + 保序去重 + CHAR trim,故此处只需把多值拼成逗号串。
*/
private static String collectLoadOptionsValues(String value, String idValue,
MultiValueMap<String, String> allParams) {
List<String> vals = collectIndexed(value, "value", allParams);
if (vals.isEmpty()) {
vals = collectIndexed(idValue, "_id", allParams); // value 族空 → 回退 _id 族
}
return String.join(",", vals);
}
/** 收集某基名的 scalar({@code base})与 indexed({@code base[n]})全部值(amis qs indices 数组形态)。 */
private static List<String> collectIndexed(String scalar, String base,
MultiValueMap<String, String> allParams) {
List<String> vals = new ArrayList<>();
if (scalar != null && !scalar.isBlank()) {
vals.add(scalar);
}
if (allParams != null) {
String prefix = base + "[";
for (Map.Entry<String, List<String>> e : allParams.entrySet()) {
String k = e.getKey();
if (k != null && k.startsWith(prefix) && k.endsWith("]")) {
for (String v : e.getValue()) {
if (v != null && !v.isBlank()) {
vals.add(v);
}
}
}
}
}
return vals;
}
/**
* 「按值解析显示名」核心:把已存裸 id(逗号分隔多值)按 dialog 同源口径解析为 {@code [{label,value}]}
* (字段名由 {@code labelKey}/{@code valueKey} 定,供 {@code /resolve}=「_label/_id」与
* {@code list?op=loadOptions}=「label/value」两路复用,保证 {@code _label} 与 {@link #list} 弹窗行
* 同显示名)。复用 {@link #resolveTable}/{@link #displayColumn}/{@link #isUserDirectoryTable}/
* {@link #buildCtx}/{@link #trimId}——与 {@link #list} 完全同源。
*
* <p>语义:① 入参 trim(CHAR 主键去补白后比对)+ 保序去重;② keyColumn {@code IN (...)} 一次查回;
* ③ 返回按入参顺序回填;④ 查不到的 value 兜底 {@code {label:value,value:value}}(不丢值、显裸 id);
* ⑤ 数据权限拒绝(PrivilegeException)→ 全部兜底,不 500(与 {@link #list} 友好降级一致)。
*/
private List<Map<String, Object>> resolveValuesToOptions(String entityOrRef, String value,
String asUser, String roles,
String asDepart, String asOrg,
String labelKey, String valueKey) {
// 入参拆分 + trim(CHAR 主键去补白后比对)+ 保序去重(重复值只查一次,回填时按原序复用)
List<String> wanted = new ArrayList<>();
if (value != null) {
for (String v : value.split(",")) {
String t = v.trim();
if (!t.isBlank() && !wanted.contains(t)) {
wanted.add(t);
}
}
}
if (wanted.isEmpty()) {
return new ArrayList<>();
}
String table = resolveTable(entityOrRef);
// 安全第 1 层:解析出的表名必须存在于 SYS_ENTITY(与 list 同口径),否则 400
identifierWhitelist.requireLegalTable(table);
POJOInfo info = POInfo.getPOInfo(table);
if (info == null || !info.hasKeyColumn()) {
throw new IllegalIdentifierException("引用实体不可作选择窗数据源(无主键): "
+ table.replaceAll("[^A-Z0-9_]", "?"));
}
String keyColumn = info.getKeyColumnName();
String labelColumn = displayColumn(info, keyColumn);
// 上下文策略与 list 同源:用户目录类强制 ADMIN,其余走 per-user 行级权限
Properties ctx = isUserDirectoryTable(table)
? UserSession.getAdmin()
: buildCtx(asUser, roles, asDepart, asOrg);
// keyColumn IN (values):引擎对 String 列的 List 条件走 processListIn → col IN ('v1','v2')(值经
// StringUtil.TO_STRING 引号转义,杜绝注入)。perPage 取「不少于入参数」的安全上限,一次查回。
Map<String, Object> cond = new HashMap<>();
cond.put(POJOCRUDService.PAGE_START, 0);
cond.put(POJOCRUDService.PAGE_SIZE, Math.max(wanted.size(), 1));
cond.put(keyColumn, new ArrayList<>(wanted));
// value→显示名 命中表(id 已 trim);查不到的 value 走兜底
Map<String, String> resolved = new HashMap<>();
try {
Map<String, Object> result = pojoCRUDService.listSelect(cond, table, ctx);
for (Map<String, Object> row : toRows(result.get(POJOCRUDService.LIST_RESULT))) {
Object idVal = row.get("_id"); // toRow 已 trimId
String id = idVal != null ? String.valueOf(idVal).trim() : "";
if (id.isBlank()) {
continue;
}
Object label = labelColumn != null ? row.get(labelColumn) : null;
String labelStr = label != null ? String.valueOf(label).trim() : "";
resolved.put(id, !labelStr.isBlank() ? labelStr : id);
}
} catch (PrivilegeException ex) {
// 数据权限拒绝 → 不报错、不丢值,全部走兜底(picker 至少显裸 id),与 list 的友好降级一致
resolved = new HashMap<>();
}
// 按入参顺序回填;查不到的 value 兜底 {label:value,value:value}
List<Map<String, Object>> data = new ArrayList<>();
for (String v : wanted) {
String label = resolved.getOrDefault(v, v);
Map<String, Object> item = new LinkedHashMap<>();
item.put(valueKey, v);
item.put(labelKey, label);
data.add(item);
}
return data;
}
private static Map<String, Object> ok(Object data) {
Map<String, Object> resp = new HashMap<>();
resp.put("status", 0);
resp.put("msg", "");
resp.put("data", data);
return resp;
}
/**
* 解析 path 变量为实体表名(优先级见类注释):
* <ol>