使用 GroupDocs.Signature for Java 設定文字簽章的綜合指南

介紹

在數位時代，確保文件的真實性對於處理合約或敏感資料的專業人員來說至關重要。 GroupDocs.Signature for Java 提供強大的簽章管理和搜尋功能解決方案。本教學將指導您設定 GroupDocs.Signature for Java，並示範如何在文件中搜尋文字簽名。

您將學到什麼：

在您的專案中為 Java 設定 GroupDocs.Signature
使用檔案路徑初始化簽名對象
新增進度事件處理程序來監視搜尋操作
在文件中搜尋文字簽名

在深入設定和實施過程之前，讓我們先探討一下先決條件。

先決條件

在開始之前，請確保您已：

所需的庫和依賴項

GroupDocs.簽名：使用 Maven 或 Gradle 在您的專案中包含 Java 的 GroupDocs.Signature。

環境設定要求

您的系統上安裝了 Java 開發工具包 (JDK)。
整合開發環境 (IDE)，如 IntelliJ IDEA、Eclipse 或 NetBeans。

知識前提

對 Java 程式設計有基本的了解。
熟悉建置和運行 Java 應用程式。

為 Java 設定 GroupDocs.Signature

整合 GroupDocs.簽名 進入您的項目，請按照下列步驟操作：

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

許可證獲取

免費試用：獲得免費試用版來探索功能。
臨時執照：如果需要，請在他們的網站上申請臨時許可證。
購買：如需完全存取權限，請從購買許可證 GroupDocs 購買頁面.

設定完成後，我們繼續執行實施指南。

實施指南

本節將引導您使用 GroupDocs.Signature for Java 設定和搜尋文字簽名。

功能1：設定簽名對象

概述

設定 Signature 物件對於使用簽名功能至關重要。此物件是文件中所有與簽名相關的操作的入口。

步驟：

初始化簽名對象

import com.groupdocs.signature.Signature;
import com.groupdocs.signature.exception.GroupDocsSignatureException;

public class SetupSignature {
    public static void run() throws Exception {
        // 定義文檔目錄的路徑
        String filePath = "YOUR_DOCUMENT_DIRECTORY";

        try {
            Signature signature = new Signature(filePath);
            System.out.println("Signature object created successfully.");
        } catch (Exception e) {
            throw new GroupDocsSignatureException(e.getMessage());
        }
    }
}

範圍： filePath 指定文檔的位置。
目的：初始化 Signature 物件以進行進一步的操作。

功能 2：在簽章搜尋過程中新增進度事件處理程序

概述

新增進度事件處理程序有助於監視和管理搜尋過程，確保應用程式的效率和回應能力。

步驟：

新增進度事件處理程序

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

public class AddProgressHandler {
    // 定義處理進度事件的方法
    private static void onSearchProgress(Signature sender, ProcessProgressEventArgs args) {
        if (args.getTicks() > 1000) { // 檢查過程是否耗時超過 1 秒
            args.setCancel(true);
            System.out.println("search progress was cancelled. Time spent " + args.getTicks() + " ms");
        }
    }

    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY";

        try {
            Signature signature = new Signature(filePath);
            // 將進度事件處理程序新增至搜尋過程
            signature.SearchProgress.add(new ProcessProgressEventHandler() {
                public void invoke(Signature sender, ProcessProgressEventArgs args) {
                    onSearchProgress(sender, args);
                }
            });
        } catch (Exception e) {
            throw new GroupDocsSignatureException(e.getMessage());
        }
    }
}

目的：監控搜尋過程，如果時間過長則取消。

功能 3：在文件中搜尋文字簽名

概述

搜尋文字簽名對於驗證文件真實性至關重要。此功能示範如何使用 GroupDocs.Signature 識別特定的文字簽名。

步驟：

搜尋文字簽名

import com.groupdocs.signature.Signature;
import com.groupdocs.signature.domain.signatures.TextSignature;
import com.groupdocs.signature.exception.GroupDocsSignatureException;
import com.groupdocs.signature.options.search.TextSearchOptions;

import java.util.List;

public class SearchTextSignatures {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY";

        try {
            Signature signature = new Signature(filePath);
            // 定義文字簽名的搜尋選項
            TextSearchOptions options = new TextSearchOptions("Text signature");
            // 在文件中搜尋文字簽名
            List<TextSignature> signatures = signature.search(TextSignature.class, options);
            System.out.println("Source document contains following signatures.");
            for (TextSignature textSignature : signatures) {
                System.out.println(
                    "Text signature found at page " + textSignature.getPageNumber() +
                    " with text: " + textSignature.getText()
                );
            }
        } catch (Exception e) {
            throw new GroupDocsSignatureException(e.getMessage());
        }
    }
}

參數： filePath 指定文檔位置； "Text signature" 定義要搜尋的內容。
目的：尋找並列出文件中指定文字簽名的所有實例。

實際應用

合約管理：透過在法律文件中搜尋授權簽字人的姓名或「批准」等短語來快速驗證簽署的合約。
發票處理：使用特定識別碼驗證發票，以確保正確處理和付款。
文件歸檔：根據某些簽署的存在自動對存檔文件進行分類，簡化檢索流程。

性能考慮

優化搜尋操作：使用精確的搜尋字詞來減少處理時間。
記憶體管理：定期監控資源使用；考慮對大型應用程式使用分析器。
最佳實踐：盡可能利用 GroupDocs.Signature 的內建快取和非同步操作。

結論

透過本指南，您已學習如何有效地設定和使用 GroupDocs.Signature for Java。運用這些技巧，即可透過高效率的簽章搜尋功能增強您的文件管理工作流程。