ARTICLE · 1379314
jquick-pdf 五级分类饼图,1.7% 那一档画不画
jquick-pdf 五级分类饼图,1.7% 那一档画不画标签:jquick-pdf,信贷风控,Java PDF,饼图,五级分类 摘要:贷款五级分类要在一页纸上说清资产质量,饼图最省字也最容易误用。先答三个选型问题——为什么用它、什么时候换掉、集成成本多大,再拆 JPie 与 JData 装配、item 级触发、红主题模板的左肩线标题与三色风险状态列,末尾把 9,080 笔和五个占比核了一遍。项目地址:https://github.com/paohaijiao/jquick-pdf 三句话先把选型定了 做信贷风险报告的人看到饼图,第一反应通常是"又要画个饼"。所以我先把三个会被追问的问题摆出来,答案先给,理由后面展开。 用不用它?用。五个风险档位是互斥且穷尽的分类,加起来正好是全体资产,这种"部分对整体"的关系是饼图唯一真正擅长的场景。 什么时候不用?某档占比低于 3% 的时候。这份数据里损失类只有 150 笔、1.7%,扇形角度不到 6 度,画出来是一条缝,标签还得往外拉。 成本多大?二十来行代码,两个坑。一个在数据装配的命名上,一个在触发方式上,都在下面。 素材是 JQuickBiz19OverdueLoanPieTest,模板 report/biz/19_overdue_loan_pie.txt,输出 D:\test\biz\19_overdue_loan_pie.pdf。 下方为真实渲染效果预览图 
问一:这个场景为什么选饼图 五级分类有一个别的图表替代不了的性质:五档之和就是 100%。正常、关注、次级、可疑、损失,一笔贷款必属其一,不存在第六种情况,也不存在一笔记两档。 这决定了读者看图的方式。柱状图里读者比的是柱高,关心"哪个多";饼图里读者比的是扇形面积占整个圆的比例,关心"占多少"。风险报告里真正要回答的是后者——不良率 10.9% 这个数字,比"次级比可疑多一倍"重要得多。 JPie 的装配是这样的: ●●● JPie pie = newJPie("逾期账龄分布"); pie.data( newJData().name("正常").value(6850), newJData().name("关注").value(1240), newJData().name("次级").value(560), newJData().name("可疑").value(280), newJData().name("损失").value(150) ); option.series(pie); JPie 构造收一个字符串,是系列名。data() 收变长的 JData,每个 JData 链式给 name 和 value。扇形的先后顺序就是这里的书写顺序,正常类 75.4% 一个人占了四分之三个圆,是整个饼的底色。 这里有个我先入为主踩到的点:那个构造参数写的是"逾期账龄分布",而这组数据是五级分类,两者不是一回事。账龄是逾期 30 天、60 天、90 天那套口径,五级分类是监管口径的资产质量分档。系列名会跟着图例和提示信息走,名字挂错了,图对但标签是错的。我在自己项目里改成了"贷款五级分类构成"。 option.tooltip().trigger(JTrigger.item) 这一行和柱图、折线图不一样,用的是 item 而不是 axis。饼图没有坐标轴可以挂,鼠标落在哪个扇形上就是哪个数据项,按项触发是唯一合理的做法。PDF 里没有悬停,这行留着不影响出图,但配置语义别照抄柱图那份。 问二:什么时候我会把饼图换掉 三种情况。 第一种是档位太多。五档是饼图的上限,六档以上扇形开始挤,颜色也不够分。真到了七八档,我会换成横向条形图按值排序,条形长度比扇形角度好读得多。 第二种是小占比档位有业务含义。这份数据里损失类 150 笔,占 1.7%,但"损失类"恰恰是风险报告最需要盯的一档,把它压成一条 6 度的缝,等于把最重要的信息藏起来。这种时候的处理有两个方向:一是把次级、可疑、损失合并成"不良"一个大扇形,再在表里拆开;二是干脆换成条形图,让 1.7% 也有完整的一行。 第三种是要看变化。饼图只能表达某一时点的构成,两张饼并排放也很难比出差异——人对扇形面积差的敏感度远不如对长度差。月度、季度对比必须上柱图或者折线。 这份报告的处理方式是折中的:图还是饼图,但在图上方的"核心结论"里把 990 笔、10.9% 这个合并值直接写成一句话。饼图负责让读者看到"正常类占了大半",文字负责把"不良 10.9%"这个必须被看见的数字摁在读者眼前。图和文各干一件事,谁都不勉强。 问三:集成成本到底多大 去掉 import 和目录创建,核心就三段:装配、渲染、落盘。 ●●● String svg = JChartRendererFactory.renderChart(JChartType.PIE, option); 枚举 PIE 全大写,返回 SVG 字符串。 ●●● JPdfConfig config = newJPdfConfig(); // ★ 构造工厂之前调,模板里的 display:flex 才生效 config.getLayoutConfig().setFlexLayout(true); JQuickPdfFactory factory = newJQuickPdfFactory(config); factory.bind("svg", svg); byte[] bytes = factory.executeResource("report/biz/19_overdue_loan_pie.txt"); 这段是所有图表单据的固定动作,setFlexLayout(true) 要在构造工厂之前。这份模板里 display:flex 只有图表容器一处,开关不打开,图会贴左。 两个坑都在前面提过:系列名"逾期账龄分布"和数据口径不符,JTrigger.item 不要照柱图的 axis 写。除此之外没有别的坑,饼图是这套 API 里配置最少的一种图——没有轴、没有网格、没有刻度,JOption 上只挂了 series 和 tooltip 两样东西。 红主题的克制:一份报告只用一种红 模板的配色值得单独说。整份文档只用了一个色系:#B71C1C 深红做主色,#FBECEC 浅红做底,#E8C4C4 做边框,#BF360C 做预警文字。四个色号,全在红色系里。 抬头是一张卡片: ●●● <div style="background:#FBECEC; border:1px solid #E8C4C4; borderLeft:6px solid #B71C1C; borderRadius:4px; padding:12px; marginBottom:10px; keepTogether:true"> <h1 style="color:#B71C1C; fontSize:17pt; bold:true; marginBottom:4px">'贷款五级分类资产质量报告'</h1> <p style="color:#5A6B7C; fontSize:9pt">'报告编号:CR-2024-Q3-019 | 生成日期:2024年10月8日 | 数据截止:2024年9月30日'</p> </div> 浅红底加 1px 浅红边,左肩压一根 6px 深红竖线。风险类文档用红,但不能满页红——满页红读者会麻木,反而感觉不到风险。这里的处理是把红压进边框和文字,底色只用最浅的一档,整页看过去是"白纸上有红字",不是"红纸"。 章节标题是另一种形态: ●●● <div style="borderLeft:4px solid #B71C1C; paddingLeft:8px; marginBottom:6px"> <h2 style="color:#B71C1C; fontSize:13pt; bold:true; marginTop:0px; marginBottom:0px">'二、五级分类明细'</h2> </div> h2 外面包一层带左肩线的 div,标题自己 margin:0,靠外层 paddingLeft:8px 把文字推离竖线。三个一级标题全是这个结构,左肩线 4px、和抬头那根 6px 形成主次——抬头是文档级,章节是区块级,线宽差 2px 就把层级说清楚了。 表格是标准的红底表头加全边框,四列 150 / 140 / 130 / 140 合计 560。最后一列"风险状态"是全表唯一带颜色的数据列:正常类标"达标"用绿色 #1B5E20,关注类标"关注"用橙色 #BF360C,次级、可疑标"预警",损失标"超标",后三个都是橙色加粗。 这一列是整张表的信息浓缩。读者不用去记 6.2% 算不算高,直接看"预警"两个字就知道该不该紧张。绿色只出现一次,橙色出现四次,一绿四橙的分布和图上的构成是一致的——正常类是多数,风险档位是少数但需要盯着。 第三个区块的列表用的是 <list style="paddingLeft:18px; fontSize:10pt" listType="ordered">,靠 listType="ordered" 出数字序号,不是 listStyleType。这两套写法在模板里都出现过,改的时候看清楚手上这份用的是哪个。 核对一遍:9,080 笔是怎么来的 模板里所有百分比都是硬编码,我把它们从代码里的五个数算了一遍。 总数:6850 + 1240 + 560 + 280 + 150 = 9,080,和抬头下面那句"三季度末信贷资产 9,080 笔"、明细表合计行、以及核心结论里的 9,080 全部一致。 占比:6850 ÷ 9080 = 75.44%,表里 75.4%;1240 ÷ 9080 = 13.66%,13.7%;560 ÷ 9080 = 6.17%,6.2%;280 ÷ 9080 = 3.08%,3.1%;150 ÷ 9080 = 1.65%,1.7%。 不良合计:560 + 280 + 150 = 990,990 ÷ 9080 = 10.90%,结论里写 10.9%,对。但表里三项占比 6.2 + 3.1 + 1.7 = 11.0%,和 10.9% 差 0.1 个百分点——这是三个数各自四舍五入后相加的尾差,不是算错。明细表里逐项列百分比、结论里给合并值,两处口径不同,读者拿计算器一加会觉得对不上。想彻底避免,就在表下加一句"占比四舍五入保留一位小数,合计可能存在 0.1 个百分点尾差"。 还有一个数:关注类比正常类低 61.7 个百分点,75.4 - 13.7 = 61.7,结论第一条里引用的就是这个差值。 五个数改动任意一个,模板里至少要跟着动六处:四个百分比、不良合计的笔数与占比、结论里的 61.7。这类单据最怕的就是只改图不改文,PDF 出来图上正常类是 70%,表里还写着 75.4%。 复现清单 1. 依赖 io.github.paohaijiao:jquick-pdfx:4.7.0+(Apache-2.0 协议) 2. new JOption(),设标题与副标,tooltip().trigger(JTrigger.item) 3. new JPie("贷款五级分类构成"),data() 里按正常到损失顺序给五个 new JData().name(...).value(...) 4. option.series(pie),renderChart(JChartType.PIE, option) 取 SVG 5. JPdfConfig 先 setFlexLayout(true),再构造 JQuickPdfFactory 6. bind("svg", svg) 后 executeResource("report/biz/19_overdue_loan_pie.txt"),写 D:\test\biz\19_overdue_loan_pie.pdf 7. 核对 9,080 总数、75.4 / 13.7 / 6.2 / 3.1 / 1.7 五个占比与 990 笔不良合计 收尾:jquick-pdf 实战 Vol.19 下一篇:《jquick-pdf 环形图实战:跟着 3,180 户走完 Java 生成信用等级分布 PDF 的全程》——同一个"部分对整体"的问题换成环形图,中心空洞拿来放总量,全程按装配到落盘走一遍。 回复 pdf 领示例工程源码,Demo 19 的测试类和这份红主题模板都在里面。 留一个具体问题:五级分类这种小占比但有业务含义的档位,你是合并成"不良"一个大扇形,还是在表里单列一行把 1.7% 摆出来? 项目地址:https://github.com/paohaijiao/jquick-pdf
官网:https://www.jquick.org/jquick-pdf/ 完整源码附录(Java 测试类 + PDF 模板全文)请看 CSDN 版文末,或回复 pdf 领取示例工程;公众号正文不塞长源码。

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















































































