如何使用 GroupDocs.Signature 在 Java 中實作條碼簽章搜尋

介紹

在當今的數位時代，確保文件的真實性和完整性至關重要。無論您是法律專業人士、業務經理還是軟體開發人員，高效管理文件簽名都能節省時間並防止詐欺。本教學將指導您使用 GroupDocs.Signature（一個功能強大的庫，旨在處理各種類型的電子簽名）在 Java 中實現條碼簽名搜尋。

您將學到什麼：

為 Java 設定 GroupDocs.Signature
在文件處理期間訂閱與搜尋相關的事件
配置並執行條碼簽名搜索

讓我們深入了解如何使用這些工具簡化您的文件管理流程。在開始之前，我們先來了解先決條件。

先決條件

要遵循本教程，請確保您已具備：

Java 開發工具包 (JDK)：版本 8 或更高版本
Maven 或者 Gradle：用於依賴管理
具備 Java 程式設計基礎並熟悉 Maven/Gradle 項目

此外，GroupDocs.Signature for Java 應該整合到您的專案中。您可以獲得臨時許可證，以不受限制地使用其全部功能。

為 Java 設定 GroupDocs.Signature

要在 Java 應用程式中使用 GroupDocs.Signature，您需要先設定該程式庫。以下是使用 Maven 或 Gradle 的操作方法：

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 網站上申請臨時許可證以獲得完全存取權限。
購買：如果滿意，請考慮購買長期使用的許可證。

一旦完成所有設置，讓我們在 Java 中初始化並配置基本設置：

import com.groupdocs.signature.Signature;

public class SignatureSetup {
    public static void main(String[] args) {
        // 使用文件路徑初始化簽章實例
        Signature signature = new Signature("YOUR_DOCUMENT_PATH");
        
        System.out.println("GroupDocs.Signature for Java initialized successfully.");
    }
}

實施指南

我們將把實施過程分解為幾個關鍵特徵，以便於理解。

功能一：搜尋事件訂閱

概述

此功能使您能夠在文件簽名搜尋過程中訂閱和回應與搜尋相關的事件，提供進度更新和完成狀態等有價值的見解。

逐步實施

步驟1：初始化簽名對象

Signature signature = new Signature("YOUR_DOCUMENT_PATH");

第 2 步：訂閱搜尋事件

新增搜尋開始、進行和完成時的事件處理程序：

signature.SearchStarted.add(new ProcessStartEventHandler() {
    public void invoke(Signature sender, ProcessStartEventArgs args) {
        System.out.println("Search process started at " + args.getStarted()
            + " with " + args.getTotalSignatures() + " total signatures to be put in document");
    }
});

signature.SearchProgress.add(new ProcessProgressEventHandler() {
    public void invoke(Signature sender, ProcessProgressEventArgs args) {
        System.out.println("Search progress. Processed " + args.getProcessedSignatures()
            + " signatures. Time spent " + args.getTicks() + " mlsec");
    }
});

signature.SearchCompleted.add(new ProcessCompleteEventHandler() {
    public void invoke(Signature sender, ProcessCompleteEventArgs args) {
        System.out.println("Search process completed at " + args.getCompleted()
            + " with " + args.getTotalSignatures() + " total signatures. Process took "
            + args.getTicks() + " mlsec");
    }
});

參數說明：

進程啟動事件參數：提供開始時間和簽名總數。
進程進度事件參數：提供即時進度更新。
進程完成事件參數：詳細說明完成狀態和持續時間。

功能2：條碼搜尋選項配置

概述

配置您的搜尋選項以查找特定的條碼簽名，包括頁面設定和文字匹配條件。

逐步實施

步驟 1：建立 BarcodeSearchOptions 對象

import com.groupdocs.signature.domain.enums.TextMatchType;
import com.groupdocs.signature.options.search.BarcodeSearchOptions;

BarcodeSearchOptions options = new BarcodeSearchOptions();

第 2 步：配置搜尋選項

設定頁面和文字匹配條件：

options.setAllPages(false);
options.setPageNumber(1);

import com.groupdocs.signature.options.PagesSetup;

PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setFirstPage(true);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(false);
options.setPagesSetup(pagesSetup);

options.setMatchType(TextMatchType.Contains);
options.setText("12345");

關鍵配置選項：

設定所有頁面：搜尋所有頁面還是特定頁面。
設定頁碼：指定特定的頁碼。
文字匹配類型：定義文字的匹配方式（例如，包含、精確）。

功能3：條碼簽名搜尋執行

概述

執行配置的條碼簽名搜尋並處理結果。

逐步實施

步驟 1：執行搜尋

import java.util.List;
import com.groupdocs.signature.domain.signatures.BarcodeSignature;

try {
    List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);
    System.out.println("Source document contains following signatures.");
    
    for (BarcodeSignature barcodeSignature : signatures) {
        System.out.println("Barcode signature found at page " + barcodeSignature.getPageNumber()
            + " with type " + barcodeSignature.getEncodeType() + " and text " + barcodeSignature.getText());
    }
} catch (Exception e) {
    throw new RuntimeException(e.getMessage(), e);
}

解釋：

搜尋：根據指定的選項執行搜尋。
條碼簽名.類：定義正在搜尋的簽名類型。

實際應用

以下是一些在現實世界中實施條碼簽名搜尋的用例：

法律文件驗證：自動驗證法律合約中的簽名以確保真實性。
供應鏈管理：追蹤文件批准並使用條碼簽名驗證貨物。
醫療記錄：透過使用條碼驗證電子簽名來保護病患記錄。

這些應用證明了 GroupDocs.Signature for Java 在各產業的多功能性，提高了安全性和效率。

性能考慮

使用 Java 中的 GroupDocs.Signature 時，請考慮以下技巧來優化效能：

批次處理：批次處理文件以有效管理記憶體使用情況。
資源管理：使用後及時釋放資源，防止記憶體洩漏。
Java記憶體管理：透過管理物件生命週期有效利用垃圾收集。

結論

現在，您已經學習如何使用 GroupDocs.Signature for Java 實作條碼簽章搜尋。遵循本指南，您可以利用強大的搜尋功能和事件處理功能來增強您的文件管理系統。下一步可以包括探索庫支援的其他類型的簽名，或將這些功能整合到更大的系統中。