feat(picker): 列筛选下推,支持表单级联(组织→部门→岗位)

PickerController.list() 在 q 模糊查之后追加 applyColumnFilters:把请求里
按真实表列名传入的等值过滤参(白名单=该表真实列,排除 q/page/perPage/op
/value/_id/asUser/roles/asDepart/asOrg 等控制参)下推为等值条件,空值跳过,
escapeLikeValue 防注入。

配合转换器 filterscript 级联:上级选择框变化后 amis 以 &COL=${TRIG} 重拉
本选择框 source,由此端点据列值过滤,实现组织→部门→岗位的联动下拉。

PickerControllerTest 扩充覆盖列筛选/白名单/空值/转义。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-17 16:32:33 +08:00
parent abc32af6e9
commit d427be2802
2 changed files with 181 additions and 27 deletions

View File

@@ -27,6 +27,7 @@ import com.dsasp.server.common.exception.PrivilegeException;
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.flow.UserColumnResolver;
import com.eip4.platform.metadata.security.IdentifierWhitelist;
import com.eip4.platform.metadata.security.IllegalIdentifierException;
@@ -72,15 +73,19 @@ public class PickerController {
private final DataDicService dataDicService;
private final IdentifierWhitelist identifierWhitelist;
private final JdbcTemplate jdbcTemplate;
/** 与功能列表(FlowController)同一套引用列显名解析——picker 行也补 {COL}_DISPLAY__,列改指显名。 */
private final UserColumnResolver userColumnResolver;
public PickerController(POJOCRUDService pojoCRUDService,
DataDicService dataDicService,
IdentifierWhitelist identifierWhitelist,
JdbcTemplate jdbcTemplate) {
JdbcTemplate jdbcTemplate,
UserColumnResolver userColumnResolver) {
this.pojoCRUDService = pojoCRUDService;
this.dataDicService = dataDicService;
this.identifierWhitelist = identifierWhitelist;
this.jdbcTemplate = jdbcTemplate;
this.userColumnResolver = userColumnResolver;
}
/**
@@ -176,6 +181,12 @@ public class PickerController {
if (q != null && !q.isBlank() && labelColumn != null) {
cond.put(labelColumn, escapeLikeValue(q.trim()));
}
// filterscript 级联过滤(组织→部门→岗位等):转换器把字段 filterscript 的 setFilter 语义译成
// source 上的 &FILTERCOL=${TRIGGER} 查询参(见 TemplateToAmisConverter.applyFilterscriptCascade)。
// 这里把 allParams 里「命中本表真实列名」的非空参作等值条件下推(值经 escapeLikeValue 转义;引擎对
// String 条件走 col like '%值%',恰好匹配 CHAR(36) 主键的尾空格补白值)。非表列/控制参/空值一律忽略
// ——表列名匹配本身即白名单,杜绝任意列注入;空值不下推(amis 触发器未选时列出全部,不致误清空)。
applyColumnFilters(cond, info, allParams);
Map<String, Object> result;
try {
@@ -195,6 +206,9 @@ public class PickerController {
}
List<Map<String, Object>> rows = toRows(result.get(POJOCRUDService.LIST_RESULT));
// 统一引用列解析:与功能列表(FlowController.executePost → userColumnResolver.resolveRows)完全同一套,
// 给每行补 {COL}_DISPLAY__(如 PARENTID→父组织名/DEPARTID→部门名),修「picker 列父级组织等显裸 id」。
userColumnResolver.resolveRows(table, rows);
List<Map<String, Object>> options = new ArrayList<>();
for (Map<String, Object> row : rows) {
Object rowId = row.get("_id");
@@ -213,12 +227,17 @@ public class PickerController {
// 选择窗多列:优先用 dialog(view_template)<display> 里显式声明的列(忠实复刻老系统弹窗列序,
// 如用品选择「用品类别/用品名称/规格/单位/重要性/库存数量」);无模板 display(孤儿模板/直连实体)
// 才回落实体元数据启发式 gridColumns。修「多选弹窗列不对(仅显 名称+裸类别 id)」。
List<Map<String, Object>> displayCols = displayColumnsFromTemplate(entityOrRef);
List<Map<String, Object>> cols = displayColumnsFromTemplate(entityOrRef);
if (cols == null) {
cols = gridColumns(table, info, keyColumn, labelColumn);
}
// 引用列改指显名:列 name=PARENTID 且行已补 PARENTID_DISPLAY__ → 列 name 改 PARENTID_DISPLAY__,
// amis 按 name 取行字段 → 显父组织名而非裸 id(label 保留)。与功能列表(FlowController)同口径。
remapReferenceColumnsToDisplay(cols, rows);
Map<String, Object> data = new HashMap<>();
data.put("items", rows); // amis crud/picker 内嵌 CRUD 直接消费
data.put("options", options); // amis select 的 source 直接消费
data.put("columns", displayCols != null ? displayCols
: gridColumns(table, info, keyColumn, labelColumn)); // amis picker 内嵌 CRUD 按响应 columns 渲染多列
data.put("columns", cols); // amis picker 内嵌 CRUD 按响应 columns 渲染多列
data.put("total", result.get(POJOCRUDService.PAGE_COUNT));
Map<String, Object> resp = new HashMap<>();
@@ -228,6 +247,71 @@ public class PickerController {
return resp;
}
/**
* 引用列改指显名:对每个列,若其 {@code name=COL} 且行内已补 {@code COL_DISPLAY__}(由
* {@link UserColumnResolver#resolveRows} 填),把列 {@code name} 改为 {@code COL_DISPLAY__}
* → amis 按 name 取行字段渲染,显引用对象名(如父组织名/部门名)而非裸 id,列 {@code label} 不变。
* 与功能列表(FlowController)的引用列显名口径一致。空列/空行 → no-op。
*/
private static void remapReferenceColumnsToDisplay(List<Map<String, Object>> cols,
List<Map<String, Object>> rows) {
if (cols == null || cols.isEmpty() || rows == null || rows.isEmpty()) {
return;
}
Map<String, Object> sample = rows.get(0);
for (Map<String, Object> col : cols) {
Object nameObj = col.get("name");
if (!(nameObj instanceof String name) || name.isBlank() || name.endsWith("_DISPLAY__")) {
continue;
}
if (sample.containsKey(name + "_DISPLAY__")) {
col.put("name", name + "_DISPLAY__");
}
}
}
/** {@link #list} 的控制参(非过滤列):这些键即便撞上表列名也不作过滤条件。 */
private static final java.util.Set<String> LIST_CONTROL_PARAMS = java.util.Set.of(
"Q", "PAGE", "PERPAGE", "OP", "VALUE", "_ID",
"ASUSER", "ROLES", "ASDEPART", "ASORG");
/**
* filterscript 级联列过滤:把 {@code allParams} 里「命中本表真实列名(大小写不敏感)且非控制参、非空值」
* 的参作等值条件加进 {@code cond}(值经 {@link #escapeLikeValue} 转义)。表列名匹配本身即白名单——
* 任意非列参(amis 内部参/未知参)天然被忽略,杜绝任意列注入。空值参不下推(amis 级联触发器未选时
* 不致把列表误清空,而是列出全部,与级联渐进收窄的 UX 一致)。
*/
private void applyColumnFilters(Map<String, Object> cond, POJOInfo info,
MultiValueMap<String, String> allParams) {
if (cond == null || info == null || allParams == null || allParams.isEmpty()) {
return;
}
// 本表真实列名集合(大写)——级联过滤的白名单
java.util.Set<String> columns = new java.util.HashSet<>();
for (int i = 0; i < info.getColumnCount(); i++) {
String c = info.getColumnName(i);
if (c != null && !c.isBlank()) {
columns.add(c.toUpperCase());
}
}
for (Map.Entry<String, List<String>> e : allParams.entrySet()) {
String key = e.getKey();
if (key == null || key.isBlank()) {
continue;
}
String keyUp = key.toUpperCase();
if (LIST_CONTROL_PARAMS.contains(keyUp) || !columns.contains(keyUp)) {
continue; // 控制参 / 非本表列 → 忽略
}
List<String> vals = e.getValue();
String v = (vals == null || vals.isEmpty()) ? null : vals.get(0);
if (v == null || v.isBlank()) {
continue; // 空值(触发器未选)→ 不下推,列出全部
}
cond.put(keyUp, escapeLikeValue(v.trim()));
}
}
/**
* 选择窗回显解析:{@code GET /api/picker/{entityOrRef}/resolve?value=}。
*