Skip to content
JQuickJQuick

JQuick-Pdf

Pure Java · Apache-2.0 · Zero browser dependency

Generate chart-rich PDF reports in pure Javano browser, no hand-written chart drawing code

One HTML/CSS-style template plus one ECharts-style chart config, a single data binding, and you get a byte[] back — layout, vector charts and automatic pagination all happen inside one JVM process.

Download this PDFView the full templateBrowse all 209 demosGitHub
Real output of the code above · page 1 of 2 — JQuick-Pdf
Real output of the code above · page 1 of 2

Not a design mock-up: generated by the sample code — download the PDF and the template source to verify

  • 0 linesof chart drawing code
  • 30+built-in vector chart types
  • 0browser / WebKit / native deps
  • 1JVM process end to end
9 linesAll the core code that produces this report
JOption option = new JOption();
option.title().text("2024年月度营收统计");
JCategoryAxis x = new JCategoryAxis();
x.data("1月", "2月", "3月", "4月", "5月", "6月");
option.xAxis(x); option.yAxis(new JValueAxis());
option.series(new JLine().name("营业收入").data(1860, 1720, 2140));
String svg = JChartRendererFactory.renderChart(JChartType.LINE, option);
byte[] pdf = JQuickPdfFactory.create().bind("svg", svg)
        .executeResource("report/monthly.txt");  // template: <svg>${svg}</svg>
Files.write(Paths.get("monthly.pdf"), pdf);

Imports and the main method omitted; the chart takes one line in the template, <svg>${svg}</svg>, configured ECharts-style via JOption.

How does it compare to iText 7?

This comparison is not a knock on iText — it is a great library. But when what you want is "write reports like web pages, charts out of the box", the two differ by an order of magnitude in effort.

ConcernJQuick-PdfiText 7
Getting startedHTML/CSS-style template + data binding — a frontend mindsetBuild document objects element by element in Java
Charts30+ built-in vector charts, configured ECharts-style via JOptionNo built-in chart engine; bring JFreeChart or similar, rasterize, then insert
Chinese textBundled CJK fonts, zero configurationFind and register font files yourself
RuntimeOne JVM — no browser, no native librariesPure Java works (chart pipeline needs extra deps)
LicenseApache-2.0 (4.0.0+)AGPL-3.0 community edition; commercial use requires a paid license

9 lines of core code vs three stages of glue code — the gap is exactly the part where the chart enters the document.

JQuick-Pdf is the PDF toolkit of the JQuick ecosystem. It focuses on generating, rendering and exporting PDFs from Java: write a template that looks like HTML with inline CSS, bind your data and get a PDF back — as a byte[], a stream or a file.

Templates are parsed with a self-developed grammar and drawn page by page through Apache PDFBox. The whole pipeline has no browser, no headless Chrome and no native library, which makes it a good fit for services, scheduled jobs and desktop applications.

Modules

Section titled “Modules”
Module Coordinate Purpose
jquick-pdfx io.github.paohaijiao:jquick-pdfx Parser, renderer, layout engine and the JQuickPdfFactory entry point — enough for most projects
jquick-pdf-css io.github.paohaijiao:jquick-pdf-css CSS model: style properties, units and colours
jquick-pdf-svg io.github.paohaijiao:jquick-pdf-svg SVG / ECharts-style chart generation (30+ chart types)
jquick-pdf-data io.github.paohaijiao:jquick-pdf-data Chart configuration model (JOption, JChart, JTitle, JLegend, …)
jquick-pdf-font io.github.paohaijiao:jquick-pdf-font Bundled CJK fonts, so Chinese text needs no extra configuration

Features

