如何使用 GroupDocs.Signature for Java 向 PDF 添加条形码

将机器可读的数据直接嵌入 PDF(或任何受支持的文档)可实现自动化验证、简化数据捕获,并保持防篡改的审计追踪。在本教程中,您将学习如何使用 GroupDocs.Signature for Java 向 PDF 添加条形码,涵盖从 QR 码创建到验证和管理的全部内容。该库支持超过 55 种文件格式,因此相同的代码可用于 Word、图像、归档等。

快速答案

  • 需要哪个库? GroupDocs.Signature for Java(可通过 Maven Central 获取)。
  • 需要哪个 Java 版本? Java 8 或更高版本。
  • 我可以向 PDF 及其他格式添加条形码吗? 可以——API 支持 55+ 种格式,包括 PDF、DOCX、XLSX、PNG、TAR、ZIP 等。
  • 支持哪些条形码类型? QR Code、Data Matrix、Code128、Code39、HIBC、GS1 Composite 等多种。
  • 生产环境需要许可证吗? 商业使用必须拥有有效的 GroupDocs.Signature 许可证;提供免费试用供测试。
  • 需要多少行代码? 通常 5‑10 行即可创建并嵌入 QR 码条形码。

如何使用 GroupDocs.Signature for Java 向 PDF 添加条形码?

加载目标 PDF,配置条形码选项,然后调用 sign 方法——这就是全部所需。API 直接在文档上写入条形码,同时保留原始文件结构,最终得到可供扫描或自动验证的已签名 PDF。

您只需三个简单步骤即可向 PDF 添加条形码:初始化 Signature 处理器,使用所需的条形码类型和视觉设置配置 BarcodeSignOptions,最后调用 sign 将条形码嵌入并保存输出文件。

什么是 QR 码签名?

QR 码签名是一种基于条形码的数字签名,将自定义数据存储在附加到文档的 QR 码可视元素中。通过扫描 QR 码即可获取嵌入的信息,实现无需更改文件原始内容的自动验证和数据提取。

为什么在文档中使用条形码签名?

条形码签名解决了一个常见问题:在不更改文档内容的前提下安全地附加机器可读的元数据。它们实现自动化数据捕获、提升验证效率并简化工作流,使企业能够更轻松地将文档处理与现有系统集成,同时保持完整性和合规性。

使用 Java 创建 QR 码签名 入门

在编写代码之前,请确保您已具备:

  • 已安装 Java 8 或更高版本。
  • 已在项目中添加 GroupDocs.Signature for Java(Maven 依赖或手动 JAR)。
  • 已放置有效的 GroupDocs.Signature 许可证文件(或试用密钥),使 SDK 能读取。

典型工作流如下:

  1. 使用源文件路径初始化 Signature 对象。
  2. 配置 BarcodeSignOptions——选择条形码类型,设置数据字符串、尺寸、颜色和位置。
  3. 调用 sign 将条形码嵌入并将已签名文档写入磁盘。

选择合适的条形码类型

不确定使用哪种条形码?以下是快速决策指南:

  • 针对 URL 或长文本(约 4,000 字符)——QR Code 最灵活,适用于任何智能手机摄像头。
  • 用于医疗或药品追踪——HIBC LIC 条码(QR、Aztec 或 Data Matrix 变体)符合行业规范。
  • 用于零售或供应链(GS1 标准)——GS1 Composite 或 GS1‑128 提供所需的数据结构。
  • 用于紧凑的数字数据——Code128 或 Code39 适合追踪号或序列码。
  • 用于大数据集且需纠错——Data Matrix 或 Aztec 能在更小区域内容纳更多数据,即使部分受损仍可读取。

专业提示: 如果不确定,请先使用 QR Code;它提供最高的兼容性和纠错选项。

如何在 Java 中创建 QR 码签名

要创建 QR 码签名,首先将 PDF 文件加载到 Signature 实例中,然后实例化 BarcodeSignOptions,指定 BarcodeTypes.QR 并提供要嵌入的数据(例如 URL 或 JSON 负载)。根据需要调整尺寸、颜色和位置,最后调用 sign 方法,该方法将在文档上渲染 QR 码并返回表示成功与签名位置的结果。

