使用 GroupDocs.Signature for Java 實作帶有事件處理的文字簽名

介紹

在當今的數位世界中，高效的文件工作流程管理對於業務專業人員和開發人員都至關重要。本教學將指導您使用 GroupDocs.Signature for Java 在 Java 中實作文字簽名，重點介紹事件處理，以便有效監控簽名過程。

您將學到什麼：

設定並使用 GroupDocs.Signature for Java
在簽章過程中實現開始、進度和完成事件
處理文字簽名選項並自訂位置

讓我們開始設定您的環境！

先決條件

在使用事件處理實作文字簽章之前，請確保已滿足以下先決條件：

所需的庫和依賴項

若要使用適用於 Java 的 GroupDocs.Signature，請將其新增至您的專案。請根據您的建置工具執行以下步驟：

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 版本.

環境設定

確保您的開發環境配置了：

JDK 8 或更高版本
相容的 IDE（例如 IntelliJ IDEA、Eclipse）
如果使用這些工具，請安裝 Maven 或 Gradle

知識前提

當我們探索實作細節時，對 Java 程式設計和事件驅動架構的基本了解將會很有幫助。

為 Java 設定 GroupDocs.Signature

要開始使用 GroupDocs.Signature for Java：

安裝：將相依性新增至專案的建置檔（Maven 或 Gradle）中，如上所示。
許可證獲取：從取得免費試用許可證群組文檔，購買完整許可證，或申請臨時許可證以進行延長測試。

準備好函式庫並設定好環境後，在 Java 應用程式中初始化 GroupDocs.Signature：

import com.groupdocs.signature.Signature;

public class SignatureSetup {
    public static void main(String[] args) {
        String filePath = "path/to/your/document.pdf";
        Signature signature = new Signature(filePath);
        
        // 您的文件現在可以使用 GroupDocs.Signature for Java 進行簽署。
    }
}

實施指南

簽名流程開始事件

簽名過程從開始的那一刻起即可監控。以下是處理開始事件的方法：

概述

此功能可讓您的應用程式在簽名操作開始時做出回應，從而提供有關啟動詳細資訊的見解。

步驟

3.1 定義事件處理程序 建立事件處理程序方法，用於在簽章過程開始時發出通知：

import com.groupdocs.signature.handler.events.ProcessStartEventArgs;
import com.groupdocs.signature.handler.events.ProcessStartEventHandler;

public class SignProcessStart {
    public static void onSignStarted(Signature sender, ProcessStartEventArgs args) {
        System.out.println("Signing process started: " + args.getSignatureDefinition().getSignatureType());
    }
}

3.2 訂閱事件 訂閱 SignStarted 主要簽名方法中的事件：

signature.SignStarted.add(new ProcessStartEventHandler() {
    public void invoke(Signature sender, ProcessStartEventArgs args) {
        SignProcessStart.onSignStarted(sender, args);
    }
});

簽名進度事件

追蹤進度可以實現即時更新或有效處理長期運行的流程。

概述

此功能可追蹤簽名操作的進度並提供狀態更新。

步驟

3.1 定義進度事件處理程序 設定一種方法來捕獲進度詳細資訊：

import com.groupdocs.signature.handler.events.ProcessProgressEventArgs;
import com.groupdocs.signature.handler.events.ProcessProgressEventHandler;

public class SignProgress {
    public static void onSignProgress(Signature sender, ProcessProgressEventArgs args) {
        System.out.println("Signing progress: " + args.getPercentCompleted() + "% completed");
    }
}

3.2 訂閱Progress事件 新增進度更新事件監聽器：

signature.SignProgress.add(new ProcessProgressEventHandler() {
    public void invoke(Signature sender, ProcessProgressEventArgs args) {
        SignProgress.onSignProgress(sender, args);
    }
});

簽名完成事件

了解簽名過程何時完成可以方便後續操作或記錄。

概述

此功能會在簽名操作完成後通知您的應用程式。

步驟

3.1 定義完成事件處理程序 流程完成後擷取詳細資訊：

import com.groupdocs.signature.handler.events.ProcessCompleteEventArgs;
import com.groupdocs.signature.handler.events.ProcessCompleteEventHandler;

public class SignCompletion {
    public static void onSignCompleted(Signature sender, ProcessCompleteEventArgs args) {
        System.out.println("Signing completed: " + args.getSignatureDefinition().getSignatureType());
    }
}

3.2 訂閱完成事件 監聽完成事件：

signature.SignCompleted.add(new ProcessCompleteEventHandler() {
    public void invoke(Signature sender, ProcessCompleteEventArgs args) {
        SignCompletion.onSignCompleted(sender, args);
    }
});

文字簽名

現在已經設定了事件處理，請實作文字簽章簽章。

概述

此功能示範如何使用 GroupDocs.Signature for Java 對文件進行基於文字的簽章。

步驟

3.1 簽署文件 定義執行實際簽章操作的方法：

import com.groupdocs.signature.options.sign.TextSignOptions;
import java.io.File;
import java.nio.file.Paths;

public class SignWithTextSignature {
    public static void signDocument() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY";
        String fileName = Paths.get(filePath).getFileName().toString();
        
        String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY", "SignWithTextEvents/" + fileName).getPath();
        Signature signature = new Signature(filePath);

        // 訂閱簽名活動
        signature.SignStarted.add(new ProcessStartEventHandler() {
            public void invoke(Signature sender, ProcessStartEventArgs args) {
                SignProcessStart.onSignStarted(sender, args);
            }
        });

        signature.SignProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                SignProgress.onSignProgress(sender, args);
            }
        });

        signature.SignCompleted.add(new ProcessCompleteEventHandler() {
            public void invoke(Signature sender, ProcessCompleteEventArgs args) {
                SignCompletion.onSignCompleted(sender, args);
            }
        });

        // 定義文字簽名選項
        TextSignOptions options = new TextSignOptions("John Smith");
        options.setLeft(100);  // 設定簽名左側位置
        options.setTop(100);   // 設定簽名的頂部位置
        
        // 執行簽名操作
        signature.sign(outputFilePath, options);
    }
}

結論

透過本指南，您學習如何使用 GroupDocs.Signature for Java 和事件處理功能在 Java 中實作文字簽章。此方法可以增強應用程式的功能，並即時洞察文件簽名流程。

後續步驟：

試試 GroupDocs.Signature 中提供的不同簽章選項。
探索其他功能，例如數位簽名或基於影像的簽名。
考慮將此解決方案整合到更大的應用程式中以增強工作流程自動化。