Section titled “Features”
  • Pure Java, no external engine: no WebKit, no Chrome and no operating-system level dependency — a single JVM process renders everything.
  • HTML/CSS-style templates: 14 element types, each accepting inline style="..." attributes.
  • Two naming conventions: minHeight (camelCase) and min-height (standard CSS) are interchangeable and can be mixed in one declaration.
  • Data binding: ${variable} binds plain values while &{resource} references registered resources such as charts, sub-templates and trees.
  • 30+ chart types: bar, line, pie, radar, scatter, box plot, heatmap, candlestick, funnel, gauge, Gantt, word cloud, map, sunburst, treemap, topology and more — all drawn as vectors.
  • Full document capabilities: automatic pagination, table of contents, headers and footers, page numbers, watermarks and PDF encryption.
  • CJK friendly: bundled CJK fonts make Chinese content work out of the box.
  • Modular artefacts: depend only on the parsing and rendering core, then add charts, CSS or fonts on demand.
  • Java 8 compatible: released artefacts target Java 8 bytecode.

Installation

Section titled “Installation”
<dependency>
    <groupId>io.github.paohaijiao</groupId>
    <artifactId>jquick-pdfx</artifactId>
    <version>4.1.0</version>
</dependency>

Chart support is an optional dependency:

<dependency>
    <groupId>io.github.paohaijiao</groupId>
    <artifactId>jquick-pdf-svg</artifactId>
    <version>4.1.0</version>
</dependency>

Quick start

Section titled “Quick start”

Hello World

Section titled “Hello World”
import com.github.paohaijiao.executor.JQuickPdfFactory;


import java.nio.file.Files;
import java.nio.file.Paths;


public class HelloDemo {


    public static void main(String[] args) throws Exception {
        String template = ""
                + "<pdf>"
                + "  <body>"
                + "    <h1 style=\"fontSize:24;fontColor:blue\">'Hello jquick-pdf'</h1>"
                + "    <p>'Customer: '${customer}</p>"
                + "  </body>"
                + "</pdf>";


        byte[] pdf = JQuickPdfFactory.create()
                .bind("customer", "Martin")
                .executeContent(template);


        Files.write(Paths.get("hello.pdf"), pdf);
    }
}

Three template sources

Section titled “Three template sources”

All three methods return a byte[]:

Method Template source
executeContent(String) Template text held in memory
executeResource(String) A classpath resource, for example "report.txt"
executeFile(String) A file on disk, for example "D:/templates/report.txt"

Supported Render Elements

Section titled “Supported Render Elements”

The JQuick-Pdf template grammar defines 18 element types. Their names and support status:

Element Description Support status
paragraph Paragraph container (written as <p> in templates) holding a run of text with inline styles Supported
heading Heading element, corresponding to the six levels <h1> … <h6> Supported
list List container; works with <li> to render ordered or unordered items Supported
table Table; works with <tr> / <th> / <td> to draw rows, columns and cell styles Supported
image Raster image; the source is specified with src Supported
svg Vector graphics; embed charts with ${svg} / &{svg} Supported
div Block container with background, border, padding, size, rotation and flex layout support Supported
span Inline container for styling a fragment of text inside a paragraph Supported
areaBreak Forced page break; content after it is drawn on the next page Supported
button Button control for building interactive PDF forms Supported
checkbox Checkbox control for building interactive PDF forms Supported
comboBoxField Combo-box (drop-down) control for building interactive PDF forms Supported
htmlPageBreak HTML-style page break at the declared position Supported
lineSeparator Horizontal separator line Supported
tab Tab character for tab-stop aligned layout Supported
textArea Multi-line text-area control for building interactive PDF forms Supported
tree Tree structure for rendering hierarchical data Supported
value Text value node: literal text wrapped in single quotes, or a value bound with ${...} Supported

Minimal template snippets for each element (the <pdf><body> root is omitted for brevity).

paragraph

Section titled “paragraph”

A paragraph uses <p> and is the block element for ordinary text:

<p style="fontSize:12; lineHeight:1.5">'A paragraph that holds a run of ordinary text.'</p>

heading

Section titled “heading”

Headings use <h1> … <h6>; the smaller the number, the higher the level:

