Compare commits

...

4 Commits

Author SHA1 Message Date
53f3c258a9 Merge feat/report-viewer-converter: 报表查看器转换器化(Phase 2/3) + 工程 picker 认证根因修
Some checks failed
ci / build-test-parity (push) Has been cancelled
转换器对 type=200(JOR 套打)产报表查看器(crud.filter 查询条件 + /api/report/frame → iframe 渲 JOR 保真版式),
铺到全部 339 报表页;并修认证 admin 未被引擎识别为超管(CHAR(36) 补白 ADMIN 常量 exact-equals 不匹配)
致工程 picker「暂无该数据源的查询权限」的根因。code+security 双评审已收口。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:45 +08:00
9a99754f72 fix(auth): admin 引擎上下文归一为规范 ADMIN 常量(修工程 picker「暂无权限」)
工程 picker「选不到」的真因不是转换器/页面结构,而是认证 admin 的引擎身份未被识别成超管:
JWT 注入 CURRENTUSER="ADMIN"(5 字符),而引擎跳过行级数据过滤的判定是 exact
ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)——该常量是 CHAR(36) 补白的 "ADMIN"+31 空格。
5 字符 ≠ 36 字符 → admin 被当普通用户走数据权限 → PM_PROJECT 无规则 → PrivilegeException
→ picker/列表「暂无该数据源的查询权限」。(无 token 的 curl 走 ADMIN 默认上下文,故易误判后端正常。)

修:EngineContextBinder.bind() 对系统管理员把 CURRENTUSER 归一为引擎规范 36 字符 LoggedInUser.ADMIN,
引擎识别超管→跳过行级过滤(恢复引擎本就设计的 ADMIN 豁免)。isSystemAdmin 与全站 requireAdmin
逐口径对齐:userId trim 后 equalsIgnoreCase "ADMIN";account trim 后精确小写 ='admin'
(不放宽大小写——SYS_USER.ACCOUNT 无唯一约束、建号去重又区分大小写,防 'Admin' 变体账号静默提权,
安全评审 M-1)。各 requireAdmin 门控均 trim().equalsIgnoreCase,对补白形式同样判真,不破鉴权门。
非 admin 行为逐字节不变。

测试:4 个新用例(admin→36字符归一/USER_ADMINISTRATOR 不误判/account='Admin' 变体不提权/
account='admin' 精确小写识别);全 platform-auth 46 测试绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:34 +08:00
8e5e2410d1 feat(converter): convertReport 对含 JOR 套打的 type=200 产报表查看器
EIP3 真报表(jatools JOR 套打)此前被转换器降级成 amis 表格。现 convertReport 分流:
含 <reportfile>(JOR 套打版式,328/339)→ convertReportViewer 产 page→crud:
- api=/api/report/frame/{templateId}(currentTemplateId,缺则回落 entityId);
- filter=buildSearchFilter(查询条件,F3-1 过滤主键列)——picker 落 crud.filter 工作上下文;
- 单 html 列把 ${__url} 渲成 <iframe>(JOR HTML 独立加载、CSS 隔离保真);
- 有查询条件时 initFetch:false(等用户「查询」再加载,避免必填工程为空时空参渲染报错);
- header/footer toolbar 置空(报表查看器无新增/批量/分页)。
无 reportfile(9/339,纯数据报表)→ 保留原数据表降级行为不变。

测试:替换旧 JOR 降级用例为 4 个查看器用例(api/单 html iframe 列/picker 落 crud.filter+initFetch/
templateId 入 api/无 reportfile 保留表格);全 platform-converter 186 测试绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:18 +08:00
3090906f9e feat(report): /api/report/frame 端点 + Phase 2/3 报表查看器设计
报表查看器数据源端点 GET /api/report/frame/{templateId}:回显 amis CRUD 单行信封
{status:0,data:{items:[{__url}],total:1}},__url=/api/report/render/{id}?format=html&<查询参数>。
报表页是 amis crud——查询条件落 crud.filter(实测唯一能让 picker 正常加载选项的上下文;
独立 form 里 picker 弹窗恒空),单 html 列把 __url 渲成 <iframe>,JOR HTML 独立加载、CSS 隔离保真。
「选条件→查询」时 crud 携 filter 参数请求 frame→拿到带新参数的 __url→iframe 重载→按工程过滤刷新。