步骤 1:初始化 Signature 处理器

Signature 是所有签名、搜索和验证操作的入口。它抽象了对 PDF、Word 文档、图像和归档格式的文件处理。

步骤 2:配置 BarcodeSignOptions

BarcodeSignOptions 是用于在条形码签名应用到文档之前指定其所有视觉和数据属性的选项类。

典型设置包括:

  • 条形码类型 – BarcodeTypes.QR
  • 要嵌入的数据 – 任意 UTF‑8 字符串,例如 URL 或 JSON 负载
  • 尺寸 – 以点为单位的宽高(例如 120 × 120)
  • 位置 – 页面编号、X/Y 坐标或对齐标志
  • 视觉样式 – 前景/背景颜色、不透明度、旋转

步骤 3:签名并保存文档

调用 sign 将条形码写入文档,并返回一个结果对象,指示操作是否成功以及条形码的放置位置。

常见使用场景

开发者使用 QR 码签名用于:

  • 发票处理 – 编码发票号码和金额;会计软件扫描后自动填充支付系统。
  • 文档追踪 – 为合同添加唯一条形码;扫描后可即时获取版本历史和审批状态。
  • 仓库管理 – 在运输标签上签署产品 SKU 条形码;扫描器实时更新库存。
  • 合规与审计追踪 – 嵌入验证码,证明文档自签名后未被篡改。
  • 医疗记录 – 在患者文件上使用符合 HIBC 标准的条形码,以确保正确追踪和符合法规。

可用教程

下面您会找到针对每种条形码签名操作的逐步指南。每个教程都包含完整可运行的 Java 代码,您可以根据项目进行改编。

条形码签名的最佳实践

  • 保持条形码内容简短 – 目标不超过 500 字符;较小的条形码扫描更快,在低分辨率下渲染更清晰。
  • 在生产前进行扫描测试 – 确认用户实际使用的扫描仪能够读取所选格式。
  • 保持条形码放置一致 – 右下角或其他固定位置可提升自动扫描的可靠性。
  • 启用纠错 – 使用 QR Code 的 “H” 级别或 Data Matrix 的高 ECC 模式,以提高抗损坏能力。
  • 与可视签名结合 – 将条形码与传统数字签名配对,实现机器和人工双重验证。
  • 优雅地处理验证失败 – 记录任何不匹配;这可能表明篡改,应触发安全警报。

常见问题

问:我可以在商业应用中使用条形码签名吗?
答:可以,只要您拥有有效的 GroupDocs.Signature 许可证。提供免费试用供评估。

问:条形码签名能在受密码保护的 PDF 上使用吗?
答:完全可以。在创建 Signature 实例时提供文档密码,API 将自动解密、签名并重新加密文件。

问:推荐哪种条形码格式用于移动扫描?
答:QR Code 和 Data Matrix 兼容性最佳,内置纠错,适合现场工作人员。

问:如何在不重新签署整个文档的情况下更新已有条形码?
答:使用 “初始化和更新” 教程中展示的 BarcodeSignOptions 更新方法——可以就地修改内容、尺寸或位置,保留文件其余部分。

问:对成千上万的 PDF 进行签名会有性能影响吗?
答:API 针对批量操作进行了优化;复用单个 Signature 实例并关闭详细日志可最大化吞吐量。标准 8 核服务器的典型吞吐量超过每分钟 200 份文档。

资源

结论

使用 GroupDocs.Signature for Java 向 PDF 添加 QR 码或其他条形码非常简单。按照上述步骤,您可以将安全的机器可读数据嵌入任何受支持的文档类型,实现数据捕获自动化,并确保文档完整性。浏览链接的教程以深入了解——无论是大规模管理条形码、在归档中验证,还是遵循 HIBC 或 GS1 等行业特定标准。


最后更新: 2026-11-01
测试环境: GroupDocs.Signature for Java 23.12 (latest at time of writing)
作者: GroupDocs

相关教程

Initialize a `Signature` instance with the source file, create a `BarcodeSignOptions` object set to QR code type, assign the data you want to embed, specify position and size, then call `sign` to produce the output file.