<h1 style="fontSize:20; fontColor:#1f2937">'Level-one heading'</h1>
<h2 style="fontSize:16; fontColor:#374151">'Level-two heading'</h2>

list

Section titled “list”

A list uses <list> + <li>, with list-style-type controlling the bullet:

<list style="list-style-type:disc; fontSize:12">
  <li>'First unordered item'</li>
  <li>'Second unordered item'</li>
</list>

table

Section titled “table”

Tables follow the <table> → <tr> → <th> / <td> hierarchy:

<table style="width:100%; fontSize:11">
  <tr>
    <th style="backgroundColor:#f8f9fa; padding:5px">'Name'</th>
    <th style="backgroundColor:#f8f9fa; padding:5px">'Age'</th>
  </tr>
  <tr>
    <td style="padding:5px">'Alice'</td>
    <td style="padding:5px">'28'</td>
  </tr>
</table>

image

Section titled “image”

An image uses <image>; the source comes from src, and width/height are optional:

<image src="logo.png" style="width:120px; height:60px" />

svg

Section titled “svg”

Vector graphics use <svg>, usually bound to a rendered chart string with ${svg}:

<svg style="width:400px; height:300px">${svg}</svg>

div

Section titled “div”

<div> is a block container used to group content and style it together (background, border, padding, flex layout, …):

<div style="padding:10px; backgroundColor:#f8f9fa; borderRadius:4px">
  <p style="fontSize:12">'A paragraph inside the container.'</p>
</div>

span

Section titled “span”

<span> is an inline container for styling a fragment of text inside a paragraph:

<p style="fontSize:12">'Total: '<span style="fontColor:red; fontWeight:bold">'$99.00'</span></p>

areaBreak

Section titled “areaBreak”

<areaBreak> forces a page break; content after it starts on the next page:

<p>'Content on page one'</p>
<areaBreak />
<p>'Content on page two'</p>

button

Section titled “button”

<button> renders an interactive button form field; name identifies the field:

<button name="confirm" style="width:80px; height:28px">'Submit'</button>

checkbox

Section titled “checkbox”

<checkbox> renders a checkbox form field:

<checkbox name="agreed" />'I have read and agree to the terms'

comboBoxField

Section titled “comboBoxField”

<comboBoxField> renders a drop-down form field; name identifies the field:

<comboBoxField name="city" style="width:200px; height:24px" />

htmlPageBreak

Section titled “htmlPageBreak”

<htmlPageBreak> inserts an HTML-style page break at its declared position:

<p>'Content before the break'</p>
<htmlPageBreak />
<p>'Content after the break'</p>

lineSeparator

Section titled “lineSeparator”

<lineSeparator> draws a horizontal separator line:

<lineSeparator style="width:100%; color:#cccccc" />

tab

Section titled “tab”

<tab> inserts a tab character for tab-stop aligned layout:

<p style="fontSize:12">'Name: '<tab />'Alice'</p>

textArea

Section titled “textArea”

<textArea> renders a multi-line text-area form field:

<textArea name="remark" style="width:300px; height:80px" />

tree

Section titled “tree”

<tree> renders a tree structure; the tree data is passed in via a bound variable:

<tree style="width:100%; fontSize:12">${deptTree}</tree>

value

Section titled “value”

value is the grammar-level text node: single-quoted literal text and ${...} bindings both render as the final text:

<p>'Customer: '${customer}</p>

Supported CSS Style Properties

Section titled “Supported CSS Style Properties”

Styles are declared in the element’s style="..." attribute; standard CSS kebab-case names (font-size) and camelCase names (fontSize) are equivalent and can be mixed. Size units accept px, pt, mm, cm and in. Commonly used properties:

