**1、前言** 由于最近要实现需求：余额调节表详情页面动态生成pdf推送到档案系统，经分析需求、查阅资料使用FreeMarker模板与Itext库可实现。 **2、概述** 本文档描述了如何在Java应用程序中使用FreeMarker模板引擎和iText库来生成PDF文档。FreeMarker用于定义和处理文档模板，而iText用于将模板的HTML输出转换为PDF格式 **3、步骤概要** 生成PDF的过程分为以下几个步骤： 1. **创建FreeMarker模板**：设计**.ftl模板文件，定义PDF中的内容和布局。 2. **配置FreeMarker**：在Java中设置FreeMarker，包括模板加载路径和编码格式。 3. **准备数据模型**：构建一个包含所有必要数据的模型，用于填充模板。 4. **处理模板**：使用FreeMarker的API将数据模型应用到模板，生成HTML内容。 5. **HTML到PDF的转换**：利用iText库将生成的HTML内容转换成PDF文档。 **4、代码示例** ``` // 引入相关依赖 org.freemarker freemarker 2.3.28 org.xhtmlrenderer flying-saucer-pdf 9.1.5 /** * * freemarker渲染html. * @param data data * @param htmlName 模板名称 * @return 模板 */ public static String freeMarkerRender(Map data, String htmlName) { Writer out = new StringWriter(); try { Configuration freemarkerCfg = new Configuration(); freemarkerCfg.setClassForTemplateLoading(PdfHtmlFreeMarkerUtil.class, "/"); // 获取模板,并设置编码方式 Template template = freemarkerCfg.getTemplate(htmlName); // set请求方式 template.setEncoding("UTF-8"); // 合并数据模型与模板将合并后的数据和模板写入到流中，这里使用的字符流 template.process(data, out); out.flush(); return out.toString(); } catch (Exception e) { LOGGER.error("渲染模板失败：{}", e.getMessage(), e); } finally { try { out.close(); } catch (IOException e) { LOGGER.error(e.getMessage(), e); } } return null; } /** * 根据模板生成pdf文件流. * * @param content 模板内容 * @return Base64 */ public static String createPdfBase64File(String content) { ByteArrayOutputStream outStream = new ByteArrayOutputStream(); // 初始化ITextRenderer ITextRenderer render = new ITextRenderer(); ITextFontResolver fontResolver = render.getFontResolver(); try { // 设置html字体 fontResolver.addFont("template/FangSong.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED); } catch (Exception e) { LOGGER.error("设置模板失败：{}", e.getMessage(), e); } // 解析html生成pdf render.setDocumentFromString(content); render.layout(); try { render.createPDF(outStream); byte[] data = outStream.toByteArray(); // 转为Base64编码返回 return Base64.encode(data); } catch (Exception e) { LOGGER.error("生成pdf失败：{}", e.getMessage(), e); } finally { try { outStream.close(); } catch (IOException e) { LOGGER.error(e.getMessage(), e); } } return null; } ``` **5、注意事项** * 确保模板文件路径正确，并且模板文件符合FreeMarker的语法规则。 * 数据模型应包含所有模板中引用的变量。 * 在转换HTML到PDF时，确保HTML内容是完整的，包括必要的头部和体标签。 * iText库可能需要额外的配置和许可，具体取决于使用的版本和功能。 **6、结论** 结合FreeMarker和iText库生成PDF是一种灵活且强大的方法，适用于需要动态生成复杂文档的Java应用程序。通过遵循上述步骤和注意事项，开发者可以轻松地实现自定义的PDF生成功能。

FreeMarker模板引擎与iText库结合生成PDF文档

FreeMarker模板引擎与iText库结合生成PDF文档

关于作者

目录