- reportParamsFrom:frame 专用,剥 format/tpl/page/perPage(crud 自动追加分页位),多值取首、跳空。
- buildFrameUrl:templateId 路径段 + 参数键值全 UTF-8 URL 编码,防注入(__url 注入 iframe src,
  编码确保 " & # / < > 不破坏 query 结构或逃逸属性);templateId 实为 view_template_id(UUID)编码无副作用。
- frameResult:单行信封。collectReportParams(/render)保持原有 format/tpl-only 行为不变(与 frame 分流)。
- ReportFrameTest:5 个纯逻辑单测(剥参/编码/信封/注入中和)。

design(含 Phase 2/3 实现纪要 + 认证根因)见 docs/plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md §6。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 22:19:02 +08:00
7 changed files with 390 additions and 11 deletions

View File

@@ -39,3 +39,14 @@ EIP3 `ReportExporter` 的真实通道(`jor/jatools/server/ReportExporter.java`):
- System2 连接为进程级全局(单客户部署 OK;多租户需改造)。
- 模板里 `<Url>reportviewer.jsp?...`(钻取链接)需改写为 EIP4 路由(Phase 3)。
- eip4dev 是**部分** dev 库,缺部分报表源表/视图;数据验收须对**完整客户库**。
## 6. Phase 2/3 实现纪要(2026-06-25,已完成+live验收)
报表页**不再手搭**——由转换器对 type=200 统一生成,且查询条件落在 amis `crud.filter`(实测唯一能让 picker 正常加载选项的上下文;独立 form 里 picker 弹窗恒空)。
- **后端** `GET /api/report/frame/{templateId}`(`ReportController`):回显 amis CRUD 单行信封 `{status:0,data:{items:[{__url}],total:1}}`,`__url`=`/api/report/render/{id}?format=html&<查询参数>`(templateId 路径段 + 参数键值全 UTF-8 URL 编码,防注入)。crud 的 html 列把 `__url` 渲成 `<iframe>`,JOR HTML 独立加载、CSS 隔离保真。
- **转换器** `TemplateToAmisConverter.convertReport` 分流:含 `<reportfile>`(JOR 套打,328/339)→ `convertReportViewer` 产 `page→crud{api:/api/report/frame/{id}, filter:buildSearchFilter(查询条件), columns:[单 html 列 iframe], initFetch:false(有查询条件时等用户「查询」再加载)}`;无 reportfile(9/339,纯数据)→ 保留原数据表降级;2/339 为空 XML 孤儿模板(测试动态报表等),无产物属正常。
- **认证根因修(关键)** `EngineContextBinder`:工程 picker「选不到」的真因**不是**转换器/页面结构,而是**认证 admin 的引擎身份没被识别成超管**——JWT 注入 `CURRENTUSER="ADMIN"`(5 字符),引擎跳过行级数据过滤的判定是 exact `ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)`,而该常量是 CHAR(36) 补白的 `"ADMIN"+31 空格`,5 字符 ≠ 36 字符 → admin 被当普通用户走数据权限 → `PM_PROJECT` 无规则 → `PrivilegeException` →「暂无该数据源的查询权限」(无 token 的 curl 走 ADMIN 默认上下文,故误以为后端正常)。修=`bind()` 把系统管理员(userId trim=ADMIN,或 account 精确小写='admin',与全站 `requireAdmin` 同口径,不放宽大小写防变体账号提权)的 CURRENTUSER 归一为引擎规范 36 字符 `LoggedInUser.ADMIN`,引擎识别超管→跳过过滤。各 `requireAdmin` 门控均 `trim().equalsIgnoreCase`,对补白形式同样判真,不破鉴权门。
- **live 验收**(8093 新 jar + 真库 + Playwright):工程 picker 列出全部 1672 工程→选中值落定→「搜索」→ crud 携 `PROJECTID` 调 frame→iframe `src=…?format=html&PROJECTID=…`→渲出 JOR 套打「在建项目收付款信息表」(单位/中标价/合同价/序号/工程名称/累计收款付款…);菜单 tab 内非独立页。339 报表页已批量重转重导 eip3.sys_page_schema(328 viewer 更新 + 9 表格不变)。
- **评审**:独立 code-reviewer + security-reviewer;按建议收口 templateId 路径编码、`/render` 端点 page/perPage 行为保持不变(分流到 frame)、account 判定与 requireAdmin 对齐大小写敏感(防变体账号提权)。
- **遗留**:headless 中文字体保真(版式通,需装字体)、PDF/Excel 下载入口、B 类图表(JOR jfreechart 已在 lib 随版式出图)、`<Url>` 钻取链接改 EIP4 路由、完整客户库数据对账。

View File

@@ -32,7 +32,14 @@ public final class EngineContextBinder {
*/
public static void bind(AuthPrincipal principal) {
Properties ctx = new Properties();
if (principal.userId() != null) {
if (isSystemAdmin(principal)) {
// 系统管理员:CURRENTUSER 归一为引擎规范的 CHAR(36) 补白 ADMIN 常量。
// 引擎跳过行级数据过滤的判定是 exact-equals:ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)
// (POJOCRUDServiceImpl#114/377)。JWT 注入的 userId="ADMIN"(5字符) 与 36字符补白常量不相等,
// 会令 admin 被当普通用户走数据权限 → picker/列表「暂无该数据源的查询权限」。归一后引擎识别超管。
// 各 requireAdmin 门控均 trim().equalsIgnoreCase 比较,对补白形式同样判真,故不影响管理员鉴权门。
ctx.setProperty(LoggedInUser.CURRENTUSER, LoggedInUser.ADMIN);
} else if (principal.userId() != null) {
ctx.setProperty(LoggedInUser.CURRENTUSER, principal.userId());
}
if (principal.depart() != null) {
@@ -46,6 +53,28 @@ public final class EngineContextBinder {
UserSession.set(ctx);
}
/**
* 系统管理员判定,与全站 {@code requireAdmin}({@code PageSchemaController/AdminWriteController/
* AiAgentController/AdminUserController})<strong>逐口径对齐</strong>,绝不把含 "admin" 字样的普通用户
* (如 {@code USER_ADMINISTRATOR})误判:
* <ul>
* <li>{@code userId}(引擎 CURRENTUSER 来源)去补白后 {@code equalsIgnoreCase "ADMIN"}
* (= {@code LoggedInUser.ADMIN.trim()})—— 同 requireAdmin 的 {@code "ADMIN".equalsIgnoreCase(cu)};</li>
* <li>{@code account} 去补白后<strong>大小写敏感</strong>等于 {@code "admin"} —— 同 requireAdmin 兜底的
* DB 校验 {@code TRIM(account)='admin'}(精确小写)。不放宽成大小写不敏感,避免因 {@code SYS_USER.ACCOUNT}
* 无唯一约束、建号去重又区分大小写而把 {@code 'Admin'} 这类变体账号静默提权(安全评审 M-1)。</li>
* </ul>
*/
private static boolean isSystemAdmin(AuthPrincipal principal) {
String adminId = LoggedInUser.ADMIN.trim(); // "ADMIN"
String userId = principal.userId();
if (userId != null && adminId.equalsIgnoreCase(userId.trim())) {
return true;
}
String account = principal.account();
return account != null && "admin".equals(account.trim());
}
/** 清空当前线程的引擎上下文(请求收尾,防跨请求泄漏)。 */
public static void clear() {
UserSession.remove();

View File

@@ -1,6 +1,7 @@
package com.eip4.platform.auth.security;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotEquals;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.mockito.ArgumentMatchers.anyString;
@@ -77,6 +78,63 @@ class EngineContextIsolationTest {
assertNull(UserSession.get(), "clear 后引擎上下文必须为空,杜绝跨请求泄漏");
}
@Test
void 系统管理员归一为引擎规范ADMIN常量() {
// 根因修:JWT 注入的 admin userId="ADMIN"(5字符) 与引擎 LoggedInUser.ADMIN(CHAR(36) 补白 36字符)
// exact-equals 不相等 → admin 被当普通用户走行级数据过滤 → picker/列表「暂无该数据源的查询权限」。
// bind 须把系统管理员的 CURRENTUSER 归一成引擎规范的 36 字符补白常量,使引擎识别超管、跳过过滤。
AuthPrincipal admin = new AuthPrincipal("ADMIN", "admin", "系统管理员",
"DEPT_ADMIN", "ORG_ROOT", List.of());
EngineContextBinder.bind(admin);
Properties ctx = UserSession.get();
// 与引擎 exact-equals 口径一致:必须等于 36 字符补白常量本身(这是引擎跳过行级过滤的判定)
assertEquals(LoggedInUser.ADMIN, ctx.getProperty(LoggedInUser.CURRENTUSER),
"admin 的 CURRENTUSER 必须归一为引擎规范 ADMIN 常量");
// depart/org 仍来自 principal(不丢身份维度)
assertEquals("DEPT_ADMIN", ctx.getProperty(LoggedInUser.CURRENTDEPART));
assertEquals("ORG_ROOT", ctx.getProperty(LoggedInUser.CURRENTORG));
}
@Test
void 普通用户不被误判为超管不归一() {
// 安全护栏:userId 含 admin 字样但非系统管理员,绝不能被归一成 ADMIN(否则越权拿超管数据权限)。
AuthPrincipal regular = new AuthPrincipal("USER_ADMINISTRATOR", "administrator", "张三",
"DEPT_A", "ORG_1", List.of("ROLE_CUSTOMER"));
EngineContextBinder.bind(regular);
Properties ctx = UserSession.get();
assertEquals("USER_ADMINISTRATOR", ctx.getProperty(LoggedInUser.CURRENTUSER),
"普通用户 CURRENTUSER 必须原样,不得归一为 ADMIN");
assertNotEquals(LoggedInUser.ADMIN, ctx.getProperty(LoggedInUser.CURRENTUSER),
"普通用户绝不能被引擎判定为超管");
}
@Test
void account大小写变体不被误判为超管() {
// 安全评审 M-1:account 判定大小写敏感(同 requireAdmin 的 TRIM(account)='admin')。
// SYS_USER.ACCOUNT 无唯一约束、建号去重区分大小写 → 'Admin' 这类变体账号绝不能静默提权成超管。
AuthPrincipal variant = new AuthPrincipal("402881-some-uuid", "Admin", "李四",
"DEPT_B", "ORG_2", List.of("ROLE_CUSTOMER"));
EngineContextBinder.bind(variant);
Properties ctx = UserSession.get();
assertEquals("402881-some-uuid", ctx.getProperty(LoggedInUser.CURRENTUSER),
"account='Admin'(变体) 不得归一为 ADMIN");
assertNotEquals(LoggedInUser.ADMIN, ctx.getProperty(LoggedInUser.CURRENTUSER));
}
@Test
void account为小写admin识别为超管() {
// userId 非 ADMIN 但 account='admin'(精确小写)→ 仍归一为超管,与 requireAdmin 账号兜底一致。
AuthPrincipal byAccount = new AuthPrincipal("402881-uuid-x", "admin", "系统管理员",
null, null, List.of());
EngineContextBinder.bind(byAccount);
assertEquals(LoggedInUser.ADMIN, UserSession.get().getProperty(LoggedInUser.CURRENTUSER),
"account='admin'(精确小写) 应识别为超管并归一");
}
@Test
void 过滤器请求收尾后清空上下文() throws Exception {
JwtService svc = jwtService();

View File

@@ -3769,6 +3769,15 @@ public class TemplateToAmisConverter {
: UiTypeMapper.firstNonBlank(report.attributeValue("title"),
attrOf(report.element("search"), "reporttitle"), "报表");
String entityId = report.attributeValue("entityid", "");
// Phase 3:含 <reportfile> JOR 套打版式(328/339)→ 报表查看器(jatools 引擎渲染保真版式),
// 不再降级成 amis 表格。无 reportfile(9/339)→ 落到下方数据表降级(原行为)。
Element reportfile = report.element("reportfile");
if (reportfile != null && !reportfile.getTextTrim().isBlank()) {
return convertReportViewer(report.element("search"), entityId, title,
reportfile.getTextTrim().length(), report, result);
}
String reportTable = resolveTableName(entityId, result);
// display → columns(含 ismoney/issummer 合计列)
@@ -3828,17 +3837,59 @@ public class TemplateToAmisConverter {
if ("true".equals(attrOf(search, "ischart"))) {
result.degrade("report ischart=true → 图表类报表(B 类),ECharts option 平移单列处置,本批转为表格降级");
}
// JOR 套打版式(reportfile CDATA 非空)→ 不迁移引擎(报表迁移方案 C 类)
Element reportfile = report.element("reportfile");
if (reportfile != null && !reportfile.getTextTrim().isBlank()) {
result.degrade("report 含 reportfile(JOR 套打版式 " + reportfile.getTextTrim().length()
+ " 字符) → C 类不迁移引擎,仅转表格视图(套打另案 univer/Web 打印)");
}
noteScripts(report, result);
return page(title, crudSchema);
}
/**
* 报表查看器(Phase 3):含 JOR 套打版式的 type=200 报表 → amis {@code crud}。
*
* <p><b>为何是 crud 而非独立 form</b>:报表查询条件里常有「工程」等 SelectDialog→picker;实测
* picker 只有落在 {@code crud.filter}(amis CRUD store 托管的过滤区)才能正常加载弹窗选项,放在
* 页面级独立 {@code form} 里弹窗恒「暂无数据」(同一 picker 配置,仅容器不同)。故查询条件落
* {@code crud.filter}。
*
* <p><b>报表如何渲染</b>:crud 的 {@code api} = {@code /api/report/frame/{id}},回显单行
* {@code {__url}}(指向 {@code /api/report/render/{id}?format=html&<查询参数>});唯一的 html 列把
* {@code __url} 渲成 {@code <iframe>}。用户「选条件→查询」时 crud 携 filter 参数请求 frame → 拿到带新
* 参数的 {@code __url} → iframe 重载 → JOR 引擎按工程过滤刷新。iframe 隔离 JOR 自带 CSS,版式保真。
*
* <p><b>initFetch</b>:有查询条件时设 {@code false},等用户「查询」再加载(避免必填工程为空时空参渲染报错)。
*/
private Map<String, Object> convertReportViewer(Element search, String entityId, String title,
int jorLen, Element report, ConversionResult result) {
// 查询条件落 crud.filter(picker 唯一可用上下文,F3-1 过滤主键列)
Map<String, Object> filter = buildSearchFilter(search, result, true, entityId);
String tid = (currentTemplateId != null && !currentTemplateId.isBlank()) ? currentTemplateId : entityId;
Map<String, Object> crud = new LinkedHashMap<>();
crud.put("type", "crud");
crud.put("api", "/api/report/frame/" + tid);
crud.put("syncLocation", false);
crud.put("headerToolbar", new ArrayList<>()); // 报表查看器无新增/批量按钮
crud.put("footerToolbar", new ArrayList<>()); // 单行信封,无分页条
crud.put("affixHeader", false);
if (filter != null) {
crud.put("filter", filter);
crud.put("initFetch", false); // 有查询条件 → 等用户「查询」再加载
}
// 唯一的 html 列:把回显的 __url 渲成 iframe(JOR HTML 文档独立加载,CSS 隔离保真)
Map<String, Object> col = new LinkedHashMap<>();
col.put("name", "__url");
col.put("label", "");
col.put("type", "html");
col.put("html", "<iframe src=\"${__url}\" style=\"width:100%;min-height:680px;border:0;\" frameborder=\"0\"></iframe>");
List<Map<String, Object>> cols = new ArrayList<>();
cols.add(col);
crud.put("columns", cols);
result.note("report 含 JOR 套打版式(" + jorLen + " 字符) → 报表查看器:crud.filter 查询条件 + html 列 iframe 加载 "
+ "/api/report/render/" + tid + "(jatools 引擎渲染保真版式;图表 ischart 亦由引擎 jfreechart 出图)");
noteScripts(report, result);
return page(title, crud);
}
// ──────────────────────────────────────────────────────────────────────
// group(分组容器)—— 子模板跨引用
// ──────────────────────────────────────────────────────────────────────

View File

@@ -2705,14 +2705,70 @@ class TemplateToAmisConverterTest {
}
@Test
void report_jor套打版式降级() {
@SuppressWarnings("unchecked")
void report_含JOR套打版式_改产报表查看器crud() {
// Phase 3:含 <reportfile> JOR 套打版式 → 报表查看器(jatools 引擎渲染保真版式),
// 不再降级成 amis 表格。crud.api 指向 /api/report/frame,单个 html 列把 __url 渲成 iframe。
String xml = "<report title='套打' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<search selectservice='S'/>"
+ "<reportfile><![CDATA[<jatools>非空版式定义内容占位非空版式</jatools>]]></reportfile></report>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
assertEquals(ConversionGrade.PARTIAL, r.getGrade());
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("JOR")));
Map<String, Object> crud = body(r.getSchema());
assertEquals("crud", crud.get("type"));
assertTrue(((String) crud.get("api")).startsWith("/api/report/frame/"), "api=" + crud.get("api"));
List<Map<String, Object>> cols = (List<Map<String, Object>>) crud.get("columns");
assertEquals(1, cols.size(), "报表查看器只有一个 html 列");
assertEquals("html", cols.get(0).get("type"));
String html = (String) cols.get(0).get("html");
assertTrue(html.contains("<iframe"), html);
assertTrue(html.contains("${__url}"), html);
// JOR 现在被引擎渲染,不再作为「不迁移引擎」降级
assertFalse(r.getDegrades().stream().anyMatch(d -> d.contains("不迁移引擎")),
"JOR 应被引擎渲染而非降级: " + r.getDegrades());
}
@Test
@SuppressWarnings("unchecked")
void report_查询条件picker落在crud_filter上下文() {
// 工程(SelectDialog) → picker,且必须落在 crud.filter(实测唯一能让 picker 正常加载选项的上下文)。
// 有查询条件时 initFetch=false:等用户选条件并「查询」后再加载报表(避免必填空参渲染报错)。
String xml = "<report title='收付款' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<search selectservice='S'>"
+ "<field name='PROJECTID' label='工程名称' uitype='SelectDialog' dialogid='d1' required='true'/>"
+ "</search>"
+ "<reportfile><![CDATA[<jatools>版式占位非空版式占位</jatools>]]></reportfile></report>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
Map<String, Object> filter = (Map<String, Object>) crud.get("filter");
assertNotNull(filter, "查询条件应落在 crud.filter");
List<Map<String, Object>> fbody = (List<Map<String, Object>>) filter.get("body");
Map<String, Object> projectField = fbody.stream()
.filter(f -> "PROJECTID".equals(f.get("name"))).findFirst().orElseThrow();
assertEquals("picker", projectField.get("type"), "工程 SelectDialog 应转 picker");
assertEquals(Boolean.FALSE, crud.get("initFetch"), "有查询条件时等用户查询再加载");
}
@Test
void report_templateId入查看器api() {
String xml = "<report title='套打' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<reportfile><![CDATA[<jatools>版式占位非空版式占位</jatools>]]></reportfile></report>";
ConversionResult r = converter.convertGraded(xml, "TID-123", "套打", new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
assertEquals("/api/report/frame/TID-123", crud.get("api"));
}
@Test
void report_无reportfile_保留数据表降级() {
// 9/339 无 JOR 套打版式 → 保留原数据表行为(/api/flow 列实体行),不走查看器
String xml = "<report title='纯数据报表' entityid='e1'>"
+ "<display><field name='A' text='A'/></display>"
+ "<search selectservice='PM_X_SEARCH'/></report>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
assertTrue(((String) crud.get("api")).startsWith("/api/flow/PM_X_SEARCH"), "api=" + crud.get("api"));
}
@Test

View File

@@ -1,10 +1,14 @@
package com.eip4.platform.report;
import java.io.InputStream;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -95,6 +99,83 @@ public class ReportController {
.body(body);
}
/**
* 报表查看器数据源(Phase 3):{@code GET /api/report/frame/{templateId}?<查询参数...>}
* → 返回 amis CRUD 单行信封 {@code {status:0,msg:"",data:{items:[{__url}],total:1}}},
* {@code __url} = {@code /api/report/render/{id}?format=html&<回显的查询参数>}。
*
* <p>报表页是 amis {@code crud}:查询条件放在 {@code crud.filter}(实测唯一能让 picker
* 正常加载选项的上下文;放在独立 form 里 picker 弹窗「暂无数据」)。crud 的单个 html 列把
* {@code __url} 渲成 {@code <iframe>}。用户「选工程→查询」时 crud 携 filter 参数请求本端点,
* 拿到带新参数的 {@code __url} → iframe 重新加载 → 报表按工程过滤刷新。本端点只回显 URL(不渲染),
* 真正的 JOR 渲染由 iframe 加载 {@code /api/report/render} 完成(HTML 文档独立,CSS 隔离保真)。
*/
@GetMapping("/api/report/frame/{templateId}")
public Map<String, Object> frame(@PathVariable("templateId") String templateId,
HttpServletRequest request) {
Map<String, String> params = reportParamsFrom(request.getParameterMap());
return frameResult(buildFrameUrl(templateId, params));
}
/**
* frame 端点的非报表参数:渲染控制位(format/tpl)+ amis crud 自动追加的分页位(page/perPage)。
* 注:{@code /render} 端点不剥分页位(见 {@link #collectReportParams}),保持其原有行为不变。
*/
private static final Set<String> FRAME_NON_REPORT_PARAMS = Set.of("format", "tpl", "page", "perPage");
/**
* 从原始请求参数表抽出报表参数(剔除 {@link #FRAME_NON_REPORT_PARAMS},多值取第一个,跳过空/null)。
* frame 端点专用——crud 会带 page/perPage,需剥掉。报表 SQL 里的 {@code ${PARAM}} 据此绑定。纯函数,便于单测。
*/
static Map<String, String> reportParamsFrom(Map<String, String[]> raw) {
Map<String, String> params = new LinkedHashMap<>();
if (raw == null) {
return params;
}
raw.forEach((name, values) -> {
if (name == null || FRAME_NON_REPORT_PARAMS.contains(name)) {
return;
}
if (values != null && values.length > 0 && values[0] != null) {
params.put(name, values[0]);
}
});
return params;
}
/**
* 构造 iframe 用的 HTML 渲染 URL:{@code /api/report/render/{id}?format=html&k=v&...}。
* {@code templateId} 路径段与各参数键值均经 UTF-8 URL 编码 —— 该 URL 最终被注入 amis html 列的
* {@code <iframe src="${__url}">},编码确保任何特殊字符({@code " & # / < >})都不会破坏 query 结构
* 或逃逸出 src 属性(防注入,安全评审防御纵深)。templateId 实为 view_template_id(UUID),编码对其无副作用。
*/
static String buildFrameUrl(String templateId, Map<String, String> params) {
StringBuilder sb = new StringBuilder("/api/report/render/")
.append(URLEncoder.encode(templateId == null ? "" : templateId, StandardCharsets.UTF_8))
.append("?format=html");
if (params != null) {
params.forEach((k, v) -> sb.append('&')
.append(URLEncoder.encode(k, StandardCharsets.UTF_8))
.append('=')
.append(URLEncoder.encode(v == null ? "" : v, StandardCharsets.UTF_8)));
}
return sb.toString();
}
/** 把单条 URL 包成 amis CRUD 单行信封:{@code {status:0,msg:"",data:{items:[{__url}],total:1}}}。 */
static Map<String, Object> frameResult(String url) {
Map<String, Object> item = new LinkedHashMap<>();
item.put("__url", url);
Map<String, Object> data = new LinkedHashMap<>();
data.put("items", List.of(item));
data.put("total", 1);
Map<String, Object> env = new LinkedHashMap<>();
env.put("status", 0);
env.put("msg", "");
env.put("data", data);
return env;
}
/** templateId / ?tpl 解析为模板文件路径。 */
private Path resolveTemplate(String templateId, String tplPath) {
Path xml;
@@ -114,7 +195,11 @@ public class ReportController {
return xml;
}
/** 除 format/tpl 外的查询参数 = 报表参数(只取第一个值)。 */
/**
* {@code /render} 端点的报表参数 = 请求参数剔除渲染控制位 {@code format}/{@code tpl}(仅此两位)。
* 不剥 {@code page}/{@code perPage} —— 保持本端点<strong>原有行为不变</strong>(与 frame 端点的
* {@link #reportParamsFrom} 有意分流:仅 crud 驱动的 frame 才会带分页位需要剥离)。
*/
private Map<String, String> collectReportParams(HttpServletRequest request) {
Map<String, String> params = new LinkedHashMap<>();
request.getParameterMap().forEach((name, values) -> {

View File

@@ -0,0 +1,89 @@
package com.eip4.platform.report;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import org.junit.jupiter.api.Test;
/**
* Phase 3 报表查看器:{@code GET /api/report/frame/{templateId}} 的纯逻辑单测。
*
* <p>该端点把报表查询参数回显成 amis CRUD 单行信封 {@code {status:0,data:{items:[{__url}],total:1}}},
* {@code __url} 指向 {@code /api/report/render/{id}?format=html&<查询参数>}。报表页是一个 amis {@code crud}
* (查询条件落在 {@code crud.filter} —— 唯一能让 picker 正常加载的上下文),其单个 html 列把 {@code __url}
* 渲成 {@code <iframe>},于是「选工程→查询」时 crud 携 filter 参数请求本端点 → iframe 刷新报表。
*/
class ReportFrameTest {
@Test
void reportParamsFrom_strips_crud_and_format_control_params() {
Map<String, String[]> raw = new LinkedHashMap<>();
raw.put("PROJECTID", new String[]{"P-001"});
raw.put("format", new String[]{"amis"});
raw.put("tpl", new String[]{"/abs/x.xml"});
raw.put("page", new String[]{"1"});
raw.put("perPage", new String[]{"10"});
Map<String, String> params = ReportController.reportParamsFrom(raw);
assertEquals("P-001", params.get("PROJECTID"));
assertFalse(params.containsKey("format"), "format 应被剔除");
assertFalse(params.containsKey("tpl"), "tpl 应被剔除");
assertFalse(params.containsKey("page"), "page 应被剔除");
assertFalse(params.containsKey("perPage"), "perPage 应被剔除");
}
@Test
void reportParamsFrom_keeps_first_value_and_skips_blank_keys() {
Map<String, String[]> raw = new LinkedHashMap<>();
raw.put("A", new String[]{"first", "second"});
raw.put("B", new String[]{}); // 空值数组 → 跳过
raw.put("C", null); // null → 跳过
Map<String, String> params = ReportController.reportParamsFrom(raw);
assertEquals("first", params.get("A"));
assertFalse(params.containsKey("B"));
assertFalse(params.containsKey("C"));
}
@Test
void buildFrameUrl_points_at_html_render_and_url_encodes_params() {
Map<String, String> params = new LinkedHashMap<>();
params.put("PROJECTID", "66e5/7e6d &x"); // 含需转义字符
params.put("DEPT", "研发部"); // 中文
String url = ReportController.buildFrameUrl("5558497f-id", params);
assertTrue(url.startsWith("/api/report/render/5558497f-id?format=html"), url);
// 值被 URL 编码(空格/&// 不会破坏 query 结构;中文按 UTF-8 %xx)
assertTrue(url.contains("PROJECTID=66e5%2F7e6d+%26x"), url);
assertTrue(url.contains("DEPT=%E7%A0%94%E5%8F%91%E9%83%A8"), url);
// 未编码的裸 "&x" 不应出现(否则会被当成新参数 x)
assertFalse(url.contains("&x"), url);
}
@Test
void buildFrameUrl_no_params_is_just_html_render() {
String url = ReportController.buildFrameUrl("abc", new LinkedHashMap<>());
assertEquals("/api/report/render/abc?format=html", url);
}
@Test
@SuppressWarnings("unchecked")
void frameResult_is_single_row_amis_crud_envelope() {
Map<String, Object> env = ReportController.frameResult("/api/report/render/x?format=html");
assertEquals(0, env.get("status"));
Map<String, Object> data = (Map<String, Object>) env.get("data");
assertEquals(1, data.get("total"));
List<Map<String, Object>> items = (List<Map<String, Object>>) data.get("items");
assertEquals(1, items.size());
assertEquals("/api/report/render/x?format=html", items.get(0).get("__url"));
}
}