Property Description Applies to
width Element width Block elements such as div, table, image
height Element height Block elements such as div, table, image
margin Outer margin — the space between the element and its neighbours All elements
padding Inner padding — the space between content and border Container elements such as div, table, td, list
border Border with width, line style and colour, e.g. 1px solid #cccccc div, table, td, …
background-color Background colour; accepts colour names, #RRGGBB, rgb() / rgba() Container elements such as div, table, td, list
color Text (foreground) colour Text-bearing elements: paragraph, value, table cells
font-size Font size Text-bearing elements
font-family Font family; the bundled CJK fonts render Chinese out of the box Text-bearing elements
text-align Horizontal alignment: left / center / right paragraph, value, td, div
vertical-align Vertical alignment: top / middle / bottom Table cells such as td and container elements
line-height Line height (leading) Text elements such as paragraph, value
font-weight Font weight, e.g. normal / bold Text-bearing elements

Demo gallery

Section titled “Demo gallery”

The 209 demos below cover every vector chart type, the common document layouts and the multilingual rendering of JQuick-Pdf, all produced by real runs of the sample code: download the PDF, check the rendered preview and compare the Java source per group.

  • Biz Demo: 53 real-world reports and documents from government, finance, operations and monitoring.
  • Scenario / Finance / Customs / Banking / Government / Medical / Supply chain: 116 industry document templates, numbered 69-184.
  • CreditReport Demo: 15 credit-report templates varying chart types and colour schemes.
  • I18n Demo: the same banking report in 25 languages (numbered 185-209), each with its own layout, colour scheme and chart theme — requires 4.4.0 or later.
  • All PDFs are statically hosted; click “Download PDF” to download — no in-browser preview.

Biz DemoScenario DemosFinance & Tax DemosCustoms & Trade DemosBanking DemosGovernment DemosMedical DemosSupply-chain DemosCreditReport DemoI18n Demo

Biz Demo

Section titled “Biz Demo”

40 enterprise and government reports and documents covering line, bar, pie, radar, funnel, Gantt, heatmap, tree and map charts, plus layout-only templates such as warehouse receipts, resumes, inspection reports, settlement statements, invitation letters, tenders, receipts and archive covers.

53 demos

Monthly revenue report (enterprise operations)

LINE

An operations system aggregates monthly revenue and net profit and plots both series across twelve months for the management review meeting.

Template
16_monthly_revenue.txt
Rendered output

Details · full source & templateDownload PDF

Material warehouse receipt (warehousing)

Layout

The triplicate form filled in when a material reserve company receives goods: a four-column block for supplier and purchase contract details, an eight-column item table, a large total-amount row and four signature slots for the keeper, inspector, warehouse manager and finance reviewer.

Template
48_warehouse_receipt.txt
Rendered output

Details · full source & templateDownload PDF

One-page resume (recruiting / talent files)

Layout

Lays a candidate profile out as a ready-to-send one-page resume: a dark left column carries the name, contact details, core skills and certificates, while the right column expands into summary, work history, projects and education with a timeline for each role.

Template
49_resume.txt
Rendered output

Details · full source & templateDownload PDF

Product quality inspection report (testing lab)

BAR

A commissioned inspection report issued by a testing lab: sample details plus a five-column table of test items with required limits and measured results, a grouped bar chart comparing limits against measurements, a large green verdict block and a three-column signature area.

Template
50_inspection_report.txt
Rendered output

Details · full source & templateDownload PDF

Engineering material settlement statement (project finance)

Layout

The document the two parties of an engineering project use to settle payments per delivery period: side-by-side party boxes, a five-column cost breakdown with the total in a highlighted last row, amount in words and figures, the payee account and a seal box on the right.

Template
51_settlement_statement.txt
Rendered output

Details · full source & templateDownload PDF

Meeting invitation letter (formal correspondence)

Layout

An invitation from an industry association to its member companies: centred title and salutation, indented body paragraphs, a three-column agenda, three attendee info boxes, a right-aligned sign-off and contact details in the footer.

Template
52_invitation_letter.txt
Rendered output

