perf(WS-D I1): /api/file/list 去函数包列 + sys_doc 函数式部分索引(全表扫→Index Scan)
I1 性能(必修):
- 根因: GET /api/file/list 原查询 WHERE UPPER(tablename)=? AND TRIM(businesskey)=?
AND isactive=1 —— 列被函数包裹(非 sargable),sys_doc 33.8 万行仅 PK 索引
→ 每次附件页渲染 Parallel Seq Scan 全表(amis service 容器每渲必打本端点;
EXPLAIN cost ~18572)。
- 修(FileController.list 查询):
· tablename 列本就全大写(DB 实测 tablename<>upper(tablename) 计数 0),app 侧已
tableName.trim().toUpperCase() → 去 UPPER 改 tablename = ?(sargable)。
· businesskey 不能简单 = trimmed: DB 实测 13000 行存「32 位 UUID + 4 空格 padding
至 36」CHAR 补白遗留(业务 PK 为 character(36)),naive businesskey=trimmed 会
漏列这 13000 行附件 → 保留 trim 语义改 rtrim(businesskey) = ?,配函数式索引使其
sargable。全程 ? 绑定(防注入,无拼接)。
- 索引 DDL: docs/sql/SYS_DOC_INDEX.sql
CREATE INDEX IF NOT EXISTS ix_sys_doc_biz
ON eip3.sys_doc (tablename, rtrim(businesskey)) WHERE isactive = 1;
已应用到 eip4dev(含 COMMENT,幂等)。客户库排切流窗口执行(与现有 docs/sql/* 同放
同风格;P5 Flyway 待办同 SYS_PAGE_SCHEMA.sql)。
- 验证(eip4dev): EXPLAIN Seq Scan(cost 18572) → Index Scan using ix_sys_doc_biz
(cost 8.44, exec 0.038ms); 补白键 OA_NOTICEMANAGE + 横线键 OA_NEWSMANAGE 均命中。
8093 重启含新 jar 后 /api/file/list 两种键风格均正常返附件(含 13000 行补白键场景)。
补测试:
- FileControllerTest #5 注入安全(priority 契约): 恶意 tableName/businessKey 不抛、返空,
ArgumentCaptor 断言走 ? 绑定(SQL 文本为静态参数化语句不含用户串,用户原串作绑定值)。
- TemplateToAmisConverterTest 新增 skip-guard: 表名 ORPHAN_*(SYS_ENTITY 解析不到)→
enrichAttachmentFields 降级守卫生效,附件字段保留原 input-file 不包 service。
- 测试全绿: FileControllerTest 5/5, TemplateToAmisConverterTest 93/93(JDK21)。
M4: buildAttachmentField 加注释说明 service.name 与内层 input-file 同名(DOCUMENT)
仅作布局归位 key,表单值由内层 input-file 绑定,amis 容忍(已浏览器验证)。
I2(已知系统级后续项,本次不修): /api/file/list 及 download 无行级数据权限——任意已认证
用户可枚举任意业务记录附件,与现有 download/flow 同 posture(生产仅认证可访问)。
TODO 注释标于 FileController.list javadoc。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1026,6 +1026,9 @@ public class TemplateToAmisConverter {
|
||||
service.put("type", "service");
|
||||
// 业务键绑表单主键;空主键(新增态)时 list 端点返空,不误列
|
||||
service.put("api", "get:/api/file/list?tableName=" + upperTable + "&businessKey=${" + pkCol + "}");
|
||||
// M4:service.name 与内层 input-file 同名(皆 DOCUMENT)。service.name 仅作布局归位 key
|
||||
// (供 <div location="DOCUMENT"> 把本容器排到正确位置),表单实际取值由内层 input-file 绑定;
|
||||
// amis 容忍二者同名(外层 service 不抢绑该字段值)——已浏览器实证(查看页附件下载列表+上传控件正常)。
|
||||
service.put("name", uploadItem.get("name")); // 保 <div location="DOCUMENT"> 归位
|
||||
service.put("label", uploadItem.get("label"));
|
||||
List<Map<String, Object>> body = new ArrayList<>();
|
||||
|
||||
@@ -688,6 +688,36 @@ class TemplateToAmisConverterTest {
|
||||
assertEquals("input-file", svcBody.get(1).get("type"));
|
||||
}
|
||||
|
||||
@Test
|
||||
@SuppressWarnings("unchecked")
|
||||
void form_附件字段_表名不可靠_不包service保留上传控件_降级守卫() {
|
||||
// WS-D D.2 skip-guard:实体在 SYS_ENTITY 解析不到 → resolveTableName 返 ORPHAN_*(占位表名),
|
||||
// 表名不可靠不能拼 /api/file/list?tableName=ORPHAN_*(会查无意义甚至误列)→ enrichAttachmentFields
|
||||
// 诚实降级:不包 service 容器,保留原 input-file 上传控件(与老系统编辑态一致,仅缺只读下载列表)。
|
||||
JdbcTemplate jdbc = mock(JdbcTemplate.class);
|
||||
// SYS_ENTITY 解析抛异常 → resolveTableName 走 catch 返 "ORPHAN_e1"
|
||||
lenient().when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
|
||||
.thenThrow(new RuntimeException("SYS_ENTITY 无此实体(孤儿模板)"));
|
||||
TemplateToAmisConverter orphanConverter = new TemplateToAmisConverter(jdbc);
|
||||
|
||||
String pageXml = "<page entityid='e9'><fields>"
|
||||
+ "<field name='DOCUMENT' label='附件' uitype='MultiFileUploadField'/>"
|
||||
+ "</fields></page>";
|
||||
Function<String, String> resolver = id -> pageXml;
|
||||
String xml = "<form entityid='e1' pageid='p1'/>";
|
||||
ConversionResult r = orphanConverter.convertGraded(xml, "孤儿附件表单", new ArrayList<>(), resolver);
|
||||
|
||||
Map<String, Object> form = body(r.getSchema());
|
||||
List<Map<String, Object>> items = flattenFormBody(form);
|
||||
Map<String, Object> doc = items.get(0);
|
||||
|
||||
// 表名 ORPHAN_* → 降级守卫生效:附件字段保持原 input-file(不被包成 service 容器)
|
||||
assertEquals("input-file", doc.get("type"),
|
||||
"表名不可靠(ORPHAN_*) → 不包 service,保留原 input-file 上传控件");
|
||||
assertEquals("DOCUMENT", doc.get("name"));
|
||||
assertNull(doc.get("api"), "降级时不应配 /api/file/list(表名不可靠)");
|
||||
}
|
||||
|
||||
/** 从 WS-D 附件 service 容器里取内层上传控件(input-file)。 */
|
||||
@SuppressWarnings("unchecked")
|
||||
private static Map<String, Object> attachmentUploadOf(Map<String, Object> attachmentField) {
|
||||
|
||||
Reference in New Issue
Block a user