使用 GroupDocs.Signature for Java 掌握 TAR 檔案條碼和二維碼搜尋

介紹

透過條碼或二維碼簽章驗證 TAR 檔案中儲存文件的真實性可能頗具挑戰性。本教程將指導您使用 GroupDocs.Signature for Java 有效地搜尋和驗證這些代碼，自動化簽章驗證過程以確保資料完整性和合規性。

您將學到什麼

如何為 Java 設定和初始化 GroupDocs.Signature。
在 TAR 檔案中逐步實現條碼和二維碼搜尋。
關鍵配置選項和常見問題的故障排除提示。
現實世界的應用和整合可能性。
大型資料集的效能最佳化技術。

先決條件

在深入學習本教學之前，請確保您的環境已正確設定並具備所有必要的依賴項：

所需庫

GroupDocs.Signature for Java：此程式庫支援搜尋和驗證文件中的簽名。請確保下載 23.12 或更高版本。

環境設定要求

安裝 Java 開發工具包 (JDK)，最好是 JDK 8 或更高版本。

知識前提

對 Java 程式設計有基本的了解。
熟悉 Maven 或 Gradle 的依賴管理。

為 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.Signature，請初始化 Signature 類別如下：

String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_SIGNED_TAR";
final Signature signature = new Signature(filePath);

實施指南

讓我們逐步實現在 TAR 檔案中搜尋條碼和二維碼。

在 TAR 檔案中搜尋條碼

概述

此功能可讓您使用 GroupDocs.Signature 庫識別 TAR 檔案中的條碼簽名，從而深入了解文件的真實性。

步驟 1：初始化條碼搜尋選項

// 從 GroupDocs.Signature 匯入必要的類別
import com.groupdocs.signature.domain.SearchResult;
import com.groupdocs.signature.domain.signatures.BaseSignature;
import com.groupdocs.signature.domain.signatures.DocumentResultSignature;
import com.groupdocs.signature.options.search.BarcodeSearchOptions;
import com.groupdocs.signature.domain.barcodes.BarcodeTypes;

// 設定特定的條碼類型（例如，Code128）
BarcodeSearchOptions bcOptions = new BarcodeSearchOptions(BarcodeTypes.Code128);

參數解釋：這 BarcodeSearchOptions 類別指定要搜尋的條碼類型，增強搜尋的彈性。

第 2 步：執行搜尋

// 執行搜尋並儲存結果
SearchResult searchResult = signature.search(bcOptions);

// 處理並列印結果
int number = 1;
for (BaseSignature o : searchResult.getSucceeded()) {
    DocumentResultSignature document = (DocumentResultSignature) o;
    System.out.println("Document #" + number++ + ": " + document.getFileName() + ". Processed: " + document.getProcessingTime() + ", mls");
    for (BaseSignature temp : document.getSucceeded()) {
        System.out.println("\t\t#" + temp.getSignatureId() + ": " + temp.getSignatureType());
    }
}

// 處理任何搜尋錯誤
if (!searchResult.getFailed().isEmpty()) {
    number = 1;
    for (BaseSignature o : searchResult.getFailed()) {
        DocumentResultSignature document = (DocumentResultSignature) o;
        System.out.println("ERROR in Document #" + number++ + "-" + document.getFileName() + ": " + document.getErrorMessage() + ", mls");
    }
}

關鍵配置選項：透過調整選項自訂條碼搜索，例如 BarcodeTypes。
故障排除提示：確保您的 TAR 檔案未損壞並且包含有效的條碼。

在 TAR 檔案中搜尋二維碼

概述

與條碼類似，此功能允許在 TAR 檔案中有效定位二維碼簽章。

步驟1：初始化二維碼搜尋選項

// 從 GroupDocs.Signature 匯入必要的類別
import com.groupdocs.signature.options.search.QrCodeSearchOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;

// 指定要搜尋的二維碼類型（例如 QR）
QrCodeSearchOptions qrOptions = new QrCodeSearchOptions(QrCodeTypes.QR);

參數解釋：這 QrCodeSearchOptions 類別決定了您要尋找的二維碼類型。

第 2 步：執行搜尋

// 進行搜尋並處理結果
SearchResult searchResult = signature.search(qrOptions);

// 處理並列印結果
int number = 1;
for (BaseSignature o : searchResult.getSucceeded()) {
    DocumentResultSignature document = (DocumentResultSignature) o;
    System.out.println("Document #" + number++ + ": " + document.getFileName() + ". Processed: " + document.getProcessingTime() + ", mls");
    for (BaseSignature temp : document.getSucceeded()) {
        System.out.println("\t\t#" + temp.getSignatureId() + ": " + temp.getSignatureType());
    }
}

// 捕獲搜尋過程中的任何錯誤
if (!searchResult.getFailed().isEmpty()) {
    number = 1;
    for (BaseSignature o : searchResult.getFailed()) {
        DocumentResultSignature document = (DocumentResultSignature) o;
        System.out.println("ERROR in Document #" + number++ + "-" + document.getFileName() + ": " + document.getErrorMessage() + ", mls");
    }
}

關鍵配置選項：透過選擇特定 QrCodeTypes。
故障排除提示：驗證 TAR 檔案的完整性並確保它們包含有效的二維碼。

實際應用

探索現實世界的應用程式可以幫助您了解如何將這些功能整合到各種系統中：

文件驗證：使用條碼/二維碼搜尋來驗證法律或金融領域的文件真實性。
庫存管理：透過掃描產品檔案中的條碼/二維碼實現庫存追蹤自動化。
醫療保健系統：透過驗證儲存在 TAR 檔案中的醫療記錄來確保病患資料的完整性。
供應鏈營運：透過使用條碼/二維碼驗證貨物來提高物流效率。
檔案解決方案：透過定期簽名檢查來維護歷史文件的真實性。

性能考慮

為了獲得最佳性能，請考慮以下提示：

批次處理：批次處理文件以有效管理記憶體使用情況。
平行執行：盡可能利用多執行緒來加快搜尋速度。
資源管理：監控資源利用率並優化 JVM 設定以獲得大型檔案的更好效能。

結論

本教學將幫助您掌握使用 GroupDocs.Signature for Java 在 TAR 檔案中高效搜尋條碼和二維碼的技能。在您的專案中運用這些技術，以確保文件的真實性和合規性，從而提高跨各種應用程式的資料完整性。