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

本文介绍了如何使用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);
        }
    }
}

中文问题:
如果导出pdf需要中文,则需要使用ITextFontResolver将中文字体导入进去,如代码中的 fontResolver.addFont("/font/simsun.ttc", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);

并且在html中设置字体: 而必须是SimSun 而不是sinsum

其他字体如fangsong之类的似乎导入失败了,不知道为什么识别不了

图片问题:
建议直接在html中引入http链接形式的图片,如: src=“https://s3plus.sankuai.com/v1/xxx”

尝试过本地图片的方式,当时需要设置其目录才可以正确识别,而不同系统的目录不一样,在本地运行可以成功但放到linux里却识别不了,比较麻烦,故不推荐

本地图片需要设置图片路径:
Java
renderer.getSharedContext().setBaseURL(“file:” + System.getProperty(“user.dir”) + “/xxx/src/main/resources/templates/”);

使用FreemarkeriText可以方便地将HTML换为PDF。下面是一个基本的示例: 1. 首先,您需要引入iTextfreemarker的依赖项。如果您使用的是Maven,可以添加以下依赖项到pom.xml文件中: ``` &lt;dependency&gt; &lt;groupId&gt;com.lowagie&lt;/groupId&gt; &lt;artifactId&gt;itext&lt;/artifactId&gt; &lt;version&gt;2.1.7&lt;/version&gt; &lt;/dependency&gt; &lt;dependency&gt; &lt;groupId&gt;org.freemarker&lt;/groupId&gt; &lt;artifactId&gt;freemarker&lt;/artifactId&gt; &lt;version&gt;2.3.31&lt;/version&gt; &lt;/dependency&gt; ``` 2. 创建Freemarker模板,例如: ``` &lt;html&gt; &lt;head&gt; &lt;title&gt;${title}&lt;/title&gt; &lt;/head&gt; &lt;body&gt; &lt;h1&gt;${heading}&lt;/h1&gt; &lt;p&gt;${content}&lt;/p&gt; &lt;/body&gt; &lt;/html&gt; ``` 3. 创建Java类来生成PDF文件。例如: ``` import java.io.*; import java.util.*; import com.lowagie.text.*; import com.lowagie.text.pdf.*; import freemarker.template.*; public class HtmlToPdf { public static void main(String[] args) throws Exception { // 创建数据模型 Map&lt;String, Object&gt; data = new HashMap&lt;String, Object&gt;(); data.put(&quot;title&quot;, &quot;My PDF Document&quot;); data.put(&quot;heading&quot;, &quot;Hello World&quot;); data.put(&quot;content&quot;, &quot;This is my first PDF document.&quot;); // 创建Freemarker模板 Configuration cfg = new Configuration(Configuration.VERSION_2_3_31); cfg.setClassForTemplateLoading(HtmlToPdf.class, &quot;/&quot;); Template template = cfg.getTemplate(&quot;template.ftl&quot;); // 将Freemarker模板渲染为HTML StringWriter writer = new StringWriter(); template.process(data, writer); String html = writer.toString(); // 创建PDF文档 Document document = new Document(); PdfWriter.getInstance(document, new FileOutputStream(&quot;output.pdf&quot;)); document.open(); // 将HTML换为PDF InputStream is = new ByteArrayInputStream(html.getBytes()); XMLWorkerHelper.getInstance().parseXHtml(writer, document, is); // 关闭PDF文档 document.close(); } } ``` 这个示例将生成一个名为&ldquo;output.pdf&rdquo;的PDF文件,其中包含一个标题为&ldquo;My PDF Document&rdquo;的页面,以及一个标题为&ldquo;Hello World&rdquo;和内容为&ldquo;This is my first PDF document.&rdquo;的段落。 请注意,此示例仅是一个基本示例。您可以根据需要修改模板和Java代码以生成更复杂的PDF文件。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值