ARTICLE · 1366387
jquick-pdf JBar 分组柱状图实战:项目审批月报从数据到 PDF
jquick-pdf JBar 分组柱状图实战:项目审批月报从数据到 PDF标签:jquick-pdf,项目监管,Java PDF,分组柱状图,报表开发 摘要:项目监管平台的月报要把受理、审批通过、退回补正三类数说清楚。本文按数据装配、SVG 渲染、模板落版的顺序走一遍 jquick-pdf 的分组柱实现,并核出"通过加退回不等于受理"的 79 件在办差额——通过率的分母只能是受理量。附完整源码与模板。项目地址:https://github.com/paohaijiao/jquick-pdf 一张月报要回答的三个问题 需求方给的原话很短:每个月受理多少、批下来多少、退回去多少。三个数放在一起,能回答的问题其实有三个——审批负荷在不在涨、办理质量有没有改善、哪个环节在拖。 这三个问题的答案形态不一样:负荷看总量趋势,质量看通过率,拖点看退回补正的绝对值和占比。三种看法要挤在一页纸上,图表选型就得兼顾"逐月对比"和"三类并列"。折线图能把趋势画得漂亮,但三条线在 1 月到 12 月之间会互相穿插,读者要花力气分辨哪根是哪根;分组柱每个月份站一组,三根柱高低立现,构成关系不用解释。 Demo 是 JQuickBiz17ProjectApprovalTest,模板 report/biz/17_project_approval.txt,输出 D:\test\biz\17_project_approval.pdf。 成品长什么样 一页 A4,从上到下一路排:居中的深蓝抬头(标题加两行元信息)、柱图加图注、五行季度汇总表、五条结论,页脚居中两行小字。 没有指标卡。这一点和很多经营类单据不同——审批月报的核心信息全在表和图的对应关系里,抽四个数字出来做卡反而会让人只看卡不看表。抬头也只占三行,省下来的高度全给了 700pt 宽的柱图。 图注写的是"图 1 2024年1-12月受理 / 审批通过 / 退回补正项目数量(数据来源:市项目审批监管系统)",把口径和来源都钉在图下面,评审问起来不用翻别处。 下方为真实渲染效果预览图(本地路径,粘贴进公众号后需在编辑器内重传素材库图片) 
三组数据,三个 JBar 数据装配是三步:建序列、灌数、挂到 option 上。 ●●● JBar accepted = newJBar(); accepted.name("受理").data( 142, 138, 155, 163, 158, 171, 182, 176, 195, 203, 214, 226); JBar approved = newJBar(); approved.name("审批通过").data( 112, 110, 124, 132, 128, 140, 150, 145, 161, 169, 178, 189); JBar returned = newJBar(); returned.name("退回补正").data( 22, 20, 24, 25, 23, 26, 27, 25, 28, 27, 29, 30); option.series(accepted, approved, returned); JBar 的 name() 是图例名,data() 收变长参数,12 个数对应 12 个月。三个序列的月份顺序必须完全一致,都从 1 月排到 12 月,错一个位置整张图的构成关系就反了。 序列顺序也有讲究:受理在最前、通过在中、退回在最后。分组柱按序列顺序从左到右排,这个顺序刚好是审批流程的时间顺序——先受理,再决定通过还是退回。图上每组柱子右起第一根永远是"受理",最高,读者扫一眼就知道那个位置代表总量。 x 轴是 12 个中文月份标签,JCategoryAxis 收进去就行: ●●● JCategoryAxis xAxis = newJCategoryAxis(); xAxis.data("1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"); option.xAxis(xAxis); option.yAxis(newJValueAxis()); JValueAxis 空构造,纵轴范围交给渲染器自己算,最大值会顶到 240 左右——受理 12 月的 226 是全年峰值,柱子差一点点碰到顶,视觉上刚好。 option.tooltip().trigger(JTrigger.axis) 这一行也在 Demo 里。柱图的分组结构下按轴触发是常规做法,不过 PDF 是静态的,悬停交互不存在,这行留着只是让配置结构和 Web 端保持一致。 从 SVG 到 PDF:三行代码 ●●● String svg = JChartRendererFactory.renderChart(JChartType.BAR, option); 枚举是 BAR,全大写。返回的是 SVG 字符串,不是图片文件,也不是 Base64。后面三行是固定动作:建目录、开流、写字节。 ●●● JPdfConfig config = newJPdfConfig(); // ★ 必须在构造工厂之前调,这是模板能正常排版的前提 config.getLayoutConfig().setFlexLayout(true); JQuickPdfFactory factory = newJQuickPdfFactory(config); factory.bind("svg", svg); byte[] bytes = factory.executeResource("report/biz/17_project_approval.txt"); setFlexLayout(true) 得在构造工厂之前调,这是这份模板能正常排版的前提。整份模板里 display:flex 只出现一次,就是图表容器那行 justifyContent:center;开关不打开,本来居中的图会贴到左边,整页重心跟着歪。 bind("svg", svg) 的名字对应模板里的 ${svg},不带花括号和美元符。executeResource 的路径是 classpath 相对路径,这份模板在 src/test/resources/report/biz/ 下,入参写 report/biz/17_project_approval.txt。 模板里的四处取舍 抬头走的是居中三行,不是左右分栏。textAlignment:center 加 #2F5597 实底、borderRadius:4px、padding:14px,标题 18pt 白色,下面两行 10pt 白色写统计周期和编制单位加报送对象。整个色块是"封面"的逻辑,视线从正中垂下来,直接落到第一根柱子上。文档型月报用这种抬头更稳,因为下面的表格和柱图都是满宽布局,抬头再分左右栏会和正文抢重心。 图表区没有包底色面板。柱图本身的视觉分量就重,外面再套一层浅底卡片,页面会显得碎;这份模板让图直接坐在白底上,靠章节标题上方的留白和一行图注把区域框住。 表格是全边框加斑马纹。五列宽度 120 / 110 / 110 / 110 / 110,加起来正好 560px,表头深蓝反白,数据行奇偶交替用 #EAF1F8。合计行没有反白,只加粗,靠"整行文字变粗"来收口——这是全表和表头唯一的呼应方式,克制得很。 字号全篇用 pt:18pt、13pt、10pt、9pt、8pt。一份模板里单位要统一,混着写会出现"标题看着比预期大一号"的问题。 数一遍:2,123 件和 79 件在办 模板里的合计数是硬编码的,我拿代码里的数据核了一遍。 受理四个季度:142+138+155=435,163+158+171=492,182+176+195=553,203+214+226=643。全年 2,123,和合计行一致。通过:346、400、456、536,合计 1,738。退回:66、74、80、86,合计 306。 对的时候发现一个值得说的地方:受理不等于通过加退回。一季度 435 减 346 减 66 等于 23,二季度 18,三季度 17,四季度 21,全年差 79 件。这 79 件是"在办"——期末还挂在流程里、既没通过也没退回的项目。这个差值不是数据错误,是审批流程的正常沉淀,但它意味着通过率的分母只能是受理量,不能拿通过加退回当分母。模板算的 81.9% 就是 1,738 ÷ 2,123,逻辑是对的。 其余几个数也对得上:四季度受理 643 对一季度 435,增长 47.8%;通过率从 79.5% 爬到 83.4%;退回占比从 15.2% 降到 13.4%(66÷435 和 86÷643);全年退回 306 件除以 12 个月等于 25.5 件。结论区的五条文字,每一条都能在表里找到出处。 这一步不能省。这份模板的结论里写死了十几个数字,改一次源数据就得回头把这十几处过一遍,少改一处,PDF 里就会出现"图上 12 月是峰值、结论里说 11 月最高"的硬伤。 落地前先定下来的两件事 一件事是口径。受理量到底含不含撤件、退回补正算不算一次重新受理、在办余额要不要单独列一行——这三个问题不定,图表画得再准也会被业务方推翻。这份 Demo 的处理是把在办留在差额里不显式呈现,简单,但月报看久了总会有人问"为什么通过加退回不等于受理"。我后来的做法是在表下加一行"期末在办",把 23 / 18 / 17 / 21 摆出来,争议立刻消失。 另一件事是数据源。现在这份代码里的 36 个数字是写死的,真实场景要从审批系统按自然月聚合,SQL 里 GROUP BY 月份加状态,出来的结果按状态拆成三个数组,顺序对齐 1 到 12 月。中间任何一个月没有数据,要补 0 而不是跳过——跳过会让后面的月份整体前移,x 轴标签就对不上了。 复现清单 1. 依赖 io.github.paohaijiao:jquick-pdfx:4.7.0+(Apache-2.0 协议) 2. new JOption(),链式设标题与副标,tooltip().trigger(JTrigger.axis) 3. JCategoryAxis.data(...) 排 12 个月标签,option.yAxis(new JValueAxis()) 4. 三个 JBar 依次 name() 和 data(),顺序按受理、通过、退回,再 option.series(...) 5. JChartRendererFactory.renderChart(JChartType.BAR, option) 拿 SVG 字符串 6. JPdfConfig 开 setFlexLayout(true) 后构造 JQuickPdfFactory,先 bind("svg", svg) 再 executeResource("report/biz/17_project_approval.txt") 7. 建目录写字节,验证 D:\test\biz\17_project_approval.pdf 8. 核对季度合计 2,123 / 1,738 / 306 与在办差额 79 件 收尾:jquick-pdf 实战 Vol.17 下一篇:《jquick-pdf 区域分布报表实战:一份 21 行明细表的版式解剖与地图嵌入》——同一套工厂管线换到表格式报表,重点从图换成版式:21 行明细表怎么画才不散、行政区划底图给多宽才不糊。 留一个具体问题:你们月报里"通过加退回对不上受理"的那部分在办量,是留在差额里不显式呈现,还是在表下单列一行"期末在办"? 项目地址:https://github.com/paohaijiao/jquick-pdf
官网:https://www.jquick.org/jquick-pdf/ 完整源码附录(Java 测试类 + PDF 模板全文)请看 CSDN 版文末,或回复 pdf 领取示例工程;公众号正文不塞长源码。

官网:https://www.jquick.org/jquick-pdf/















































































