登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›国产化PDF处理控件Spire.PDF教程：如何在 Java 中通过模 ...

国产化PDF处理控件Spire.PDF教程：如何在 Java 中通过模板生成 PDF

崔和美 3 小时前
1.png

在企业级应用开发中，生成 PDF 文档是一项非常常见的需求。无论是发票、报告、合同，还是其他业务文档，开发人员通常都需要一种高效、稳定的方式来创建 PDF。与其逐行绘制 PDF 内容，不如直接利用 模板 ——常见的模板形式包括 HTML 模板 和 PDF 模板 ，开发者只需将动态数据填充进去，就能快速生成所需文档。
E-iceblue旗下Spire系列产品，是文档处理领域的佼佼者，支持国产化信创。在本文中，我们将介绍如何使用 Spire.PDF for Java 通过模板生成 PDF 文件。文章不仅涵盖 HTML 模板和 PDF 模板的使用方法，还会提供一些高效生成文档的最佳实践和常见问题解答，帮助你在实际项目中更好地应用。
Spire.PDF for Java免费试用下载，请联系E-iceblue官方授权代理商慧都科技
加入Spire技术交流QQ群（125237868），与更多开发者一起提升文档开发技能。
Spire.PDF for Java 简介

Spire.PDF for Java是一个功能强大的 PDF 库，提供用于创建、读取、编辑和转换 PDF 文件的完整 API。它支持以下功能：

  • 从零生成 PDF ：可以从头开始创建全新的 PDF 文档。
  • 将 HTML 、图片和文本转换为 PDF ：支持将网页内容、图片或文本内容快速生成 PDF。
  • 修改或编辑现有 PDF ：可以对已有 PDF 文件进行内容更新或调整。
  • 操作文本、图片、表格和注释 ：提供丰富的文档处理能力，满足多样化需求。
安装：

  • 从官网下载 Spire.PDF for Java，并将 JAR 文件添加到项目的构建路径中。
  • 如果你使用 Maven 管理项目，可以在 pom.xml 中添加如下依赖：
Spire.PDF for Java免费试用下载，请联系E-iceblue官方授权代理商慧都科技
加入Spire技术交流QQ群（125237868），与更多开发者一起提升文档开发技能。
  1. <repositories>
  2.     <repository>
  3.         <id>com.e-iceblue</id>
  4.         <name>e-iceblue</name>
  5.         <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
  6.     </repository>
  7. </repositories>
  8. <dependencies>
  9.     <dependency>
  10.         <groupId>e-iceblue</groupId>
  11.         spire.pdf</artifactId>
  12.         <version>11.8.3</version>
  13.     </dependency>
  14. </dependencies>
复制代码
从 HTML 模板创建 PDF

HTML 模板非常灵活，允许你通过 CSS 样式 自定义文档布局和外观。在模板中，你可以定义 占位符 （使用 {{ }} 包裹），在运行时动态替换成实际数据，从而生成个性化的 PDF 文档。
安装 HTML 转 PDF 渲染引擎
Spire.PDF 依赖外部引擎来将 HTML 渲染为 PDF，可以选择 Qt WebEngine或 Google Chrome 。在本指南中，我们将使用 Qt WebEngine 。

  • 下载适用于操作系统的 Qt WebEngine 插件：

    • Windows x86
    • Windows x64
    • Linux x64
    • Mac x64

  • 将下载的文件解压到本地文件夹，并找到 plugins 目录，例如：C:\plugins-windows-x64\plugins
  • 在代码中配置插件路径：
  1. HtmlConverter.setPluginPath("C:\\plugins-windows-x64\\plugins");
