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

介紹

管理 PDF 文件中嵌入的條碼資訊可能頗具挑戰性。使用 GroupDocs.Signature for Java，您可以有效率地搜尋和處理文件中的條碼。本教學將引導您完成有效使用 GroupDocs.Signature for Java 所需的步驟。

在本指南中，我們將介紹：

  • 初始化簽名對象
  • 配置條碼搜尋選項
  • 執行搜尋並處理結果

讓我們從先決條件開始。

先決條件

在深入研究之前，請確保您的開發環境已正確設定並具備所有必要的依賴項。

所需的庫和依賴項

要使用 GroupDocs.Signature for Java，您需要：

  • Java 開發工具包 (JDK)：確保安裝了 JDK 8 或更高版本。
  • GroupDocs.Signature 庫：在您的專案中包含該庫的最新版本。

環境設定要求

使用以下方法將 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 版本.

許可證獲取

  • 免費試用：從免費試用開始探索基本功能。
  • 臨時執照：如果您在開發期間需要擴展存取權限，請取得一個。
  • 購買：考慮購買長期使用或高級功能。

知識前提

建議對 Java 有基本的了解並熟悉 Maven/Gradle 建置工具。

為 Java 設定 GroupDocs.Signature

準備好環境後，在專案中設定 GroupDocs.Signature 庫。

  1. 新增依賴項：在您的 pom.xml （Maven）或 build.gradle （Gradle）。

  2. 基本初始化和設定：

    創建新的 Signature 對象，它是您處理文件的入口點。

    import com.groupdocs.signature.Signature;
import java.io.File;

// 使用檔案路徑初始化簽名物件。
Signature signature = new Signature("YOUR_DOCUMENT_DIRECTORY/sample.pdf");

實施指南

初始化簽名對象

這 Signature 該類別是您進行文件處理的入口。它透過指定您要處理的 PDF 的路徑進行初始化。

import com.groupdocs.signature.Signature;
import java.io.File;

// 使用檔案路徑初始化。
Signature signature = new Signature("YOUR_DOCUMENT_DIRECTORY/sample.pdf");

配置條碼搜尋選項

設定針對條碼的搜尋選項。具體操作如下：

建立和配置搜尋選項

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

// 實例化 BarcodeSearchOptions。
BarcodeSearchOptions options = new BarcodeSearchOptions();

// 指定僅在第一頁搜尋。
options.setAllPages(false);
options.setPageNumber(1); // 在第 1 頁搜尋。

// 配置頁面以包含在搜尋中。
PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setFirstPage(true);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(false);

// 將頁面設定應用於選項。
options.setPagesSetup(pagesSetup);

關鍵配置選項

  • 編碼類型：設定為 BarcodeTypes.Code128 適用於 Code 128 條碼。
  • 文字匹配類型： 使用 TextMatchType.Contains 在條碼圖像中搜尋特定文字。
  • 返回內容：啟用內容傳回 options.setReturnContent(true) 用於存取找到的條碼的原始資料。

在文件中搜尋條碼簽名

執行搜尋並處理任何找到的簽名：

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

// 執行條碼搜尋。
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

// 處理每個找到的條碼簽名。
for (BarcodeSignature barcodeSignature : signatures) {
    int pageNumber = barcodeSignature.getPageNumber();
    BarcodeTypes encodeType = barcodeSignature.getEncodeType();
    String text = barcodeSignature.getText();
    byte[] content = barcodeSignature.getContent();
    File format = barcodeSignature.getFormat();

    System.out.println(
        "Barcode signature found at page " + pageNumber + ", type: " + encodeType + ", text: " + text + ", size: " + content.length + ", format: " + format.getName()
    );
}

故障排除提示

  • 確保 PDF 路徑正確。
  • 驗證指定的條碼類型是否與文件中的條碼類型相符。
  • 如果沒有找到條碼，請仔細檢查頁碼並進行設定。

實際應用

GroupDocs.Signature for Java 可以整合到各種系統中以增強功能：

  1. 庫存管理：透過搜尋產品文件上的條碼來實現庫存追蹤的自動化。
  2. 文件驗證：透過合約或法律文件中的條碼檢查來驗證真實性。
  3. 醫療保健系統：透過將患者記錄與掃描的條碼 ID 相鏈接，可以更有效地管理患者記錄。

性能考慮

為了優化性能：

  • 盡可能將搜尋限制在特定頁面以減少處理時間。
  • 使用高效的資料結構來管理大量簽章。
  • 監控記憶體使用情況，尤其是大型文檔，並在使用後適當釋放資源。

結論

透過本指南，您學習如何使用 GroupDocs.Signature for Java 在 PDF 中設定和執行條碼搜尋。這個強大的函式庫為文件管理自動化開闢了無限可能。您可以考慮探索該 API 的更多功能，或將其整合到您現有的系統中。

後續步驟

  • 嘗試不同的條碼類型。
  • 探索 GroupDocs.Signature 中的其他功能，如數位簽章和驗證。

不要忘記在您的專案中嘗試這些實作！

常見問題部分

Q：Java 版 GroupDocs.Signature 是什麼？ 答：它是一個多功能庫，允許在 Java 應用程式內實現無縫文件簽名、條碼搜尋等功能。

Q：如何在特定頁面上搜尋條碼？ 答：配置 PagesSetup 在你的 BarcodeSearchOptions 指定頁碼或範圍。

Q：GroupDocs.Signature 可以處理多種類型的簽章嗎？ 答：是的，它支援各種簽名類型，包括數位、圖像和條碼簽名。

Q：GroupDocs.Signature 可以免費使用嗎？ 答：我們提供免費試用。如需完整存取權限，請考慮購買許可證或取得臨時許可證用於開發用途。

Q：搜尋時沒有找到條碼怎麼辦？ 答：確保您的文件包含指定的條碼類型，並且您的頁面配置與文件中的配置相符。

資源