diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java index b765689..9cec149 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java @@ -158,6 +158,7 @@ public class PickerController { * 解析 path 变量为实体表名(优先级见类注释): *
    *
  1. view_template_id → 读其 XML 根 {@code @entityid} → 实体表名(转换器产物主路径);
  2. + *
  3. 内建选择器(xml=NULL 孤儿模板)→ 按模板 name 路由到规范实体(用户→VIEW_SYS_USER);
  4. *
  5. SYS_REFERENCE_ID → {@link DataDicService#getReferenceEntityTableName} 反解;
  6. *
  7. 退化:直接当实体表名(由后续白名单校验是否登记)。
  8. *
@@ -171,15 +172,57 @@ public class PickerController { if (byTemplate != null && !byTemplate.isBlank()) { 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); if (byRef != null && !byRef.isBlank()) { return byRef.toUpperCase(); } - // 3) 退化:直接当实体表名(以实体作数据源的场景) + // 4) 退化:直接当实体表名(以实体作数据源的场景) return entityOrRef.toUpperCase(); } + /** + * 老引擎内建用户/组织/部门选择器的规范数据源实体表名。这些选择器在 {@code view_template} + * 里 {@code xml} 为 NULL(无数据驱动 xml,全库 27 个空模板中属此类),故 + * {@link #resolveByViewTemplate} 必落空——它们的数据源不在 xml 里,而由模板 {@code name} + * 的语义决定(用户→{@code VIEW_SYS_USER})。 + * + *

典型例:{@code 1b3bad0b-...}(通知表单「接收人」用的「用户选择框(…)」)xml 为 NULL, + * 三级解析全落空→退化当表名→白名单拒 400。此处按 name 前缀「用户选择框」/含「用户」识别, + * 路由到 {@code VIEW_SYS_USER},让 picker 返回带姓名的用户选项。 + * + *

仅对 xml=NULL 的孤儿模板生效(有 xml 的模板已由主路径解析,不进此分支),不影响既有解析。 + * 部门/机构/岗位类内建选择器暂未在存量 picker dialogid 中出现,预留 name 关键字位以便后续扩展。 + */ + private String resolveBuiltinSelector(String maybeTemplateId) { + String name; + try { + List 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)解析为弹窗数据源实体表名: * 取该模板 XML 根元素的 {@code @entityid} 属性 → {@link DataDicService#getSYSEntity} 取 TABLENAME。 @@ -239,13 +282,30 @@ public class PickerController { } /** - * 选用作 label 的「可读标识列」:优先实体声明的标识列(isidentifier), - * 回退实体的显示列(getDisplayIndex),再回退首个非主键的 String 列;都没有则返回 null - * (此时 label 回落为主键值)。 + * 选用作 label 的「可读标识列」:优先实体声明的显示列({@code isentitydisplay=1}, + * 经 {@link POJOInfo#getDisplayIndex}),回退实体的标识列({@code isidentifier=true}), + * 再回退首个非主键的 String 列;都没有则返回 null(此时 label 回落为主键值)。 + * + *

F2-9 修复(label=工号/UUID 退化):原顺序「标识列优先」会让 VIEW_SYS_USER 这类实体 + * 选中 {@code ACCOUNT}(工号,isidentifier=1,列序在 DISPLAYNAME 之前)而非 + * {@code DISPLAYNAME}(姓名,isentitydisplay=1)——picker 标签遂显示工号/UUID 而非人名。 + * 实体显式声明的「显示列」就是给人看的可读标识(与旧引擎弹窗 {@code } 首列、 + * selectservice 的展示语义一致),故应优先于通用标识列。 + * + *

注:{@code getDisplayIndex()} 在实体无显示列时回落为 0(即主键列),故此处用 + * {@code !equalsIgnoreCase(keyColumn)} 守卫——主键不可作 label,落空则继续走标识列/String 列。 */ private String displayColumn(POJOInfo info, String keyColumn) { 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++) { if (info.isIdentifier(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 列 for (int i = 0; i < count; i++) { String name = info.getColumnName(i); diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java index 75c825e..69d5de7 100644 --- a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java @@ -300,4 +300,93 @@ class PickerControllerTest { verify(wl).requireLegalTable("PM_PROJECT"); // 解析出 PM_PROJECT 并过白名单 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 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 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 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 resp = c.list(REF_ID, null, 1, 20, null, null, null, null); + + @SuppressWarnings("unchecked") + Map data = (Map) resp.get("data"); + @SuppressWarnings("unchecked") + List> options = (List>) data.get("options"); + // label 必须是姓名(DISPLAYNAME),而非工号(ACCOUNT) + assertEquals("罗来伟[130218]", options.get(0).get("label")); + assertEquals("u1", options.get(0).get("value")); + } }