Details · full source & templateDownload PDF

Tender document (multi-page bid)

LINE

A combined technical and commercial bid paginated explicitly with areaBreak into four pages: cover with a fill-in info table → table of contents → bid letter and past performance (line chart of contract value and acceptance rate for three years) → technical proposal and commercial quotation.

Template
53_tender_multipage.txt
Rendered output

Details · full source & templateDownload PDF

Service acceptance receipt (government service window)

Layout

Issued by a government service window after accepting an enterprise data-asset registration: a four-column acceptance table, grey section headings, two-column checkbox confirmations, numbered instructions, plus a tear-off customer copy and dual signature area.

Template
54_acknowledgement_receipt.txt
Rendered output

Details · full source & templateDownload PDF

Archive file cover (records management)

Layout

The file cover printed after completion documents of an infrastructure project are handed over to the archive room: a 3pt outer frame, fonds number and security level at the top corners, a three-level oversized title block in the middle, a two-column record table and a filing/checking footer.

Template
55_archive_cover.txt
Rendered output

Details · full source & templateDownload PDF

Critical-dimension boxplot by production line (quality control)

BOXPLOT

SPC statistics of key dimensions across four production lines: the boxplot shows the minimum, Q1, median, Q3, maximum and outliers of each line, with sample-size and unit subtitles and stability conclusions plus first-article inspection advice below.

Template
56_boxchart.txt
Rendered output

Details · full source & templateDownload PDF

City air-quality monitoring bubble chart (environmental monitoring)

Bubble

Daily January readings from 15 national monitoring stations: date on the X axis, AQI on the Y axis, bubble size for PM2.5 concentration and color for the air-quality grade, with values printed on the bubbles and pollution-event analysis below.

Template
57_bubble.txt
Rendered output

Details · full source & templateDownload PDF

Regional quarterly sales, four-series comparison (sales operations)

MultipleBar

A grouped bar chart of East/North/South China and West region sales for October-December 2024, with value labels on the bars, a four-color legend at the bottom and monthly conclusions on regional leaders and growth.

Template
59_fourBar.txt
Rendered output

Details · full source & templateDownload PDF

Daily stock candlestick chart (investment research)

K

Daily candlesticks of a stock for December 2024: red and green bodies show the day's rise or fall and the wicks show the high and low, with trading days on the axis plus notes on the early-month rally, mid-month pullback and moving-average support.

Template
60_k_chart.txt
Rendered output

Details · full source & templateDownload PDF

City development line-radar assessment chart (development research)

LineRadar

A quarterly GDP-growth line combined with eight development-index scatter points (innovation, coordination, green, openness, sharing and more) on one chart, highlighting the strong green score and the room to improve innovation.

Template
61_lineRadar.txt
Rendered output

Details · full source & templateDownload PDF

Project delivery volume vs. on-time delivery rate (project management)

LineBar

A January-December dual-axis combo chart: bars for monthly delivered projects (left axis) and an orange line for the on-time delivery percentage (right axis), with every point labeled and both metrics trending upward.

Template
62_linebar.txt
Rendered output

Details · full source & templateDownload PDF

May 2024 lunar calendar (HR & administration)

Lunar

A Gregorian-lunar monthly calendar: the Gregorian date sits above the lunar date in every cell, Labor Day, Mother's Day and the Grain Buds solar term are highlighted, weekends are shown in red, and holiday and term notes follow below.

Template
63_lunar.txt
Rendered output

Details · full source & templateDownload PDF

Annual budget vs. actual spend by product line (financial management)

MutipleHorizontalBar

A horizontal three-series bar chart for five product lines — budget, actual spend and deviation rate (×10) — with amount labels on the bars, making overspending lines obvious and supporting budget-review and baseline-adjustment advice.

Template
64_mhBarChart.txt
Rendered output

Details · full source & templateDownload PDF

Monthly revenue trends of three business segments (business analysis)

