使用freemarker、Itext进行Html转Pdf（解决中文问题&图片问题）

最新推荐文章于 2025-05-18 10:59:16 发布

原创最新推荐文章于 2025-05-18 10:59:16 发布 · 4.3k 阅读

8 ·

CC 4.0 BY-SA版权

java 同时被 2 个专栏收录

35 篇文章

订阅专栏

记录

7 篇文章

订阅专栏

本文介绍了如何使用Freemarker和Itext将Html转换为Pdf文件，特别讨论了解决中文显示和图片插入的问题。在处理中文时，需要通过ITextFontResolver导入中文字体，例如SimSun，并在html中设置相应字体。对于图片，推荐使用http链接的在线图片，避免因本地路径导致的跨系统问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

步骤一：写ftl格式的html
demo.ftl

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
    <meta http-equiv="X-UA-Compatible" content="ie=edge"/>
    <title>正式收据</title>
    <style>
        @page {
            size: 297mm 120mm;
        }
        
        * {
            padding: 0;
            margin: 0;
        }

        ul,
        li {
            list-style: none;
        }

        body {
            font-family: "FangSong", "STFangsong", "SimSun", "SimHei", "Helvetica", "Arial", "sans-serif";
            font-size: 16px;
            color: black;
            background-color: transparent;
            -webkit-font-smoothing: antialiased;
            line-height: 1.42857143;
        }


        .receipt_box {
            background: #FFFFFF;
            border: 1px solid rgba(0, 0, 0, 0.13);
            border-radius: 4px;
            margin: 20px;
            overflow: hidden;
        }

        .header {
            width: 100%;
            position: relative;
            height: 100px;
            overflow: hidden;
        }

        .logo {
            position: absolute;
            top: 14px;
            left: 5px;
            height: 39px;
            width: 39px;

        }


        .date_box {
            position: absolute;
            top: 16px;
            right: 0;
            font-size: 12px;
            color: #3D424D;
            letter-spacing: 0;
            line-height: 17px
        }

        .title_box {
            padding: 0 0;
            text-align: center;
        }

        .title_box .title {
            font-size: 24px;
            font-weight: bold;
            color: #3D424D;
            line-height: 32px;
            margin: 9px 0 0 0;
        }
    </style>
</head>

<body>
<div class="receipt_box">
    <div class="header">
        <div class="title_box">
            <p class="title">正式收据</p>
            <span>OFFICIAL RECEIPT</span>
        </div>
        <img class="logo"
             src="https://xxx.com"
             alt=""/>
        <div class="date_box">
            <p style="word-break:break-all">No: ${receiptNo!}</p>
            <p>Date: ${payTimeStr!}</p>
        </div>
    </div>
</div>
</body>

</html>

步骤二：使用freemarker将参数写入html里
Pom.xml

//Main.class
Map<?, ?> dataMap = new BeanMap(receipt);
String dataHtml = FreemarkerUtils.loadFtlHtml("/templates", "demo.ftl", dataMap);
FreemarkerUtils.class
Java
public class FreemarkerUtils {

    private FreemarkerUtils() {
    }

    /**
     * 使用传入的Map对象，渲染指定的freemarker模板
     *
     * @param pathName 根目录
     * @param fileName 文件名
     * @param globalMap 数据绑定
     * @return html字符串
     */
    public static String loadFtlHtml(String pathName, String fileName, Map globalMap) {
        if (StringUtils.isEmpty(pathName) || StringUtils.isEmpty(fileName) || globalMap == null) {
            throw new IllegalArgumentException("使用数据渲染模板时文件路径异常");
        }

        Configuration cfg = new Configuration(Configuration.VERSION_2_3_28);

        try (StringWriter stringWriter = new StringWriter()) {
            cfg.setClassForTemplateLoading(FreemarkerUtils.class, pathName);
            cfg.setDefaultEncoding("UTF-8");
            cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
            cfg.setClassicCompatible(true);

            Template temp = cfg.getTemplate(fileName);
            temp.process(globalMap, stringWriter);

            return stringWriter.toString();
        } catch (IOException | TemplateException e) {
            log.error("使用数据渲染模板时异常", e);
            throw new BaobabRuntimeException("使用数据渲染模板异常", e);
        }
    }
}

步骤三：使用Itext将html转成pdf
代码块

//Main.class

try (ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream()) {
            PdfFileUtils.html2pdf(byteArrayOutputStream, dataHtml);
            return byteArrayOutputStream.toByteArray();
} catch (IOException e) {
            throw new BaobabRuntimeException("生成pdf文件失败" + e);
}

//Html的String转Pdf工具类
public class PdfFileUtils {
    /**
     * 将HTML转成PD格式的文件。html文件的格式比较严格 图片问题，图片实际上需要用url链接而非本地，本地可能存在解析不了的问题。
     * 
     * @param out
     * @throws Exception
     */
    public static void html2pdf(OutputStream out, String html) {
        ITextRenderer renderer = new ITextRenderer();
        try {
            // 解决中文支持
            ITextFontResolver fontResolver = renderer.getFontResolver();
            fontResolver.addFont("/font/simsun.ttc", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
            fontResolver.addFont("/font/simhei.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);

            renderer.setDocumentFromString(html);

            renderer.layout();
            renderer.createPDF(out);
            log.info("create pdf done!!");
        } catch (Exception e) {
            throw new BaobabRuntimeException("生成 pdf 文件异常", e);
        }
    }
}