使用 GroupDocs.Signature 在 Java 中實作自訂元數據

介紹

在當今的數位時代，有效管理文件簽名對企業和個人都至關重要。無論是處理合約、協議還是官方文件，確保其真實性和可追溯性仍然是一項挑戰。 GroupDocs.Signature for Java 提供強大的解決方案來自動化和增強您的文件簽署流程。

在本教程中，我們將探索如何利用 GroupDocs.Signature 在 Java 應用程式中實作自訂元資料。我們將建立一個專門用於處理簽章相關元資料的資料類，以確保每個簽章文件都包含簽章者身分和時間戳記等重要資訊。

您將學到什麼：

在您的專案中為 Java 設定 GroupDocs.Signature。
使用 Java 建立自訂元資料類別。
將此功能有效地整合到實際應用程式中。
在 Java 中處理文件簽章時考慮效能。

有了這些見解，您將能夠更好地增強您的文件管理解決方案。首先，讓我們了解有效遵循本指南所需的先決條件。

先決條件

在深入實施之前，請確保您已具備以下條件：

所需的庫和版本

GroupDocs.Signature for Java：確保您擁有 23.12 或更高版本。
Java 開發工具包 (JDK)：建議使用 8 或更高版本。

環境設定

合適的整合開發環境 (IDE)，如 IntelliJ IDEA、Eclipse 或 NetBeans。
具有 Java 程式設計的基本知識並了解 Maven/Gradle 建置系統。

為 Java 設定 GroupDocs.Signature

若要將 GroupDocs.Signature 整合到您的專案中，請使用下列套件管理器之一：

Maven

在您的 pom.xml：

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

Gradle

將其包含在您的 build.gradle 文件：

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

直接下載

對於喜歡手動下載的用戶，請從 GroupDocs.Signature Java 版本.

許可證取得步驟

免費試用：首先嘗試免費試用版來探索其功能。
臨時執照：取得臨時許可證以進行延長測試。
購買：為了長期使用，請考慮購買完整許可證。

基本初始化和設定

要在 Java 應用程式中初始化 GroupDocs.Signature：

import com.groupdocs.signature.Signature;

public class SignatureSetup {
    public static void main(String[] args) {
        // 使用文檔路徑初始化簽名對象
        Signature signature = new Signature("path/to/your/document");
        
        System.out.println("GroupDocs.Signature initialized successfully.");
    }
}

此程式碼片段示範如何設定處理簽名的基本環境。

實施指南

在本節中，我們將重點介紹如何使用 GroupDocs.Signature 實作自訂元資料。

建立自訂元資料類

我們實施的核心是 DocumentSignatureData 類。此類儲存具有自訂屬性的簽章相關資料。

概述

此功能可讓您將簽署者 ID 和作者詳細資訊等附加資訊附加到文件簽名中，從而增強可追溯性和可問責性。

步驟 1：導入必要的函式庫

確保您已匯入所有必要的套件：

import com.groupdocs.signature.domain.extensions.serialization.FormatAttribute;
import java.util.Date;
import java.math.BigDecimal;

第 2 步：定義資料類

建立一個類別來封裝簽章元資料：

public class DocumentSignatureData {
    @FormatAttribute(propertyName = "SignID")
    public String ID;

    public String getID() { return ID; }
    public void setID(String value) { ID = value; }

    @FormatAttribute(propertyName = "SAuth")
    public String Author;

    public final String getAuthor() { return Author; }
    public final void setAuthor(String value) { Author = value; }
}

為什麼要使用 @FormatAttribute？ 此註釋確保屬性正確序列化，維護不同格式的資料完整性。

步驟 3：在 GroupDocs.Signature 中的使用

將此類與您的簽名處理邏輯整合：

import com.groupdocs.signature.domain.signatures.TextSignature;

public void addSignature(Signature signature) {
    DocumentSignatureData metadata = new DocumentSignatureData();
    metadata.setID("12345");
    metadata.setAuthor("John Doe");

    TextSignature textSign = new TextSignature("John's Signature");
    textSign.getSettings().setMetadata(metadata);

    // 將簽名新增到您的文件中
    signature.sign("path/to/output/document