廢話不多說直接進(jìn)入正題，首先分析生成pdf場(chǎng)景及生成內(nèi)容，考慮復(fù)用性和維護(hù)難度是我們當(dāng)前開發(fā)工作的第一要?jiǎng)?wù)！

下面是調(diào)研的幾個(gè)主要方案：

一、itext 表單填充

使用方式：

itext表單填充方案是以pdf作為基礎(chǔ)模板，通過在pdf中嵌入表單元素組件的方式（需要使用pdf編輯工具），最后由程序進(jìn)行數(shù)據(jù)填充并另存為pdf結(jié)果。

方案優(yōu)缺點(diǎn)：

優(yōu)點(diǎn)：代碼優(yōu)雅，生成后格式變化影響極小。

缺點(diǎn)：原始模板變化需要重新生成pdf，重新編輯表單元素；不支持列表填充數(shù)據(jù)。

基于 Spring Boot + MyBatis Plus + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

項(xiàng)目地址：https://gitee.com/zhijiantianya/ruoyi-vue-pro

視頻教程：https://doc.iocoder.cn/video/

二、freemarker + doc4J 基于Word 生成 PDF

使用方式：

首先將調(diào)整好格式的原始 word 導(dǎo)出為 XML 格式，編輯 XML 模板中需要填充元素的位置，最后由程序處理先由freemarker模板工具替換元素內(nèi)容，再使用doc4J進(jìn)行pdf導(dǎo)出。

方案優(yōu)缺點(diǎn)：

優(yōu)點(diǎn)：通用性強(qiáng)，基于模板引擎功能強(qiáng)大。

缺點(diǎn)：XML 格式的word真的有夠復(fù)雜，想要在此模板上調(diào)整樣式真的難上加難；由于系統(tǒng)不支持的原因需要導(dǎo)入中文字體庫(kù)；doc4J 部分 doc 元素不支持（例如直線），導(dǎo)出格式差異較大。

這可能是由于doc4J迭代問題無法保證新元素的支持，導(dǎo)出結(jié)果比較奔放。。。

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

三、freemarker + aspose-words 導(dǎo)出PDF

使用方式：

類似于 freemarker+doc4J 方式，同樣需要編輯XML，導(dǎo)出格式相較doc4J而言有極大提升。

方案優(yōu)缺點(diǎn)：

優(yōu)點(diǎn)：通用性強(qiáng)，基于模板引擎功能強(qiáng)大，無需手工管理字體（macOS），代碼簡(jiǎn)單，導(dǎo)出格式與模板基本無差異。

缺點(diǎn)：需要編輯 XML 模板；該方案不是免費(fèi)版（當(dāng)然有大神）。

受限于調(diào)試前期需要的修修改改，模板能給人整吐了，所以才有了下一個(gè)方案。

四、html + freemarker + itextpdf（html2pdf）

使用方式：

翻譯 word 為 html 頁面（當(dāng)然就是手寫啦，還原度很重要?。?，html中模板元素插入（文字填充、列表循環(huán) freemarker 支持的全都能寫），最后由程序處理先由freemarker模板工具替換元素內(nèi)容，再使用html2pdf進(jìn)行pdf導(dǎo)出。

方案優(yōu)缺點(diǎn)：

優(yōu)點(diǎn)：可維護(hù)性相較與上面方案都有極大提升（調(diào)試可見性，動(dòng)態(tài)替換生效）；通用性強(qiáng)，基于模板引擎功能強(qiáng)大；導(dǎo)出格式可控性較強(qiáng)；

缺點(diǎn)：需要中文字體庫(kù)。

這個(gè)方案是綜合以上多次踩坑的結(jié)果，結(jié)果是顯而易見的。

淺淺來一點(diǎn)代碼，省的大家到處找

com.itextpdf
itextpdf
5.5.13


com.itextpdf
html2pdf
3.0.3


org.xhtmlrenderer
flying-saucer-pdf-itext5
9.0.3


binarta.oss
groovy-template-enginex-freemarker
0.1.3

個(gè)人以為自己的代碼會(huì)自解釋，就不貼太多注釋了

importcn.hutool.core.io.FileUtil;
importcn.hutool.core.map.MapUtil;
importcom.google.common.collect.Lists;
importcom.itextpdf.text.pdf.BaseFont;
importfreemarker.cache.ByteArrayTemplateLoader;
importfreemarker.template.Configuration;
importfreemarker.template.Template;
importlombok.SneakyThrows;
importorg.xhtmlrenderer.pdf.ITextFontResolver;
importorg.xhtmlrenderer.pdf.ITextRenderer;

importjava.io.BufferedWriter;
importjava.io.ByteArrayOutputStream;
importjava.io.File;
importjava.io.StringWriter;
importjava.nio.charset.Charset;
importjava.nio.charset.StandardCharsets;
importjava.util.List;
importjava.util.Locale;
importjava.util.Map;
importjava.util.Objects;
importjava.util.function.Supplier;

publicclassHtmlToPdfUtil{

privatestaticfinalByteArrayTemplateLoaderTEMPLATE_LOADER=newByteArrayTemplateLoader();

//導(dǎo)入需要字體庫(kù)的位置哦；simsun 為宋體
publicstaticfinalStringFRONT_PATH="/usr/share/fonts/simsun.ttc";

/**
*看明白的話只用這個(gè)方法就夠
*/
publicstaticByteArrayOutputStreamhtmlToPdf(StringtemplateName,SupplierloadTemplateSupplier,MapmodeViewMap){

Stringhtml=xmlFormat(templateName,loadTemplateSupplier,modeViewMap);

returnhtmlToPdf(html);
}

@SneakyThrows
publicstaticByteArrayOutputStreamhtmlToPdf(StringhtmlStr){
ByteArrayOutputStreamoutputStream=newByteArrayOutputStream();
ITextRendererrenderer=newITextRenderer();
renderer.setDocumentFromString(htmlStr);
ITextFontResolverresolver=renderer.getFontResolver();
//添加字體，解決中文不顯示的問題
resolver.addFont(FRONT_PATH,BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);
renderer.layout();
renderer.createPDF(outputStream);
returnoutputStream;
}


publicstaticStringxmlFormat(StringtemplateName,SupplierloadTemplateSupplier,MapmodeViewMap){
if(Objects.isNull(TEMPLATE_LOADER.findTemplateSource(templateName))){
synchronized(TEMPLATE_LOADER){
if(Objects.isNull(TEMPLATE_LOADER.findTemplateSource(templateName))){
TEMPLATE_LOADER.putTemplate(templateName,loadTemplateSupplier.get());
}
}
}
returnxmlFormat(templateName,modeViewMap);
}

@SneakyThrows
publicstaticStringxmlFormat(StringtemplateName,MapmodeViewMap){
Configurationcfg=newConfiguration(Configuration.DEFAULT_INCOMPATIBLE_IMPROVEMENTS);
//指定FreeMarker模板文件的位置
cfg.setTemplateLoader(TEMPLATE_LOADER);
//設(shè)置模板的編碼格式
cfg.setEncoding(Locale.CHINA,Charset.defaultCharset().name());
//獲取模板文件template
Templatetemplate=cfg.getTemplate(templateName,Charset.defaultCharset().name());
StringWriterstringWriter=newStringWriter();

BufferedWriterwriter=newBufferedWriter(stringWriter);
template.process(modeViewMap,writer);
returnstringWriter.toString();
}

}

結(jié)

解決這個(gè)問題的核心思路方案其實(shí)一直沒變，變化的只是工具，一定要思路清晰！

審核編輯：劉清