复制代码
完成插件配置后，Spire.PDF 就可以将 HTML 完整渲染为 PDF，并支持 CSS 样式，实现高保真的文档转换。
示例：从 HTML 模板生成发票 PDF
  1. import com.spire.pdf.graphics.PdfMargins;
  2. import com.spire.pdf.htmlconverter.LoadHtmlType;
  3. import com.spire.pdf.htmlconverter.qt.HtmlConverter;
  4. import com.spire.pdf.htmlconverter.qt.Size;
  6. import java.util.HashMap;
  7. import java.util.Map;
  9. public class CreatePdfFromHtmlTemplate {
  11.     public static void main(String[] args) {
  13.         // HTML 模板，使用双大括号 {{}} 作为占位符变量
  14.         String htmlTemplate = "<!DOCTYPE html>\n" +
  15.                 "<html lang="zh">\n" +
  16.                 "<head>\n" +
  17.                 "    <meta charset="UTF-8">\n" +
  18.                 "    <meta name="viewport" content="width=device-width, initial-scale=1.0">\n" +
  19.                 "    <title>发票</title>\n" +
  20.                 "    \n" +
  21.                 "</head>\n" +
  22.                 "<body>\n" +
  23.                 "    \n" +
  24.                 "        <h1>发票</h1>\n" +
  25.                 "        <p>发票编号: {{INVOICE_NUMBER}}</p>\n" +
  26.                 "        <p>日期: {{INVOICE_DATE}}</p>\n" +
  27.                 "    \n" +
  28.                 "    \n" +
  29.                 "        <h2 style="margin-top: 50px;">开票给:</h2>\n" +
  30.                 "        <p>姓名: {{BILLER_NAME}}</p>\n" +
  31.                 "        <p>地址: {{BILLER_ADDRESS}}</p>\n" +
  32.                 "        <p>邮箱: {{BILLER_EMAIL}}</p>\n" +
  33.                 "    \n" +
  34.                 "    <table>\n" +
  35.                 "        <thead>\n" +
  36.                 "            <tr>\n" +
  37.                 "                <th>描述</th>\n" +
  38.                 "                <th>数量</th>\n" +
  39.                 "                <th>单价</th>\n" +
  40.                 "                <th>总计</th>\n" +
  41.                 "            </tr>\n" +
  42.                 "        </thead>\n" +
  43.                 "        <tbody>\n" +
  44.                 "            <tr>\n" +
  45.                 "                <td>{{ITEM_DESCRIPTION}}</td>\n" +
  46.                 "                <td>{{ITEM_QUANTITY}}</td>\n" +
  47.                 "                <td>{{ITEM_UNIT_PRICE}}</td>\n" +
  48.                 "                <td>{{ITEM_TOTAL}}</td>\n" +
  49.                 "            </tr>\n" +
  50.                 "            \n" +
  51.                 "        </tbody>\n" +
  52.                 "    </table>\n" +
  53.                 "    \n" +
  54.                 "        <p>小计: {{SUBTOTAL}}</p>\n" +
  55.                 "        <p>税率 ({{TAX_RATE}}%): {{TAX}}</p>\n" +
  56.                 "        <p>总计: {{TOTAL}}</p>\n" +
  57.                 "    \n" +
  58.                 "    \n" +
  59.                 "        <p>感谢您的惠顾！</p>\n" +
  60.                 "    \n" +
  61.                 "</body>\n" +
  62.                 "</html>";
  64.         // 发票示例数据 - 与模板占位符对应的键值对
  65.         Map<String, String> invoiceData = new HashMap<>();
  66.         invoiceData.put("INVOICE_NUMBER", "12345");
  67.         invoiceData.put("INVOICE_DATE", "2025-08-25");
  68.         invoiceData.put("BILLER_NAME", "张三");
  69.         invoiceData.put("BILLER_ADDRESS", "北京市朝阳区123号");
  70.         invoiceData.put("BILLER_EMAIL", "zhangsan@example.com
  71.                                 document.getElementById('cloak05a0bc07693e7fd0df1ec689a1a701df').innerHTML = '';
  72.                                 var prefix = 'ma' + 'il' + 'to';
  73.                                 var path = 'hr' + 'ef' + '=';
  74.                                 var addy05a0bc07693e7fd0df1ec689a1a701df = 'zhangsan' + '@';
  75.                                 addy05a0bc07693e7fd0df1ec689a1a701df = addy05a0bc07693e7fd0df1ec689a1a701df + 'example' + '.' + 'com';
  76.                                 var addy_text05a0bc07693e7fd0df1ec689a1a701df = 'zhangsan' + '@' + 'example' + '.' + 'com';document.getElementById('cloak05a0bc07693e7fd0df1ec689a1a701df').innerHTML += ''+addy_text05a0bc07693e7fd0df1ec689a1a701df+'<\/a>';
  77.                 ");
  78.         invoiceData.put("ITEM_DESCRIPTION", "咨询服务");
  79.         invoiceData.put("ITEM_QUANTITY", "10");
  80.         invoiceData.put("ITEM_UNIT_PRICE", "¥100");
  81.         invoiceData.put("ITEM_TOTAL", "¥1000");
  82.         invoiceData.put("SUBTOTAL", "¥1000");
  83.         invoiceData.put("TAX_RATE", "5");
  84.         invoiceData.put("TAX", "¥50");
  85.         invoiceData.put("TOTAL", "¥1050");
  87.         // 用实际数据填充 HTML 模板
  88.         String populatedInvoice = populateInvoice(htmlTemplate, invoiceData);
  90.         // 指定生成 PDF 的输出路径
  91.         String outputFile = "output/HtmlToPdf.pdf";
  93.         // 指定 HTML 转 PDF 转换器插件路径（QT 插件）
  94.         String pluginPath = "C:\\plugins-windows-x64\\plugins";
  96.         // 设置 HTML 转 PDF 所需的插件路径
  97.         HtmlConverter.setPluginPath(pluginPath);
  99.         // 将 HTML 字符串转换为 PDF 并指定相关设置
  100.         HtmlConverter.convert(populatedInvoice, outputFile,
  101.                 true, // 启用 JavaScript
  102.                 100000, // 超时时间（毫秒）
  103.                 new Size(595, 842), // A4 页面大小（595x842磅）
  104.                 new PdfMargins(20), // 四边 20 点边距
  105.                 LoadHtmlType.Source_Code); // 从 HTML 源代码字符串加载
  106.     }
  108.     // 辅助方法：用数据 Map 中的实际值替换模板占位符
  109.     private static String populateInvoice(String template, Map<String, String> data) {
  110.         String result = template;
  111.         for (Map.Entry<String, String> entry : data.entrySet()) {
  112.             result = result.replace("{{" + entry.getKey() + "}}", entry.getValue());
  113.         }
  114.         return result;
  115.     }
  116. }
复制代码
工作原理

  • 定义一个 HTML 模板，使用占位符 {{PLACEHOLDER_NAME}}。
  • 将实际数据存储在 Map 中。
  • 在运行时用实际数据替换占位符。
  • 使用 HtmlConverter.convert 生成带样式的 PDF。
这种方法非常适合 发票、收据和报表 等对格式有要求的文档生成场景。
效果图：
2.png

基于现有 PDF 模板生成 PDF

如果你已经有一个预先设计好的 PDF 表单或模板，可以直接在 PDF 内部 替换占位符 来生成新的文档。
示例：替换 PDF 模板中的文本
  1. import com.spire.pdf.PdfDocument;
  2. import com.spire.pdf.PdfPageBase;
  3. import com.spire.pdf.texts.PdfTextReplaceOptions;
  4. import com.spire.pdf.texts.PdfTextReplacer;
  5. import com.spire.pdf.texts.ReplaceActionType;
  7. import java.util.EnumSet;
  8. import java.util.HashMap;
  9. import java.util.Map;
  11. public class CreatePdfFromPdfTemplate {
  13.     public static void main(String[] args) {
  15.         // 创建 PdfDocument 对象
  16.         PdfDocument doc = new PdfDocument();
  18.         // 加载现有 PDF 文件
  19.         doc.loadFromFile("C:\\Users\\Administrator\\Desktop\\Template.pdf");
  21.         // 创建 PdfTextReplaceOptions 对象并指定替换选项
  22.         PdfTextReplaceOptions textReplaceOptions = new PdfTextReplaceOptions();
  23.         textReplaceOptions.setReplaceType(EnumSet.of(ReplaceActionType.WholeWord));
  25.         // 获取指定页面（此处为第一页）
  26.         PdfPageBase page = doc.getPages().get(0);
  28.         // 基于页面创建 PdfTextReplacer 对象
  29.         PdfTextReplacer textReplacer = new PdfTextReplacer(page);
  30.         textReplacer.setOptions(textReplaceOptions);
  32.         // 定义旧字符串和新字符串的字典
  33.         Map<String, String> replacements = new HashMap<>();
  34.         replacements.put("{PROJECT_NAME}", "新网站开发");
  35.         replacements.put("{PROJECT_NO}", "2023-001");
  36.         replacements.put("{PROJECT MANAGER}", "王五");
  37.         replacements.put("{PERIOD}", "2023年第3季度");
  38.         replacements.put("{START_DATE}", "2023年7月1日");
  39.         replacements.put("{END_DATE}", "2023年9月30日");
  41.         // 遍历字典，替换占位符文本
  42.         for (Map.Entry<String, String> pair : replacements.entrySet()) {
  43.             textReplacer.replaceText(pair.getKey(), pair.getValue());
  44.         }
  46.         // 保存修改后的 PDF 到新的文件
  47.         doc.saveToFile("output/ModifyTemplate.pdf");
  48.         doc.dispose();
  49.     }
  50. }
复制代码
工作原理

  • 加载现有 PDF 模板。
  • 使用 PdfTextReplacer 查找并替换占位符文本。
  • 将更新后的文件保存为新的 PDF。
注意事项

  • 此方法仅适用于 行内文本替换 ，适合替换 短文本 ，例如姓名、日期、ID 或项目编号。
  • 如果需要插入 多行文本 （例如长描述、条款或表格行），此方法不适用，因为 PDF 文本替换不会自动调整页面布局。
多行文本的替代方案

  • 设计 HTML 或 Word 模板，然后转换为 PDF。
  • 使用 Spire.PDF 的文本绘制 API 编程生成新的文本块到 PDF 页面上。
效果图：
3.png

使用模板生成 PDF 的最佳实践


  • 使用 HTML 模板以获得灵活性 ：适合发票、收据和报表等场景，尤其是需要处理长文本块、表格和 CSS 样式的文档。
  • 使用 PDF 模板以保证严格布局 ：适合简单的占位符替换，如项目名称、日期或编号等固定内容。
  • 在适当情况下使用 Word 模板 ：如果你的模板是 Word 格式，可以使用 Spire.Doc for Java。它支持在 Word 文件中修改占位符，并直接导出为 PDF。
  • 保持占位符唯一性 ：使用清晰的标记，例如 {START_DATE} 或 {END_DATE}，以避免意外替换。
  • 集中管理模板 ：将模板存放在代码外部，以便于更新和维护。
  • 使用真实数据进行测试 ：在投入生产使用前，务必验证格式、对齐方式和文本换行效果。
常见问题与解答

Q1：我可以在 Java 中通过 Word 模板创建 PDF 文件吗？

可以，但需要使用 Spire.Doc for Java。它允许你替换 Word 文档中的占位符，然后将结果导出为 PDF。
Q2：在通过模板生成 PDF 时，我可以添加图片或图表吗？

可以。使用 Spire.PDF，无论是基于 HTML 模板生成，还是修改现有 PDF 模板，都可以嵌入图片、图表和形状。
Q3：HTML 转 PDF 是否需要 Qt WebEngine 或 Google Chrome？

是的，需要插件来准确渲染带样式和 CSS 的 HTML。

  • Qt WebEngine ：易于配置，轻量级，且在 Spire.PDF 示例中常用。
  • Google Chrome ：对于复杂的现代网页（尤其是包含高级 CSS 或 JavaScript 的页面）提供更高保真度。
建议：简单文档使用 Qt WebEngine，要求与最新浏览器渲染效果一致时使用 Google Chrome。
Q4：Spire.PDF for Java 支持模板中的多语言文本吗？

支持。Spire.PDF 完全支持 Unicode，可以生成包含多种语言（如英文、中文、阿拉伯语或印地语）的 PDF，且不会丢失格式。
总结

通过将 Spire.PDF集成到 Java 项目中，你可以从 HTML 模板 或 PDF 模板 高效生成专业的 PDF 文档。根据不同场景的需求：

  • 使用 PDF 模板 ：适合轻量级文本替换。
  • 使用 HTML 模板 ：当需要丰富的格式、表格、图片或多行内容时更合适。
  • 配置 Qt WebEngine 或 Google Chrome ：确保 HTML 转 PDF 的渲染准确无误。
如果你的工作流程已经依赖 Word 模板，可以考虑使用 Spire.Doc for Java ，它能够：

  • 轻松替换 Word 文档中的占位符。
  • 保留所有 Word 格式、样式和布局。
  • 无损导出为 PDF，确保文档高保真。
这种灵活性让你可以根据模板格式选择合适的工具 —— Spire.PDF 或 Spire.Doc ，从而确保 PDF 输出既高效又高质量。
Spire.PDF for Java免费试用下载，请联系E-iceblue官方授权代理商慧都科技
加入Spire技术交流QQ群（125237868），与更多开发者一起提升文档开发技能。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
PDF国产化处理控件Spire

使用道具 举报

相关推荐
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
崔和美
3 小时前

0

粉丝关注

20

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