【java通过freemarker生成html页面并导出为pdf】

我，也来自江湖

于 2025-04-08 11:19:42 发布

阅读量817

点赞数 21

文章标签： java html pdf

本文链接：https://blog.youkuaiyun.com/weixin_43161728/article/details/146934466

版权

pom依赖

		<!-- poi-tl（poi template language）是Word模板引擎。-->
		<!-- 用到这个依赖中的工具类(代码裁缝能力) -->
		<dependency>
			<groupId>com.deepoove</groupId>
			<artifactId>poi-tl</artifactId>
			<version>1.8.2</version>
		</dependency>
		<!-- PDF Generation -->
		<dependency>
			<groupId>org.freemarker</groupId>
			<artifactId>freemarker</artifactId>
			<version>2.3.31</version>
		</dependency>
		<dependency>
			<groupId>com.openhtmltopdf</groupId>
			<artifactId>openhtmltopdf-core</artifactId>
			<version>1.0.6</version>
		</dependency>
		<dependency>
			<groupId>com.openhtmltopdf</groupId>
			<artifactId>openhtmltopdf-pdfbox</artifactId>
			<version>1.0.6</version>
		</dependency>
		<dependency>
			<groupId>org.apache.pdfbox</groupId>
			<artifactId>fontbox</artifactId>
			<version>2.0.27</version>
		</dependency>

freemarker模板

<html>
<head>
    <meta charset="UTF-8">
    <title>${title}</title>
    <style>
        body { font-family: SimSun; }
        .content { margin: 20px; }
    </style>
</head>
<body>
    <h1>${header}</h1>
    <div class="content">
        ${content}
    </div>
    <div><img width="150" height="150"  src="data:image/png;base64,${image}" /></div>
    <footer>生成时间：${.now?string("yyyy-MM-dd HH:mm:ss")}</footer>
</body>
</html>

代码

渲染freemarker模板,生成html并转化为PDF


import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import org.jsoup.Jsoup;
import org.jsoup.helper.W3CDom;
import org.jsoup.nodes.Document;
import com.openhtmltopdf.pdfboxout.PdfRendererBuilder;

import java.io.*;
import java.nio.charset.StandardCharsets;
import java.util.Map;

public class PdfGeneratorService {
    private final Configuration freemarkerConfig;

    public PdfGeneratorService() throws IOException {
        freemarkerConfig = new Configuration(Configuration.VERSION_2_3_31);
        freemarkerConfig.setClassForTemplateLoading(this.getClass(), "/templates");
        freemarkerConfig.setDefaultEncoding(StandardCharsets.UTF_8.name());
    }

    public void generatePdf(String templateName, Map<String, Object> data, OutputStream outputStream) 
            throws IOException, TemplateException {
        // 渲染Freemarker模板
        StringWriter writer = new StringWriter();
        Template template = freemarkerConfig.getTemplate(templateName);
        template.process(data, writer);

        // 转换HTML为PDF
        String html = writer.toString();
        Document document = Jsoup.parse(html, "UTF-8");
        document.outputSettings().syntax(Document.OutputSettings.Syntax.xml);

        try (OutputStream os = outputStream) {
            PdfRendererBuilder builder = new PdfRendererBuilder();
            builder.withW3cDocument(new W3CDom().fromJsoup(document), "/");
            builder.useFont(() -> this.getClass().getResourceAsStream("/fonts/SimSun.ttf"), "SimSun");
            builder.toStream(os);
            builder.run();
        }
    }
}

    @Test
    public void testGeneratePdf() throws Exception {
        PdfGeneratorService generator = new PdfGeneratorService();
        Map<String, Object> data = new HashMap<>();
        data.put("title", "测试文档");
        data.put("header", "中文测试标题");
        data.put("content", "这是自动生成的PDF内容，包含中文测试。");
        //通过url获取图片二进制文件
        byte[] urlByteArray = BytePictureUtils.getUrlByteArray("http://gips2.baidu.com/it/u=195724436,3554684702&fm=3028&app=3028&f=JPEG&fmt=auto?w=1280&h=960");
        //图片二进制文件转base64编码
        String s = new BASE64Encoder().encodeBuffer(urlByteArray);
        data.put("image",s);
        try (FileOutputStream fos = new FileOutputStream("output.pdf")) {
            generator.generatePdf("template.ftl", data, fos);
        }
    }

项目结构

字体以及模板目录结构

参考文档

Java Poi-tl操作Word文档，插入文本和图片

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

~~删除文本~~

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片: Alt

带尺寸的图片:

居中的图片: Alt

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

项目
- 项目
  - 项目

项目1
项目2
项目3

计划任务
完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	`'Isn't this fun?'`	‘Isn’t this fun?’
Quotes	`"Isn't this fun?"`	“Isn’t this fun?”
Dashes	`-- is en-dash, --- is em-dash`	– is en-dash, — is em-dash