如何使用 GroupDocs.Signature for Java 为 PDF 文档签名二维码

在当今的数字时代，安全地签署文件比以往任何时候都更加重要。无论您是商务人士还是想要验证文件的个人，合适的工具都能发挥重要作用。本教程将指导您如何使用 GroupDocs.Signature for Java 使用包含 Mailmark2D 对象等复杂数据的二维码对 PDF 文档进行签名。我们将涵盖从环境设置到高级功能实现的所有内容。

您将学到什么

  • 如何为 Java 设置 GroupDocs.Signature
  • 创建和配置用于签名 PDF 的二维码
  • 利用 Mailmark2D 对象进行复杂的数据编码
  • 此功能在实际场景中的实际应用

准备好开始了吗？我们先来了解一下先决条件。

先决条件

在开始之前，请确保您已：

  • Java 开发工具包 (JDK)：版本 8 或更高版本。
  • 集成开发环境 (IDE) 比如 IntelliJ IDEA 或 Eclipse。
  • 对 Java 编程和 Maven/Gradle 构建工具有基本的了解。

所需的库和依赖项

要使用 GroupDocs.Signature for Java，您需要将该库添加到您的项目中。具体方法如下：

Maven：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

Gradle：

implementation 'com.groupdocs:groupdocs-signature:23.12'

直接下载：
对于不使用构建管理器的用户，请从下载最新版本 GroupDocs.Signature Java 版本.

许可证获取

GroupDocs 提供多种许可选项：

  • 免费试用：从试用开始探索功能。
  • 临时执照：获取临时许可证以进行延长测试。
  • 购买：购买用于生产用途的完整许可证。

为 Java 设置 GroupDocs.Signature

准备好环境并包含库后，初始化 GroupDocs.Signature。此设置对于访问其所有功能至关重要：

import com.groupdocs.signature.Signature;

class SetupGroupDocs {
    public static void main(String[] args) {
        Signature signature = new Signature("YOUR_DOCUMENT_DIRECTORY");
        // 您现在可以使用“签名”来签署文件。
    }
}

实施指南

使用二维码签署文件

概述

此功能允许您在 PDF 文档中添加二维码作为数字签名。二维码将包含 Mailmark2D 对象中编码的复杂数据。

步骤1：导入所需的包

import com.groupdocs.signature.Signature;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;
import com.groupdocs.signature.options.sign.QrCodeSignOptions;

步骤2：设置文件路径并初始化签名对象 设置源文档和输出文件的路径。初始化 Signature 带有 PDF 路径的对象：

String filePath = "YOUR_DOCUMENT_DIRECTORY";
String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignWithQRCodeMailmark2DObject.pdf";

final Signature signature = new Signature(filePath);

步骤 3：创建二维码签名选项 使用类型、位置和数据等特定设置配置二维码：

QrCodeSignOptions options = new QrCodeSignOptions();
options.setEncodeType(QrCodeTypes.QR); // 设置二维码类型
options.setLeft(100); // 放置的 X 坐标
options.setTop(100);  // 放置的 Y 坐标

步骤4：签署文件 执行签名流程并保存签名后的文档：

try {
    signature.sign(outputFilePath, options);
} finally {
    if (signature != null) signature.dispose();
}

创建 Mailmark2D 数据对象

概述

Mailmark2D 对象用于在二维码中编码复杂数据。本节介绍如何配置此对象。

步骤1：导入所需的包

import com.groupdocs.signature.domain.extensions.mailmark2d.Mailmark2D;
import com.groupdocs.signature.domain.extensions.mailmark2d.Mailmark2DType;
import com.groupdocs.signature.domain.extensions.serialization.DataMatrixEncodeMode;

步骤2：初始化并配置Mailmark2D对象 设置 Mailmark2D 对象的各种属性来定义复杂数据：

Mailmark2D mailmark2D = new Mailmark2D();
mailmark2D.setUPUCountryID("JGB "); // 邮政服务国家/地区 ID
mailmark2D.setInformationTypeID("0"); // 信息类型标识符
mailmark2D.setClass("1"); // 邮件处理类
mailmark2D.setSupplyChainID(123); // 供应链标识
mailmark2D.setItemID(1234); // 唯一商品 ID
mailmark2D.setDestinationPostCodeAndDPS("QWE1"); // 目的地邮政编码
mailmark2D.setRTSFlag("0"); // 退回发件人标志
mailmark2D.setReturnToSenderPostCode("QWE2"); // 退货邮政编码
mailmark2D.setDataMatrixType(Mailmark2DType.Type_7); // 数据矩阵类型
mailmark2D.setCustomerContentEncodeMode(DataMatrixEncodeMode.C40); // 编码模式
mailmark2D.setCustomerContent("CUSTOM"); // 自定义内容

实际应用

  1. 法律文件认证：确保法律文件已签署并通过二维码验证。
  2. 发票处理：将二维码附加到发票上，以便于跟踪和验证。
  3. 运输标签：使用运输标签上的二维码来编码详细的跟踪信息。
  4. 活动门票：通过在门票上的二维码中嵌入活动详情来增强安全性。
  5. 供应链管理：使用二维码 Mailmark2D 数据简化物流。

性能考虑

  • 通过有效管理内存使用来优化性能，尤其是在处理大型 PDF 文件时。
  • 如果集成到 Web 应用程序，请使用异步处理以避免阻塞操作。
  • 定期更新 GroupDocs.Signature 以利用改进和错误修复。

结论

通过本指南，您学习了如何使用 GroupDocs.Signature for Java 为带有二维码的 PDF 文档签名。这项强大的功能可以集成到各种工作流程中，以增强文档安全性并简化流程。为了进一步探索 GroupDocs.Signature 的功能，您可以尝试不同的配置或将其与其他系统集成。

常见问题解答部分

  1. 我可以免费使用 GroupDocs.Signature 吗？
    是的，您可以先免费试用一下，测试其功能。
  2. 可以使用该库签署哪些类型的文档？
    除了 PDF，您还可以签署图像、Word 文档、Excel 电子表格等。
  3. 如何解决签名错误？
    检查错误日志中的特定消息并确保所有依赖项都已正确配置。
  4. 我可以自定义二维码的外观吗？
    是的，您可以使用以下方式调整大小、位置和其他属性 QrCodeSignOptions。
  5. 可以一次签署多份文件吗？
    虽然 GroupDocs.Signature 一次处理一个文档，但您可以编写批处理脚本以提高效率。

资源

利用这些资源，您可以加深对 GroupDocs.Signature 的理解，并在您的应用程序中扩展其功能。祝您编码愉快！