MultipleLine

A multi-line chart of 2024 monthly revenue for software, hardware and services, concluding that software stayed steady, hardware dipped on supply-chain pressure and services grew the fastest.

Template
65_multipleLine.txt
Rendered output

Details · full source & templateDownload PDF

Supplier A vs. B dual-radar capability comparison (procurement)

DoubleRadar

Two side-by-side radar charts comparing suppliers A and B across quality, price, delivery, service, technology and responsiveness, supporting the procurement strategy of prioritizing A for strategic goods while introducing B for competition on general goods.

Template
66_twoRadar.txt
Rendered output

Details · full source & templateDownload PDF

Product review keyword word cloud (user research)

WORDCLOUD

A word cloud built from token statistics of 50,000 user reviews: top words such as stable, efficient and easy to use appear in very large tilted type while rare negative words scatter in small type, font size mapping directly to frequency.

Template
67_wordcloud.txt
Rendered output

Details · full source & templateDownload PDF

Group revenue share treemap by segment (strategy planning)

TREEMAP

A treemap splitting group revenue across core business, innovation business, support services and other segments: area maps revenue scale, same-hue sub-blocks are second-level business lines labeled with amounts, with conclusions on the core share and emerging growth.

Template
68_treemap.txt
Rendered output

Details · full source & templateDownload PDF

Scenario Demos

Section titled “Scenario Demos”

31 general business and government documents: resumes, certificates, quotations, statements, acceptance sheets, contracts, lawyer letters, reports and receipts — pure layout templates covering multi-page flow, perforated seal strips and signature blocks.

31 demos

Personal resume

Template

Single-column A4 resume: a dark-blue info banner plus self-evaluation and work, project and education sections, generated from a template with bound data.

Template
69_resume.txt
Rendered output

Details · full source & templateDownload PDF

Finance & Tax Demos

Section titled “Finance & Tax Demos”

25 finance and tax bill samples: VAT special/general/fully-digitised invoices, customs payment notes, fiscal bills and expense claims — complete invoice elements for billing and reimbursement systems.

25 demos

Customs & Trade Demos

Section titled “Customs & Trade Demos”

15 foreign-trade and customs documents: customs declarations, bonded records, commercial invoices, packing lists, bills of lading, certificates of origin and letters of credit — bilingual layouts for cross-border scenarios.

15 demos

Banking Demos

Section titled “Banking Demos”

15 banking documents: transfer receipts, account statements, cheques, acceptance bills, loan and guarantee vouchers, credit reports and AML screening lists.

15 demos

Government Demos

Section titled “Government Demos”

15 government documents: acceptance receipts, approval decisions, annual-review forms, project approval opinions, subsidy claims and document flow receipts.

15 demos

Medical Demos

Section titled “Medical Demos”

10 medical documents: record home pages, charge invoices, expense details, insurance settlement, lab reports and discharge summaries.

10 demos

Supply-chain Demos

Section titled “Supply-chain Demos”

5 supply-chain documents: purchase orders, sales outbound statements, incoming inspection, supplier admission and payment confirmations.

5 demos

CreditReport Demo

Section titled “CreditReport Demo”

15 styles of the unified credit report template, switching chart types and colour schemes within the same report layout.

15 demos

I18n Demo

Section titled “I18n Demo”

The same global banking report in 25 languages (numbered 185-209): Arabic, Bengali, Simplified and Traditional Chinese, Dai (New Tai Lue), English, French, German, Hebrew, Indonesian, Japanese, Korean, Malay, Manchu, traditional Mongolian, Persian, Portuguese, Russian, Spanish, Tagalog, Tamil, Thai, Tibetan, Uyghur and Vietnamese. Each language ships as a standalone report with its own layout, colour scheme and chart theme; the previews are full-length screenshots covering every page. Multilingual rendering requires JQuick-Pdf 4.4.0 or later.

25 demos

Section titled “Links”