Bar Chart of Accepted, Approved and Returned Applications

jquick-pdf by example — demo #17 of 184. Every article in this series ships one complete, runnable demo: a template file and a Java class. No snippets, no omissions.

A government service window tracks three outcomes per month to measure throughput quality.

This document belongs to the Business chart series set.

What you'll build

  • A PDF written to D:/test/biz/17_project_approval.pdf
  • A template file (report/biz/17_project_approval.txt) with 1 bound placeholder
  • A detail grid of 6 rows × 5 columns, laid out with width:100% so it fills the text area
  • One self-contained Java class (JQuickBiz17ProjectApprovalTest) that binds the data and renders the file

Bound placeholders

${svg}

Prerequisites

Java 8+ and one dependency — jquick-pdf is built on Apache PDFBox, not iText:

<dependency> <groupId>io.github.paohaijiao</groupId> <artifactId>jquick-pdfx</artifactId> <version>4.2.0</version> </dependency>

Coordinates: io.github.paohaijiao:jquick-pdfx:4.2.0.

Step 1 — the template file

JPdfX is jquick-pdf's HTML-like template language. It lives in its own file (src/test/resources/report/biz/17_project_approval.txt) instead of a Java string, so designers can edit it without touching code.

<pdf> <body> <div style="textAlignment:center; marginBottom:10px; padding:14px; background:#2F5597; borderRadius:4px; keepTogether:true"> <h1 style="textAlignment:center; color:white; marginBottom:6px; fontSize:18pt; bold:true">'项目审批数量趋势月报'</h1> <p style="color:white; fontSize:10pt; margin:2px">'统计周期：2024年1月 - 2024年12月'</p> <p style="color:white; fontSize:10pt; margin:2px">'编制单位：市政务服务管理局 | 报送对象：项目监管联席会议'</p> </div> <div style="marginBottom:10px"> <h2 style="color:#2F5597; fontSize:13pt; bold:true; marginBottom:6px">'一、月度审批数量趋势'</h2> <div style="display:flex; justifyContent:center"> <svg style="width:700pt">${svg}</svg> </div> <p style="fontSize:9pt; color:#6c757d; italic:true; marginTop:6px">'图 1 2024年1-12月受理 / 审批通过 / 退回补正项目数量（数据来源：市项目审批监管系统）'</p> </div> <div style="marginBottom:10px"> <h2 style="color:#2F5597; fontSize:13pt; bold:true; marginBottom:6px">'二、季度审批结果汇总'</h2> <table style="width:560px; fontSize:10pt"> <tr> <th style="width:120px; backgroundColor:#2F5597; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'季度'</th> <th style="width:110px; backgroundColor:#2F5597; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'受理（件）'</th> <th style="width:110px; backgroundColor:#2F5597; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'审批通过（件）'</th> <th style="width:110px; backgroundColor:#2F5597; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'退回补正（件）'</th> <th style="width:110px; backgroundColor:#2F5597; 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">'435'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'346'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'66'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'79.5%'</td> </tr> <tr> <td style="padding:5px; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'第二季度'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'492'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'400'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'74'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'81.3%'</td> </tr> <tr> <td style="padding:5px; border:1px solid #DCE3EC">'第三季度'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'553'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'456'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'80'</td> <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'82.5%'</td> </tr> <tr> <td style="padding:5px; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'第四季度'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'643'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'536'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'86'</td> <td style="padding:5px; textAlign:right; backgroundColor:#EAF1F8; border:1px solid #DCE3EC">'83.4%'</td> </tr> <tr> <td style="padding:6px; bold:true; border:1px solid #DCE3EC">'全年合计'</td> <td style="padding:6px; textAlign:right; bold:true; border:1px solid #DCE3EC">'2,123'</td> <td style="padding:6px; textAlign:right; bold:true; border:1px solid #DCE3EC">'1,738'</td> <td style="padding:6px; textAlign:right; bold:true; border:1px solid #DCE3EC">'306'</td> <td style="padding:6px; textAlign:right; bold:true; border:1px solid #DCE3EC">'81.9%'</td> </tr> </table> </div> <div style="marginBottom:10px"> <h2 style="color:#2F5597; fontSize:13pt; bold:true; marginBottom:6px">'三、审批运行结论'</h2> <list style="listStyleType:disc; paddingLeft:16px; fontSize:10pt"> <li style="marginBottom:5px"><span style="bold:true; color:#2F5597">'审批总量稳步上行：'</span>'全年受理项目 2,123 件、审批通过 1,738 件，四季度受理量较一季度增长 47.8%（643 件对 435 件）。'</li> <li style="marginBottom:5px"><span style="bold:true; color:#2F5597">'通过率逐季提升：'</span>'通过率由一季度 79.5% 升至四季度 83.4%，全年 81.9%；退回补正占比由 15.2% 降至 13.4%。'</li> <li style="marginBottom:5px"><span style="bold:true; color:#2F5597">'退回补正高位平稳：'</span>'全年退回补正 306 件，月均 25.5 件，四季度 86 件为年内高点，材料完整性仍是主要影响因素。'</li> <li style="marginBottom:5px"><span style="bold:true; color:#2F5597">'年末高峰特征明显：'</span>'12月受理 226 件、审批通过 189 件，均为全年单月峰值，与年度项目集中申报节奏一致。'</li> <li style="marginBottom:5px"><span style="bold:true; color:#2F5597">'建议：'</span>'在年末申报高峰前增设预审窗口，并完善线上材料校验规则，力争将退回补正占比压降至 12% 以内。'</li> </list> </div> <div style="textAlignment:center; marginTop:10px; paddingTop:10px; borderTop:1px solid #dee2e6; color:#6c757d; fontSize:8pt"> <p>'数据来源：市项目审批监管系统 | 生成时间：2025年1月10日'</p> <p>'内部资料 · 未经许可请勿外传'</p> </div> </body> </pdf>

