F2-17根因: picker 选人修复(显示列优先取姓名 + 孤儿用户选择框→VIEW_SYS_USER)

displayColumn 改 isentitydisplay 显示列优先(label 取姓名非工号);xml=NULL
孤儿用户选择框(name LIKE 用户选择框)路由到 VIEW_SYS_USER。实测 1b3bad0b
由 400→返回带姓名 1857 用户。11 单测。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-12 09:38:39 +08:00
parent f5850a884d
commit d5c1236a08
2 changed files with 155 additions and 14 deletions

View File

@@ -158,6 +158,7 @@ public class PickerController {
* 解析 path 变量为实体表名(优先级见类注释): * 解析 path 变量为实体表名(优先级见类注释):
* <ol> * <ol>
* <li>view_template_id → 读其 XML 根 {@code @entityid} → 实体表名(转换器产物主路径);</li> * <li>view_template_id → 读其 XML 根 {@code @entityid} → 实体表名(转换器产物主路径);</li>
* <li>内建选择器(xml=NULL 孤儿模板)→ 按模板 name 路由到规范实体(用户→VIEW_SYS_USER);</li>
* <li>SYS_REFERENCE_ID → {@link DataDicService#getReferenceEntityTableName} 反解;</li> * <li>SYS_REFERENCE_ID → {@link DataDicService#getReferenceEntityTableName} 反解;</li>
* <li>退化:直接当实体表名(由后续白名单校验是否登记)。</li> * <li>退化:直接当实体表名(由后续白名单校验是否登记)。</li>
* </ol> * </ol>
@@ -171,15 +172,57 @@ public class PickerController {
if (byTemplate != null && !byTemplate.isBlank()) { if (byTemplate != null && !byTemplate.isBlank()) {
return byTemplate.toUpperCase(); return byTemplate.toUpperCase();
} }
// 2) SYS_REFERENCE_ID 反解(兼容旧引擎引用语义) // 2) 内建选择器(xml=NULL 孤儿模板)→ 按模板 name 路由到规范实体(VIEW_SYS_USER 等)
String byBuiltin = resolveBuiltinSelector(entityOrRef);
if (byBuiltin != null && !byBuiltin.isBlank()) {
return byBuiltin.toUpperCase();
}
// 3) SYS_REFERENCE_ID 反解(兼容旧引擎引用语义)
String byRef = dataDicService.getReferenceEntityTableName(entityOrRef); String byRef = dataDicService.getReferenceEntityTableName(entityOrRef);
if (byRef != null && !byRef.isBlank()) { if (byRef != null && !byRef.isBlank()) {
return byRef.toUpperCase(); return byRef.toUpperCase();
} }
// 3) 退化:直接当实体表名(以实体作数据源的场景) // 4) 退化:直接当实体表名(以实体作数据源的场景)
return entityOrRef.toUpperCase(); return entityOrRef.toUpperCase();
} }
/**
* 老引擎内建用户/组织/部门选择器的规范数据源实体表名。这些选择器在 {@code view_template}
* 里 {@code xml} 为 NULL(无数据驱动 xml,全库 27 个空模板中属此类),故
* {@link #resolveByViewTemplate} 必落空——它们的数据源不在 xml 里,而由模板 {@code name}
* 的语义决定(用户→{@code VIEW_SYS_USER})。
*
* <p>典型例:{@code 1b3bad0b-...}(通知表单「接收人」用的「用户选择框(…)」)xml 为 NULL,
* 三级解析全落空→退化当表名→白名单拒 400。此处按 name 前缀「用户选择框」/含「用户」识别,
* 路由到 {@code VIEW_SYS_USER},让 picker 返回带姓名的用户选项。
*
* <p>仅对 xml=NULL 的孤儿模板生效(有 xml 的模板已由主路径解析,不进此分支),不影响既有解析。
* 部门/机构/岗位类内建选择器暂未在存量 picker dialogid 中出现,预留 name 关键字位以便后续扩展。
*/
private String resolveBuiltinSelector(String maybeTemplateId) {
String name;
try {
List<String> names = jdbcTemplate.queryForList(
"SELECT name FROM VIEW_TEMPLATE WHERE VIEW_TEMPLATE_ID = ? AND xml IS NULL",
String.class, maybeTemplateId);
if (names.isEmpty()) {
return null;
}
name = names.get(0);
} catch (DataAccessException ex) {
return null;
}
if (name == null || name.isBlank()) {
return null;
}
// 用户选择器(内建)→ 规范用户实体。"用户选择框" 前缀是老引擎内建用户选择器的固定命名,
// 含"用户"亦兜底归此类。返回的表名仍须过 list() 里的白名单(VIEW_SYS_USER 已登记)。
if (name.startsWith("用户选择框") || name.contains("用户")) {
return "VIEW_SYS_USER";
}
return null;
}
/** /**
* 把 {@code dialogid}(= view_template_id)解析为弹窗数据源实体表名: * 把 {@code dialogid}(= view_template_id)解析为弹窗数据源实体表名:
* 取该模板 XML 根元素的 {@code @entityid} 属性 → {@link DataDicService#getSYSEntity} 取 TABLENAME。 * 取该模板 XML 根元素的 {@code @entityid} 属性 → {@link DataDicService#getSYSEntity} 取 TABLENAME。
@@ -239,13 +282,30 @@ public class PickerController {
} }
/** /**
* 选用作 label 的「可读标识列」:优先实体声明的标识列(isidentifier), * 选用作 label 的「可读标识列」:优先实体声明的显示列({@code isentitydisplay=1},
* 回退实体的显示列(getDisplayIndex),再回退首个非主键的 String 列;都没有则返回 null * 经 {@link POJOInfo#getDisplayIndex}),回退实体的标识列({@code isidentifier=true}),
* (此时 label 回落为主键值)。 * 再回退首个非主键的 String 列;都没有则返回 null(此时 label 回落为主键值)。
*
* <p><b>F2-9 修复(label=工号/UUID 退化)</b>:原顺序「标识列优先」会让 VIEW_SYS_USER 这类实体
* 选中 {@code ACCOUNT}(工号,isidentifier=1,列序在 DISPLAYNAME 之前)而非
* {@code DISPLAYNAME}(姓名,isentitydisplay=1)——picker 标签遂显示工号/UUID 而非人名。
* 实体显式声明的「显示列」就是给人看的可读标识(与旧引擎弹窗 {@code <field>} 首列、
* selectservice 的展示语义一致),故应优先于通用标识列。
*
* <p>注:{@code getDisplayIndex()} 在实体无显示列时回落为 0(即主键列),故此处用
* {@code !equalsIgnoreCase(keyColumn)} 守卫——主键不可作 label,落空则继续走标识列/String 列。
*/ */
private String displayColumn(POJOInfo info, String keyColumn) { private String displayColumn(POJOInfo info, String keyColumn) {
int count = info.getColumnCount(); int count = info.getColumnCount();
// 1) 标识列(isidentifier=true) // 1) 实体声明的显示列(isentitydisplay=1)——人可读标识优先(如 VIEW_SYS_USER.DISPLAYNAME=姓名)
int di = info.getDisplayIndex();
if (di >= 0 && di < count) {
String name = info.getColumnName(di);
if (name != null && !name.equalsIgnoreCase(keyColumn)) {
return name.toUpperCase();
}
}
// 2) 标识列(isidentifier=true)
for (int i = 0; i < count; i++) { for (int i = 0; i < count; i++) {
if (info.isIdentifier(i)) { if (info.isIdentifier(i)) {
String name = info.getColumnName(i); String name = info.getColumnName(i);
@@ -254,14 +314,6 @@ public class PickerController {
} }
} }
} }
// 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 列 // 3) 首个非主键 String 列
for (int i = 0; i < count; i++) { for (int i = 0; i < count; i++) {
String name = info.getColumnName(i); String name = info.getColumnName(i);

View File

@@ -300,4 +300,93 @@ class PickerControllerTest {
verify(wl).requireLegalTable("PM_PROJECT"); // 解析出 PM_PROJECT 并过白名单 verify(wl).requireLegalTable("PM_PROJECT"); // 解析出 PM_PROJECT 并过白名单
verify(engine).listSelect(any(), eq("PM_PROJECT"), any(Properties.class)); verify(engine).listSelect(any(), eq("PM_PROJECT"), any(Properties.class));
} }
/**
* 模式 A(内建用户选择框孤儿,xml=NULL):dialogid 命中 VIEW_TEMPLATE 但 xml 为 NULL,
* 主路径 {@link PickerController#resolveByViewTemplate} 落空 →
* {@link PickerController#resolveBuiltinSelector} 按 name 前缀「用户选择框」路由到 VIEW_SYS_USER。
* 这是 {@code 1b3bad0b-...}(通知表单「接收人」)这类内建选择器的修复路径。
*/
@Test
@DisplayName("10. 模式A:用户选择框孤儿(xml=NULL) → 按 name 路由到 VIEW_SYS_USER")
void resolvesBuiltinUserSelectorOrphanToViewSysUser() {
String dialogId = "1b3bad0b-a24b-4347-9466-db78f7432756";
POJOCRUDService engine = mock(POJOCRUDService.class);
DataDicService dic = mock(DataDicService.class);
IdentifierWhitelist wl = mock(IdentifierWhitelist.class);
JdbcTemplate jdbc = mock(JdbcTemplate.class);
// 主路径查询(xml IS NOT NULL)返回空 → resolveByViewTemplate 落空
when(jdbc.queryForList(org.mockito.ArgumentMatchers.contains("xml IS NOT NULL"),
eq(String.class), eq(dialogId))).thenReturn(List.of());
// 内建选择器查询(xml IS NULL)返回模板 name → resolveBuiltinSelector 命中
when(jdbc.queryForList(org.mockito.ArgumentMatchers.contains("xml IS NULL"),
eq(String.class), eq(dialogId)))
.thenReturn(List.of("用户选择框(公司部门/岗位类别/用户类别,正常/禁止登录-受权限控制)"));
Map<String, Object> result = engineResult(fakeRow("u1", "罗来伟"));
when(engine.listSelect(any(), eq("VIEW_SYS_USER"), any(Properties.class))).thenReturn(result);
seedPoInfoCache("VIEW_SYS_USER", fakeInfo());
PickerController c = new PickerController(engine, dic, wl, jdbc);
Map<String, Object> resp = c.list(dialogId, null, 1, 20, null, null, null, null);
assertEquals(0, resp.get("status"));
verify(wl).requireLegalTable("VIEW_SYS_USER"); // 路由到 VIEW_SYS_USER 并过白名单
verify(engine).listSelect(any(), eq("VIEW_SYS_USER"), any(Properties.class));
// 未走 ref 反解(孤儿分支在 ref 之前命中)
org.mockito.Mockito.verify(dic, org.mockito.Mockito.never()).getReferenceEntityTableName(dialogId);
}
/**
* 模式 B(label 退化为工号/UUID):实体的「标识列」(isidentifier,如 ACCOUNT=工号) 列序在
* 「显示列」(isentitydisplay,如 DISPLAYNAME=姓名) 之前。F2-9 修复后 label 取显示列(姓名)而非
* 标识列(工号)。覆盖 {@link PickerController#displayColumn} 的优先级修正(显示列优先于标识列)。
*/
@Test
@DisplayName("11. 模式B:label 取实体显示列(DISPLAYNAME=姓名),而非靠前的标识列(ACCOUNT=工号)")
void labelPrefersEntityDisplayColumnOverIdentifier() {
POJOCRUDService engine = mock(POJOCRUDService.class);
DataDicService dic = mock(DataDicService.class);
IdentifierWhitelist wl = mock(IdentifierWhitelist.class);
when(dic.getReferenceEntityTableName(REF_ID)).thenReturn("VIEW_SYS_USER");
// 模拟 VIEW_SYS_USER 列布局:0=主键, 1=ACCOUNT(标识列,工号), 2=DISPLAYNAME(显示列,姓名)
POJOInfo userInfo = mock(POJOInfo.class);
when(userInfo.hasKeyColumn()).thenReturn(true);
when(userInfo.getKeyColumnName()).thenReturn("VIEW_SYS_USER_ID");
when(userInfo.getColumnCount()).thenReturn(3);
when(userInfo.getColumnName(0)).thenReturn("VIEW_SYS_USER_ID");
when(userInfo.getColumnName(1)).thenReturn("ACCOUNT");
when(userInfo.getColumnName(2)).thenReturn("DISPLAYNAME");
when(userInfo.isIdentifier(0)).thenReturn(true); // 主键也是标识列(被 keyColumn 守卫跳过)
when(userInfo.isIdentifier(1)).thenReturn(true); // ACCOUNT 标识列(原逻辑会错选这列)
when(userInfo.isIdentifier(2)).thenReturn(false);
when(userInfo.getDisplayIndex()).thenReturn(2); // DISPLAYNAME 是 isentitydisplay 列
org.mockito.Mockito.doReturn(String.class).when(userInfo).getColumnClass(org.mockito.ArgumentMatchers.anyInt());
seedPoInfoCache("VIEW_SYS_USER", userInfo);
// 引擎行:ACCOUNT=130218(工号), DISPLAYNAME=罗来伟[130218](姓名)
GeneralPOJO row = mock(GeneralPOJO.class);
when(row.get_ID()).thenReturn("u1");
when(row.get_ColumnCount()).thenReturn(3);
when(row.get_ColumnName(0)).thenReturn("VIEW_SYS_USER_ID");
when(row.get_ColumnName(1)).thenReturn("ACCOUNT");
when(row.get_ColumnName(2)).thenReturn("DISPLAYNAME");
when(row.get_Value(0)).thenReturn("u1");
when(row.get_Value(1)).thenReturn("130218");
when(row.get_Value(2)).thenReturn("罗来伟[130218]");
Map<String, Object> result = new HashMap<>();
result.put(POJOCRUDService.LIST_RESULT, List.of(row));
result.put(POJOCRUDService.PAGE_COUNT, 1L);
when(engine.listSelect(any(), eq("VIEW_SYS_USER"), any(Properties.class))).thenReturn(result);
PickerController c = new PickerController(engine, dic, wl, emptyTemplateJdbc());
Map<String, Object> resp = c.list(REF_ID, null, 1, 20, null, null, null, null);
@SuppressWarnings("unchecked")
Map<String, Object> data = (Map<String, Object>) resp.get("data");
@SuppressWarnings("unchecked")
List<Map<String, Object>> options = (List<Map<String, Object>>) data.get("options");
// label 必须是姓名(DISPLAYNAME),而非工号(ACCOUNT)
assertEquals("罗来伟[130218]", options.get(0).get("label"));
assertEquals("u1", options.get(0).get("value"));
}
} }