夜雨聆风学习资料网

ARTICLE · 1392072

Java PDF 折线图多系列配置:jquick-pdf 工单报表实战

Java PDF 折线图多系列配置:jquick-pdf 工单报表实战
标签
jquick-pdf · Java PDF · 报表开发 · 折线图 · SLA
摘要
政务热线的工单 SLA 月报,要在一张图里放受理、处理、办结、超期四条时长曲线,量纲相同、量级差三倍。最容易踩的不是画图,是"把 48 个数据标签全打开"——图直接糊死。本文按立靶、选型、配色规则、刷新时序、分页与核对拆这条链路,附季度均值逐项验算。
一、一张图塞四条线
政务热线每月要出一份工单 SLA 月报:四条时长曲线——平均受理、平均处理、平均办结、超期工单平均超期,量纲都是小时,画在同一张图里,报给服务质量例会。
数据从工单管理系统出,口径是自然月。四条线的量级差得不少:受理在 1.1 到 2.4 之间,超期在 4.6 到 9.8 之间,最上面那条是最下面那条的四倍。Java 侧的结构不难,难的是几个配置决策:
12 个月 × 4 条线 = 48 个点,数据标签要不要全标出来?
四条线共用一根 Y 轴,纵轴上限谁说了算?
同一个库里 JLine 和 JMultiLineChartData 都能画折线,用哪个?
三个问题我都走了一遍弯路,下面按踩的顺序讲。
二、先打靶:48 个标签比不标还难读
画多系列折线图时,人的默认直觉是这样的:把每个点的数值都标出来,读者就不用对着坐标轴猜了,信息给得越足越好。
反了。
这份 Demo 里有两个开关:
●●●
chartData.setShowDataLabels(false);
chartData.setValueWithPercent(false);
如果开 setShowDataLabels(true),图上会出现 4 个系列 × 12 个月 = 48 个数据标签。相邻的点是 1.6 和 1.5 这种差值,标签直接叠在一起,比不标还难读——读者想看的趋势形状,被一层数字壳子盖住了。
setValueWithPercent(false) 是另一件事,它管数值是否按百分比展示。这份数据量纲是小时,不是占比,必须关掉,不然图例和标签的口径全错。
关掉标签之后,读数靠两条路补:
路径一 · 网格估算
setGridCount(6) 拉六条横向网格,读者按格子估量级——估得出"这条线在 4 小时上下",估不出小数点后一位。
路径二 · 表格精读
第二页的季度汇总表,四个季度加全年平均,20 个精确值全在表里。
所以图和表的分工是定死的:图看趋势形状——四条线是不是一起往下走、谁降得陡、哪个月有拐点;表看具体数值——一季度办结到底是 6.0 还是 5.9。想让一张图同时干两件事,通常两件都干不好。
三、两种折线写法怎么选
同一个库里有两个折线类:JLine 和 JMultiLineChartData。差别不在能画几条线——JLine 也能 option.series(a, b) 叠两条。
差别在坐标轴和画布的控制粒度:
形态一 · JLine
走 JOption 加 JCategoryAxis、JValueAxis 那套,轴是独立对象,图是系列集合。适合一两条线、轴配置简单的场景。
形态二 · JMultiLineChartData
把 x 轴标签、y 轴标题、网格数、点半径、文字色、页脚色全收进同一个数据对象,一块配完。这份报表要调的东西太多:网格 6 条、内点半径 2、外点半径 5、绘图区底色、轴色纯黑、网格浅灰——一个对象搞定。
四条线共用一套坐标轴的时候,"整包配置"的思路更顺手。代价是它不吃 JCategoryAxis,x 轴标签要单独给 chartData.setXAxisLabels(...)。
四、三条隐性规则
这三个约束不在 API 文档的显眼位置,但直接决定这张图"像不像一份能上报的材料"。
规则一,颜色跟语义走,不跟喜好走。
●●●
lineA.setLineColor(new Color(47, 85, 151)); // 深政务蓝
lineB.setLineColor(new Color(91, 155, 213)); // 浅蓝
lineC.setLineColor(new Color(197, 90, 17)); // 砖橙
lineD.setLineColor(new Color(127, 127, 127)); // 中灰
四条线的语义不一样:受理和处理是同一族指标,都是"环节内耗时",用同色系的深蓝和浅蓝,读者一眼归组,还能顺着深浅分主次——受理是入口,给深色。办结是端到端的总耗时,跨部门流转,性质变了,跳出蓝色用砖橙,让它从三条蓝线里跳出来。超期用中灰,因为它是"异常样本的平均值",灰色在报表里天然带"次要、参考"的意味,不该和三条主线争。
四条线的位置也有讲究:受理在最下(1.1–2.4)、处理其次(1.8–3.6)、办结再上(3.1–6.2)、超期最高(4.6–9.8)。画出来是四条几乎平行的下降曲线,从下往上正好是流程层级——越往后端耗时越长。这个堆叠关系是数据给的,配色别把它打乱。
setChartAreaColor(new Color(248,249,250)) 给绘图区铺一层几乎看不见的浅灰,比纯白柔和。坐标轴压成纯黑,网格用 220 的浅灰——网格比轴线淡,层次就出来了。
规则二,系列名和图例文案分开管。
●●●
lineA.setName("平均受理时长");
lineA.setLegendText("平均受理时长(小时)");
两个字段值几乎一样,区别只在后者多了"(小时)"。这不是冗余:name 是系列标识,保持短名;legendText 是图例上真正显示的文案,把单位写进去,读者就不用回 y 轴标题找量纲。单位一共出现在三个地方:y 轴标题、四条图例、页脚统计口径——这种重复在报表里是必要的,任何一处被裁掉,读者都要多推一步。
规则三,线宽 2.5 是折中,不是随手写的。四条线挤在 700pt 宽、380pt 高的画布里,setLineWidth(2.5f) 比常见的 2.0 粗一点——线太细,打印稿上会发虚;再粗,线条之间会糊在一起。屏显和打印是两个标准,定线宽之前先想这份 PDF 主要在哪看。
五、updateMaxValues 的时序
代码里有一行看着很没安全感的调用:
●●●
// 设置完折线数据后必须刷新 Y 轴最大值
chartData.updateMaxValues();
注释用了"必须"两个字。我第一反应是不刷新会怎样——四条线的最大值在 9.8 这一档,如果不算,纵轴上限可能停在默认刻度上,超期那条线就会顶着画布上沿甚至出界。
这套 API 里纵轴上限有两个开关:setAutoCalculateMax(true) 打开"跟着数据算"的模式,updateMaxValues() 是真正执行那次计算。数据是先灌进去的、图是后画的,两者之间没有自动联动,所以顺序是:四条线的数据设完 → 调一次刷新 → 再渲染。这一行要放在 setLineDataList(...) 之后、renderChart 之前,位置错了等于没算。
两个开关是配套的,只调其中一个都不完整。这份 Demo 两个都写了,我照着抄,没敢省。后半段链路和上一期一致:renderChart 返回一段完整的 <svg> 文本,bind 绑进模板的 ${svg} 占位符,容器只声明宽度、不声明高度,页面收窄时按原比例缩放。
六、分页、引导线和小反弹
分页是主动切的,不是排出来的。图表占 700pt 宽、380pt 高,加上抬头和图注,第一页基本满了;表格五行加六条结论再挤上来,结论会被切到第二页中间,非常难看。模板的处理是加一个强制分页:
●●●
<div>…图表区…</div>
<areaBreak></areaBreak>
<div>…季度汇总表…</div>
areaBreak 让图独占第一页,表格和结论从第二页顶上开始——读者翻页的动作和数据的分段对上了:第一页看趋势,第二页看数字和结论。这个标签整份模板只出现一次,加的时候留神别加在列表中间,把六条结论切成两半,那比不分页更糟。
抬头是另一处值得看的:borderBottom:4px solid #2F5597 一根粗蓝线压在标题下面,下面一行 flex 左右分栏——左边副标题,右边"统计周期加单位"。左边交代这张图看什么,右边交代口径,一行两件事。
表格第一列的左边框是 3px 深蓝,其余三边 1px 浅灰。四行季度加一行全年,第一列左侧都压着这根线,五行连起来是一条竖着的引导线,把视线钉在行首。
3 月和 8 月的反弹是真的。模板结论里有一句"3月、8月办结时长出现小幅反弹(5.9 / 4.7 小时)"。我对着数组核了:办结序列 6.2、5.8、5.9、5.5、…、4.6、4.7、4.3…,3 月比 2 月高 0.1、比 4 月高 0.4,8 月同样比前后各高 0.1 和 0.4。两处确实是局部上翘,整条线整体向下,只有这两处冒出小尖。
0.1 小时在图上几乎看不出来,但表格里读得出来。这种"数据里本来就有、但不显眼"的细节要不要写进结论,是个取舍:不写,读者自己发现会怀疑图画错;写了,等于承认流程里有两个卡点。模板选了后者,还给了归因——与月中集中交办和系统升级窗口重叠。
核数的时候我顺手验了季度均值:一季度受理 (2.4+2.1+1.9)÷3 = 2.13,表里 2.1;办结 (6.2+5.8+5.9)÷3 = 5.97,表里 6.0;超期 (9.8+9.2+8.6)÷3 = 9.2,对。四季度办结 (3.9+3.5+3.1)÷3 = 3.5,对。全年受理 19.6÷12 = 1.63,表里 1.6。降幅也对:办结 6.2→3.1 降 50.0%,超期 9.8→4.6 降 53.1%。
数字对不上时先查这四处,这是我踩出来的顺序:先查 x 轴标签和数值数组有没有错位,再查季度均值是不是按三个月算的,然后查百分比的分母用的是期初还是期末,末了查模板里的硬编码有没有跟着改。
四处里最容易漏的是第四条
结论区写死了六条,每条至少一个数字,源数据改一次,这十几处都得过一遍。它不在代码里,IDE 不会提示,只能靠人。
最后说顺序。setAutoCalculateMax 和 updateMaxValues 必须成对出现,且都卡在数据设完之后、渲染之前;bind 必须在 executeResource 之前;setFlexLayout(true) 要在 new JQuickPdfFactory(config) 之前——config 在构造那一刻就交出去了,这一条不是运行时约束,是注意力约束。
七、收尾
这张图回头看,真正决定成败的不是画图那几行,而是三个"要不要":标签要不要全开、颜色要不要按语义、反弹要不要写进结论。三个都答对了,图才像一份能上例会的材料。
下期写《工单报表的季度汇总表:五行数字怎么和折线图对得上》,还是这份模板,讲表格数字的核对与联动。
最后一个问题想听听同行的做法:多系列折线图的数据标签,你们是全关,还是只给最后一个点标数值?后者读数方便,但实现要多写一层。
jquick-pdf 实战 Vol.21
项目地址:https://github.com/paohaijiao/jquick-pdf
官网示例:https://www.jquick.org/jquick-pdf/demo/21_ticket_sla_line/

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料