jquick-pdf 生成年度预算执行进度 PDF:横向条形图画预算执行率的评审问答实录
摘要(meta description):市财政局五部门预算执行进度汇报,jquick-pdf 4.7.0+(Apache-2.0 协议)用横向条形图"预算下达 vs 已执行"双系列替代进度条。本文模拟评审会连环追问组织全文:进度图去哪了、为什么不画百分比、数据标签挤不挤、虚线分隔怎么画,每节回答一个追问,附完整 Java 源码与模板。
标签 :jquick-pdf、Java PDF、报表开发、预算执行
官网示例:
- FORMULAS 示例页:www.jquick.org/jquick-pdf/...
- github 地址:github.com/paohaijiao/...
真实渲染效果预览
以下为上述代码 + 模板真实运行生成的 PDF 首屏预览(由 jquick-pdf 渲染输出,非示意图):

评审会上被问住的地方
这份 JQuickBiz24BudgetProgressTest 我调完模板拿去给业务处室预审,原以为是走个流程,结果被追问了一下午。追问不一定都有标准答案,但每一个都逼我把配置里的某个决定想清楚。把问答整理成文,输出路径 D:\test\biz\24_budget_progress.pdf,主题政务深蓝 #1F4E79。(效果预览图 alt:jquick-pdf 年度预算执行进度 PDF,深蓝主题,五部门预算下达与已执行横向条形图居中,执行率明细表与进度分析铺底)
追问一:要的是进度图,怎么变成两根条形了?
这是评审的第一问,也是我准备最充分的一问。jquick-pdf 暂无进度图(进度条)渲染器,Demo 的 Javadoc 原话是:用「预算下达 vs 已执行」两条横向条形并列的方式替代进度图,执行率由两段条形的长度对比直观呈现。替代逻辑成立------执行率本来就是两个量的比值,进度条画的是比值本身,双条形画的是比值的两端,长度差就是执行率。汇报的效果甚至更好:领导看双条形能同时看到绝对规模(教育局 12800 万下 11260 万)和相对进度,进度条只剩后者。
java
List<Double> budget = Arrays.asList(12800.0, 9600.0, 8400.0, 6200.0, 5100.0);
List<Double> executed = Arrays.asList(11260.0, 8120.0, 6930.0, 5480.0, 4320.0);
chartData.addBarData(new JHorizontalBarChartData.BarData("预算下达", budget, JHorizontalBarChartData.COLOR_A));
chartData.addBarData(new JHorizontalBarChartData.BarData("已执行", executed, JHorizontalBarChartData.COLOR_B));
两个系列的颜色直接用数据类自带的 COLOR_A、COLOR_B 常量,没有另配。源码注释里写了句"颜色沿用政务系统低饱和主色",这两个常量的低饱和风格和模板 #1F4E79 的政务蓝确实压得住场面,我试过自己换成高饱和红绿对比,图一下子变得像促销海报,改回来了。
追问二:执行率为什么不直接画在图上?
评审的第二问。图表用 setValueWithPercent(false) 明确关掉了百分比模式------条形长度按金额绝对值走,横轴是"金额(万元)"。我的回答是分工:图负责规模对比,执行率的精确数值放"二、分部门预算执行明细"表里。表里教育局 87.97%、卫健委 84.58%、交通局 82.50%、农业农村局 88.39%、民政局 84.71%,合计行 85.77%,这些两位小数画在条形上要么挤成一团要么四舍五入失真,放进表格右对齐一列才是它该待的地方。评审接受了这个说法,补了一句要求:表格里执行率旁的进度评价要用颜色区分------于是"进度达标""正常推进""进度领先"用 #1B5E20 绿色加粗,交通局的"预警关注"用 #BF360C 橙红加粗,五个部门扫一眼就知道谁出问题。
追问三:五个部门十条柱,数据标签开了不挤吗?
java
chartData.setShowDataLabels(true);
chartData.setValueWithPercent(false);
setShowDataLabels(true) 开启条形端点的数值标签,十个数标在图上。实际渲染不挤,原因是横向条形的标签在条形末端外侧,条形之间纵向留白足够。我做过对比:关掉标签后图变干净了,但"预算下达 12800、已执行 11260"这种关键数值全靠对横轴刻度估读,评审当场表示要数值。这组配置的最后一块是轴标题,setXAxisTitle("金额(万元)") 和 setYAxisTitle("部门"),加上图表自己的标题副标题:
java
chartData.setTitleText("2024年度各部门预算执行进度");
chartData.setSubtitleText("预算下达额与已执行额对比(截至2024年9月30日)");
注意这组是 JHorizontalBarChartData 自带的标题体系,渲染进 SVG 里,模板抬头那句"预算下达额与已执行额对比(截至2024年9月30日,单位:万元)"是另一份文案------图内图外各说各的,我一度以为是重复配置,删掉 SVG 里的标题后图变成无头图,才知道这套数据类的标题是画进图里的。
追问四:Y 轴的部门顺序为什么不是表里的顺序?
java
chartData.addYAxisLabel("教育局");
chartData.addYAxisLabel("卫健委");
chartData.addYAxisLabel("交通局");
chartData.addYAxisLabel("农业农村局");
chartData.addYAxisLabel("民政局");
addYAxisLabel 按调用顺序从上往下(或从下往上,看渲染方向)铺部门,数值列表 budget、executed 的下标和它一一对应:12800 是教育局、9600 是卫健委。我答"表里什么顺序图里就什么顺序"时被追问"那为什么不按执行率排序",老实承认是沿用了预算下达额的报送顺序------政务报告里部门排序有惯例,不能自作主张按数据重排。这就是 addYAxisLabel 一个个加而不是传数组的好处:顺序改动只动五行调用,不用去数数组元素。
追问五:分析区每条上面的虚线是什么?
"三、进度分析与下半年建议"的四条分析,每条顶上都有一道虚线:
html
<li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">
'总体进度:五个部门预算下达合计 42,100 万元,已执行 36,110 万元,整体执行率 85.77%,略高于序时进度。'
</li>
borderTop:1px dashed #C7C7C7 加 paddingTop:6px,虚线悬在文字上方当分隔,比实线轻、比纯留白清楚。评审问"为什么不用圆点列表",答:这四条是并列结论不是枚举项,虚线分隔的段落感更适合"总体进度 / 领先部门 / 预警部门 / 下半年建议"这种带小标题的长句。四条内容我顺带讲了一遍:领先的是农业农村局 88.39% 和教育局 87.97%,预警的交通局 82.50% 低于整体 3.27 个百分点、原因挂在工程招标进度滞后上,建议部分给交通局上项目清单周调度、同时提醒执行率超 87% 的部门防年末突击支出。
追问六:页尾那条水平线是谁画的?
html
<lineSeparator style="strokeColor:#DCE3EC"></lineSeparator>
<p style="color:#6c757d; fontSize:8; marginTop:8px">'数据来源:市财政局预算管理一体化系统 | 生成时间:2025年10月8日 | 密级:内部'</p>
不是 div 的 borderTop,是模板引擎自己的 <lineSeparator> 元素,strokeColor:#DCE3EC 控制线条颜色。我最初用空 div 画线,评审问"这条线为什么和上面小字的间距这么大",div 的 margin 折叠行为和 lineSeparator 不一样。数据来源、生成时间、密级三段用竖线串成一行 8 号灰字,压在页尾。
分节标题的样式评审也点过名:每节标题外套一层 backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px 的浅蓝底色条,标题文字 #1F4E79 加粗------三节统一,和表格表头同色系,页面骨架清晰。明细表整体 540px 宽、10 号字,表头 #1F4E79 实底,数据行的隔行垫色正是这套 #E8F0F7,和节标题色条同源;合计行整行垫色加粗,42,100、36,110、85.77% 三个合计数压在页表底部,评审核对总数时第一眼就落在那儿。
抬头是 background:#1F4E79 的居中卡片:18 号白字大标题,下面两行 10 号说明------"预算下达额与已执行额对比(截至2024年9月30日,单位:万元)"白字,"编制单位:市财政局预算管理科 | 报送对象:市政府常务会议"用 #CFE0EF 淡一档。卡片套 keepTogether:true 防分页拦腰切。政务报告抬头写报送对象这点值得保留,谁收这份文件、文件口径到哪天,抬头两行就说清了。图表区照例是 display:flex; justifyContent:center 的居中容器,svg 声明 width:700pt 不写高度,宽度被收窄时等比缩放;图下 9 号斜体图注"图 1 五个业务部门预算下达与已执行对比(数据来源:预算管理一体化系统)"把数据出处钉在图边。Java 侧照例一行 config.getLayoutConfig().setFlexLayout(true),源码注释写明是使模板中的 display:flex 生效(图表居中),那个居中容器全靠它。
复现清单
- 依赖
io.github.paohaijiao:jquick-pdfx:4.7.0+(Apache-2.0 协议); JHorizontalBarChartData配标题、副标题、双轴标题,setValueWithPercent(false)、setShowDataLabels(true);addYAxisLabel按报送顺序铺部门,两个系列addBarData挂COLOR_A/COLOR_B;option.setData(chartData)后JChartRendererFactory.renderChart(JChartType.HorizontalBar, option)出 SVG;JPdfConfig开setFlexLayout(true);- 明细表执行率列配绿/橙评价色,分析区用
borderTop:1px dashed虚线分隔,页尾用<lineSeparator>; - 输出验证
D:\test\biz\24_budget_progress.pdf。
完整源码附录
java
/*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright (c) [2025-2099] Martin (goudingcheng@gmail.com)
*/
package com.github.paohaijiao.biz.chart;
import com.github.paohaijiao.JOption;
import com.github.paohaijiao.combol.JHorizontalBarChartData;
import com.github.paohaijiao.config.JPdfConfig;
import com.github.paohaijiao.demo.constant.JQuickConstant;
import com.github.paohaijiao.enums.JChartType;
import com.github.paohaijiao.executor.JQuickPdfFactory;
import com.github.paohaijiao.factory.JChartRendererFactory;
import org.junit.Test;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
/**
* 业务场景 Demo 24:年度预算执行进度仪表盘(政务/企业财务)
*
* <p>业务场景:市财政局预算管理科跟踪各业务部门年度预算下达额与已执行额,用于市政府常务会议预算执行进度汇报。</p>
* <p>实际图表类型:{@link JChartType#HorizontalBar} 横向条形图。jquick-pdf 暂无进度图(进度条)渲染器,
* 因此用「预算下达 vs 已执行」两条横向条形并列的方式替代进度图,执行率由两段条形的长度对比直观呈现。</p>
*
* <p>模板:{@code report/biz/24_budget_progress.txt};图表以 SVG 文本形式绑定到模板的
* {@code ${svg}} 占位符,输出到 {@code D:\test\biz\24_budget_progress.pdf}。</p>
*
* <p>图表尺寸说明:图表按 700pt 宽的横版比例设计;模板中 {@code <svg>} 只声明宽度、不声明高度,
* 宽度被页面自动收窄时高度会按原比例同步缩放,不会纵向拉伸变形。</p>
*
* @author Martin
* @version 1.0.0
*/
public class JQuickBiz24BudgetProgressTest {
public static final String path = JQuickConstant.path;
@Test
public void biz24BudgetProgress() throws IOException {
JHorizontalBarChartData chartData = new JHorizontalBarChartData();
chartData.setTitleText("2024年度各部门预算执行进度");
chartData.setSubtitleText("预算下达额与已执行额对比(截至2024年9月30日)");
chartData.setXAxisTitle("金额(万元)");
chartData.setYAxisTitle("部门");
chartData.setValueWithPercent(false);
chartData.setShowDataLabels(true);
chartData.addYAxisLabel("教育局");
chartData.addYAxisLabel("卫健委");
chartData.addYAxisLabel("交通局");
chartData.addYAxisLabel("农业农村局");
chartData.addYAxisLabel("民政局");
// 两条系列分别表示预算下达额与已执行额,颜色沿用政务系统低饱和主色
List<Double> budget = Arrays.asList(12800.0, 9600.0, 8400.0, 6200.0, 5100.0);
List<Double> executed = Arrays.asList(11260.0, 8120.0, 6930.0, 5480.0, 4320.0);
chartData.addBarData(new JHorizontalBarChartData.BarData("预算下达", budget, JHorizontalBarChartData.COLOR_A));
chartData.addBarData(new JHorizontalBarChartData.BarData("已执行", executed, JHorizontalBarChartData.COLOR_B));
JOption option = new JOption();
option.setData(chartData);
String svg = JChartRendererFactory.renderChart(JChartType.HorizontalBar, option);
File dir = new File(path + "biz");
if (!dir.exists()) {
dir.mkdirs();
}
FileOutputStream fileOutputStream = new FileOutputStream(path + "biz/24_budget_progress.pdf");
JPdfConfig config = new JPdfConfig();
// 开启 flex 行布局,使模板中的 display:flex 生效(图表居中)
config.getLayoutConfig().setFlexLayout(true);
JQuickPdfFactory factory = new JQuickPdfFactory(config);
factory.bind("svg", svg);
byte[] bytes = factory.executeResource("report/biz/24_budget_progress.txt");
fileOutputStream.write(bytes);
fileOutputStream.close();
}
}
html
<pdf>
<body>
<div style="textAlignment:center; marginBottom:12px; padding:14px; background:#1F4E79; borderRadius:4px; keepTogether:true">
<h1 style="textAlignment:center; color:white; marginBottom:6px; fontSize:18; bold:true">'2024年度各部门预算执行进度'</h1>
<p style="textAlignment:center; color:white; fontSize:10; margin:2px">'预算下达额与已执行额对比(截至2024年9月30日,单位:万元)'</p>
<p style="textAlignment:center; color:#CFE0EF; fontSize:10; margin:2px">'编制单位:市财政局预算管理科 | 报送对象:市政府常务会议'</p>
</div>
<div style="marginBottom:12px">
<div style="backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px; marginBottom:8px">
<h2 style="color:#1F4E79; fontSize:13; bold:true; marginTop:0; marginBottom:0">'一、各部门预算执行总体情况'</h2>
</div>
<div style="display:flex; justifyContent:center">
<svg style="width:700pt">${svg}</svg>
</div>
<p style="fontSize:9; color:#6c757d; italic:true; marginTop:6px">'图 1 五个业务部门预算下达与已执行对比(数据来源:预算管理一体化系统)'</p>
</div>
<div style="marginBottom:12px">
<div style="backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px; marginBottom:8px">
<h2 style="color:#1F4E79; fontSize:13; bold:true; marginTop:0; marginBottom:0">'二、分部门预算执行明细'</h2>
</div>
<table style="width:540px; fontSize:10">
<tr>
<th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'部门'</th>
<th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'预算下达(万元)'</th>
<th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'已执行(万元)'</th>
<th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'执行率'</th>
<th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'进度评价'</th>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'教育局'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'12,800'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'11,260'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'87.97%'</td>
<td style="padding:5px; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'进度达标'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'卫健委'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'9,600'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'8,120'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'84.58%'</td>
<td style="padding:5px; backgroundColor:#E8F0F7; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'正常推进'</td>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'交通局'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'8,400'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'6,930'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'82.50%'</td>
<td style="padding:5px; color:#BF360C; bold:true; border:1px solid #DCE3EC">'预警关注'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'农业农村局'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'6,200'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'5,480'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'88.39%'</td>
<td style="padding:5px; backgroundColor:#E8F0F7; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'进度领先'</td>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'民政局'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'5,100'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'4,320'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'84.71%'</td>
<td style="padding:5px; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'正常推进'</td>
</tr>
<tr>
<td style="padding:6px; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'合计'</td>
<td style="padding:6px; textAlign:right; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'42,100'</td>
<td style="padding:6px; textAlign:right; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'36,110'</td>
<td style="padding:6px; textAlign:right; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'85.77%'</td>
<td style="padding:6px; backgroundColor:#E8F0F7; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'总体达标'</td>
</tr>
</table>
</div>
<div style="marginBottom:10px">
<div style="backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px; marginBottom:8px">
<h2 style="color:#1F4E79; fontSize:13; bold:true; marginTop:0; marginBottom:0">'三、进度分析与下半年建议'</h2>
</div>
<list style="list-style-type:none; padding-left:0; fontSize:10">
<li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'总体进度:五个部门预算下达合计 42,100 万元,已执行 36,110 万元,整体执行率 85.77%,略高于序时进度。'</li>
<li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'领先部门:农业农村局 88.39%、教育局 87.97% 执行率居前两位,项目开工早、资金支付节奏快。'</li>
<li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'预警部门:交通局执行率 82.50% 为五部门最低,低于整体水平 3.27 个百分点,主要受工程招标进度滞后影响。'</li>
<li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'下半年建议:对交通局实行项目清单周调度;对执行率已超 87% 的部门,提示避免年末突击支出,确保资金使用合规。'</li>
</list>
</div>
<lineSeparator style="strokeColor:#DCE3EC"></lineSeparator>
<p style="color:#6c757d; fontSize:8; marginTop:8px">'数据来源:市财政局预算管理一体化系统 | 生成时间:2025年10月8日 | 密级:内部'</p>
</body>
</pdf>