根据 FreeMarker 模板导出 PDF 文件 (基于 Spring Boot)

根据 FreeMarker 模板导出 PDF 文件

  • pom.xml 文件添加依赖
<dependency>
    <groupId>org.xhtmlrenderergroupId>
    <artifactId>flying-saucer-pdf-openpdfartifactId>
    <version>${flying-saucer.version}version>
dependency>
<dependency>
    <groupId>org.freemarkergroupId>
    <artifactId>freemarkerartifactId>
    <version>${freemarker.version}version>
dependency>
<dependency>
	<groupId>org.springframeworkgroupId>
	<artifactId>spring-context-supportartifactId>
	<version>${spring.version}version>
dependency>
  • 准备中文字体
  1. MacOS Mojave: “字体册” 中寻找合适字体(/System/Library/Fonts)
  2. Windows 10: “设置-个性化-字体” 中寻找合适字体(C:/Windows/Fonts)
  3. 在互联网上寻找合适字体(免费商业字体)
  • PDF 导出工具类
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.io.StringWriter;
import java.io.Writer;
import java.util.Map;

import org.springframework.core.io.DefaultResourceLoader;
import org.springframework.ui.freemarker.SpringTemplateLoader;
import org.xhtmlrenderer.pdf.ITextFontResolver;
import org.xhtmlrenderer.pdf.ITextRenderer;

import com.lowagie.text.DocumentException;
import com.lowagie.text.pdf.BaseFont;

import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import freemarker.template.TemplateExceptionHandler;
import lombok.AccessLevel;
import lombok.RequiredArgsConstructor;

@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
public class PDFUtil {

    private static Configuration cfg = null;

    // 导出到指定 PDF 路径
    public static void exportPDF(String html, String pdf, String... fonts) throws DocumentException, IOException, TemplateException {
        ITextRenderer renderer = new ITextRenderer();
        addFont(renderer, fonts);
        try (OutputStream os = new FileOutputStream(pdf)) {
            renderer.setDocumentFromString(html);
            renderer.layout();
            renderer.createPDF(os);
        }
    }

    // 解析 FreeMarker 模板
    public static String parseFreemarker(String freemarker, Map<String, Object> dataModel) throws IOException, TemplateException {
        if (cfg == null) {
            cfg = initConfiguration();
        }
        Template temp = cfg.getTemplate(freemarker);
        try (Writer out = new StringWriter()) {
            temp.process(dataModel, out);
            return out.toString();
        }
    }

    // 加载准备好的字体
    private static void addFont(ITextRenderer renderer, String... fonts) throws DocumentException, IOException {
        ITextFontResolver fontResolver = renderer.getFontResolver();
        for (String font : fonts) {
			fontResolver.addFont(font, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
		}
    }

    // 初始化 FreeMarker 配置
    private static Configuration initConfiguration() throws IOException {
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_27);
        // 模板路径
        cfg.setTemplateLoader(new SpringTemplateLoader(new DefaultResourceLoader(), "classpath:/templates/"));
        cfg.setDefaultEncoding("UTF-8");
        cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
        cfg.setLogTemplateExceptions(false);
        cfg.setWrapUncheckedExceptions(true);
        return cfg;
    }

}
  • 准备模板(classpath:/templates/template.ftl

<html>
	<head>
		<link href="https://cdn.bootcss.com/twitter-bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet">link>
		<style type="text/css">
			body {
				font-family: 'Microsoft YaHei';
			}
			@page {
				size: A4;
			}
			.pdf {
				max-width: 680px!important;
			}
			.container {
				margin-left: 0;
			}
		style>
	head>
	<body class="pdf">
		<div class="container pdf">
			<h1 class="pdf">根据 FreeMarker 模板导出 PDF 文件(基于 Spring Boot)h1>
			<h2 class="pdf">作者:${author}h2>
			<hr>hr>
			<h3 class="pdf">测试换行1测试换行2测试换行3测试换行4测试换行5测试换行6测试换行7测试换行测试换行9测试换行10测试换行11测试换行12测试换行h3>
			<p class="pdf">
				<img src="https://avatar.csdn.net/6/1/D/3_sai_simon.jpg">img>
				<br>br>
				<a href="${url}">文章地址a>
			p>
			<div class="pdf"> div>
		div>
	body>
html>
  • 使用工具类导出
    public static void main(String[] args) throws IOException, TemplateException {
        // 数据模型
        Map<String, Object> dataModel = new HashMap<>();
        dataModel.put("author", "Saisimon");
        dataModel.put("url", "https://blog.csdn.net/sai_simon/article/details/98898380");
        // 解析 FreeMarker 模板
        String content = PDFUtil.parseFreemarker("template.ftl", dataModel);
        // 导出 PDF 文件路径
        String pdf = System.getProperty("user.home") + File.separator + "freemarker.pdf";
        // 微软雅黑字体
        String font = System.getProperty("user.home") + File.separator + "fonts" + File.separator + "msyh.ttf";
        // 导出到 PDF 文件
        PDFUtil.exportPDF(content, pdf, font);
    }
  • 注意事项
  1. FreeMarker 模板中的 HTML 标签必须严格按照 XML 的标准,每个标签必须有结束标签。


  2. 加载的字体需要与样式中的 font-family 对应,否则中文不会显示
  • 导出效果
    根据 FreeMarker 模板导出 PDF 文件 (基于 Spring Boot)_第1张图片

你可能感兴趣的:(Java)