Step 2 — the Java class

jquick-pdfx/src/test/java/com/github/paohaijiao/biz/chart/JQuickBiz17ProjectApprovalTest.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.axis.JCategoryAxis; import com.github.paohaijiao.axis.JValueAxis; import com.github.paohaijiao.code.JTrigger; 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 com.github.paohaijiao.series.JBar; import org.junit.Test; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; /** * 业务场景 Demo 17：项目审批数量趋势（政务/项目监管平台） * * <p>业务场景：项目监管平台按月统计「受理 / 审批通过 / 退回补正」三类的项目审批数量， * 用于观察审批负荷与办理质量的变化。</p> * <p>实际图表类型：{@link JChartType#BAR} 柱状图（分组柱，用于对比三类审批结果）。</p> * * <p>模板：{@code report/biz/17_project_approval.txt}；图表以 SVG 文本形式绑定到模板的 * {@code ${svg}} 占位符，输出到 {@code D:\test\biz\17_project_approval.pdf}。</p> * * <p>图表尺寸说明：图表按 700pt × 380pt（宽 × 高）的横版比例设计；模板中 {@code <svg>} * 只声明宽度、不声明高度，因此宽度被页面自动收窄时高度会按原比例同步缩放，不会纵向拉伸变形。</p> * * @author Martin * @version 1.0.0 */ public class JQuickBiz17ProjectApprovalTest { public static final String path = JQuickConstant.path; @Test public void biz17ProjectApproval() throws IOException { JOption option = new JOption(); option.title().text("2024年项目审批数量趋势").subtext("受理 / 审批通过 / 退回补正（单位：件）"); option.tooltip().trigger(JTrigger.axis); JCategoryAxis xAxis = new JCategoryAxis(); xAxis.data("1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"); option.xAxis(xAxis); option.yAxis(new JValueAxis()); // 三类审批结果各一根柱，沿用政务系统低饱和主色 JBar accepted = new JBar(); accepted.name("受理").data(142, 138, 155, 163, 158, 171, 182, 176, 195, 203, 214, 226); JBar approved = new JBar(); approved.name("审批通过").data(112, 110, 124, 132, 128, 140, 150, 145, 161, 169, 178, 189); JBar returned = new JBar(); returned.name("退回补正").data(22, 20, 24, 25, 23, 26, 27, 25, 28, 27, 29, 30); option.series(accepted, approved, returned); String svg = JChartRendererFactory.renderChart(JChartType.BAR, option); File dir = new File(path + "biz"); if (!dir.exists()) { dir.mkdirs(); } FileOutputStream fileOutputStream = new FileOutputStream(path + "biz/17_project_approval.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/17_project_approval.txt"); fileOutputStream.write(bytes); fileOutputStream.close(); } }

Step 3 — run it

The class is a JUnit test, so run it with Maven:

mvn -pl jquick-pdfx test -Dtest=JQuickBiz17ProjectApprovalTest

…or call the test method from a main wrapper if you want a plain entry point:

public static void main(String[] args) throws Exception { new JQuickBiz17ProjectApprovalTest().biz17ProjectApproval(); }

Output: D:/test/biz/17_project_approval.pdf

How it works

Binding a chart SVG into the template

The chart is not a bitmap — JChartRendererFactory.renderChart(...) returns an SVG string, and the template embeds it with a single <svg> element bound to ${svg}. That means the chart stays vector-sharp at any zoom level, and it participates in normal flow layout instead of being stamped on top of the page.

  • Declare only the width on <svg>; the height is derived from the chart's aspect ratio, so the chart never stretches vertically.
  • Open config.getLayoutConfig().setFlexLayout(true) if the template centers the chart with display:flex.
  • Bind the SVG string with factory.bind("svg", svg) — bind() is pure data injection and never re-parses markup. 
String svg = JChartRendererFactory.renderChart(JChartType.LINE, option); JQuickPdfFactory factory = new JQuickPdfFactory(config); factory.bind("svg", svg); byte[] bytes = factory.executeResource(TEMPLATE);

CJK font configuration

CJK text needs a font that actually contains the glyphs. The engine ships with a Chinese font and lets you switch it through JFontConfig; if a glyph is missing the character is silently dropped or drawn as a box, and the failure looks like a data problem rather than a font problem.

  • Set the font once on JPdfConfig.getFontConfig() before rendering.
  • Chart SVG text is a separate pipeline — register the same family on JOption or chart labels fall back to Helvetica.
  • Prefer the full-width ￥ over ¥; the latter is often absent from CJK faces. 
JPdfConfig config = new JPdfConfig(); config.getFontConfig().setDefaultFontName("Noto Sans CJK SC");

Template syntax cheat sheet

Syntax Meaning
<table style="width:100%"> Spans the full text area; give explicit widths only to the leading columns.
<areaBreak></areaBreak> Force the next block onto a fresh page (CSS page-break is not supported).
<image src='D:/.../x.png'> Embed an image. src is a raw path — it is not evaluated as an expression.
<svg style="width:479pt">${svg}</svg> Embed a vector chart produced by JChartRendererFactory.
// comment Line comment. Keep <!-- ... --> comments short — long ones can blank the render.

Gotchas worth remembering

  • Flex children whose fixed widths exceed the text area wrap instead of sitting side by side.
  • ${var} must sit outside single quotes — 'No: ${docNo}' prints the placeholder literally.
  • <image src="..."> never evaluates ${...}; write a literal path.
  • A <td> holds text only — nested <p>, <image> or <table> is dropped.

Output

Wrap up

You now have a template file, a Java class and a PDF — all three reproducible from a clean clone. Swap the placeholder blocks for real data (or for real seal images) and the layout does not move.

Series navigation: ← #16 Monthly Revenue and Net Profit: A Dual-Line Chart PDF　·　#18 Geo Chart of Application Volume by Region →

Full index: README.md　·　Source: jquick-pdf

Appendix — files in this demo

Role Path
Java class jquick-pdfx/src/test/java/com/github/paohaijiao/biz/chart/JQuickBiz17ProjectApprovalTest.java
Template jquick-pdfx/src/test/resources/report/biz/17_project_approval.txt
Output PDF D:/test/biz/17_project_approval.pdf
Preview image images/17.png