Now produce final answer.# 如何使用 GroupDocs.Parser for Java 從 PDF 中提取條碼

在本教學中,您將了解 如何提取條碼,使用 GroupDocs.Parser for Java 從 PDF 檔案中提取。無論您是建立庫存追蹤系統、驗證出貨,或自動化收據處理,直接從 PDF 中提取條碼資料都能節省時間並消除手動輸入錯誤。

介紹

groupdocs parser java 讓您輕鬆直接從 PDF 檔案中提取條碼資料,協助您自動化庫存檢查、出貨驗證等。以下我們將逐步說明您所需的一切——從環境設定到在特定頁面提取條碼——讓您在自己的 Java 應用程式中掌握 如何提取條碼

快速答覆

  • 我應該使用哪個函式庫? GroupDocs.Parser for Java.
  • 我可以從單一頁面提取條碼嗎? 可以 – 使用 parser.getBarcodes(pageIndex)
  • 我需要授權嗎? 在正式環境中需要臨時或完整授權。
  • 支援的格式? PDF、DOCX、XLSX 以及其他常見文件類型。
  • 條碼提取在大型檔案中快速嗎? 批次處理與非同步呼叫可提升效能。

GroupDocs.Parser for Java 是什麼?

GroupDocs.Parser for Java 是一個高階 API,能從各種文件格式中讀取文字、表格、影像與條碼,且無需轉換為中間檔案。它抽象化低階解析邏輯,讓您專注於業務規則。

為何使用 GroupDocs.Parser for Java 從 PDF 提取條碼?

  • Accuracy – 內建條碼辨識支援向量與點陣圖影像。
  • Speed – 僅提取所需頁面,避免全文件掃描。
  • Scalability – 處理大型批次時佔用記憶體極少。
  • Cross‑platform – 可在 Windows、macOS 與 Linux 上執行,支援任何 Java 8+ 執行環境。

前置條件

  • GroupDocs.Parser for Java ≥ 25.5(建議)。
  • Java 8 或更新版本,使用 Maven(或 Gradle)管理相依性。
  • IDE 如 IntelliJ IDEA 或 Eclipse。

必要的函式庫與版本

  • GroupDocs.Parser for Java:建議使用 25.5 版或更新版本。

環境設定需求

  • 適用的 IDE(例如 IntelliJ IDEA、Eclipse),可在 Windows、macOS 或 Linux 上執行。
  • 已安裝 JDK(Java 8+)。

知識前置條件

  • 基本的 Java 程式設計知識。
  • 熟悉使用 Maven 管理相依性。

設定 GroupDocs.Parser for Java

要開始條碼提取,您需要安裝 GroupDocs.Parser 函式庫。您可以透過 Maven 加入或直接下載。

使用 Maven

將以下設定加入您的 pom.xml

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/parser/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-parser</artifactId>
        <version>25.5</version>
    </dependency>
</dependencies>

直接下載

或者,從 GroupDocs.Parser for Java releases 下載最新版本。

取得授權步驟

  • Free Trial:先使用免費試用版以探索功能。
  • Temporary License:透過 GroupDocs Temporary License 取得臨時授權。
  • Purchase:若需完整功能,請考慮購買此函式庫。

基本初始化與設定

要開始從文件提取條碼,先以文件路徑初始化 Parser 類別。以下是設定方式:

import com.groupdocs.parser.Parser;

String filePath = "YOUR_DOCUMENT_DIRECTORY/SamplePdfWithBarcodes.pdf";

try (Parser parser = new Parser(filePath)) {
    // Barcode extraction logic goes here
} catch (Exception e) {
    System.err.println("Error initializing parser: " + e.getMessage());
}

如何使用 GroupDocs.Parser for Java 從 PDF 提取條碼

以下我們將流程分為兩個實用功能:從特定頁面提取條碼,以及檢查文件是否支援條碼提取。

從特定頁面提取條碼

此功能可讓您從 PDF 的特定頁面提取條碼資料——適用於多頁文件中僅有部分頁面含有條碼的情況。

步驟 1:驗證條碼支援

在嘗試提取之前,先確認文件格式支援條碼處理:

if (!parser.getFeatures().isBarcodes()) {
    System.out.println("Document doesn't support barcodes extraction.");
    return;
}

步驟 2:從目標頁面提取條碼

使用 getBarcodes(int pageIndex) 方法掃描特定頁面(零基索引)。以下範例從第二頁(索引 1)提取條碼:

Iterable<PageBarcodeArea> barcodes = parser.getBarcodes(1);

for (PageBarcodeArea barcode : barcodes) {
    System.out.println("Page: " + barcode.getPage().getIndex());
    System.out.println("Value: " + barcode.getValue());
}

Parameters & Return Values

  • getBarcodes(int pageIndex): 從指定的頁碼提取條碼。
    • pageIndex:您要掃描的零基頁碼。
    • 回傳:一個 Iterable<PageBarcodeArea>,包含條碼細節,如頁碼與解碼值。

檢查文件條碼支援

快速檢查支援情況可避免在不支援的格式上發生執行時錯誤。

步驟 1:初始化 Parser(使用先前初始化程式碼)

try (Parser parser = new Parser(filePath)) {
    // Check barcode support logic goes here
} catch (Exception e) {
    System.err.println("Error initializing parser: " + e.getMessage());
}

步驟 2:查詢功能旗標

以下程式碼段會告訴您是否可以進行條碼提取:

boolean supportsBarcodes = parser.getFeatures().isBarcodes();
System.out.println("Document supports barcodes: " + supportsBarcodes);

疑難排解技巧

  • Unsupported Format – 若遇到 UnsupportedDocumentFormatException,請確認檔案類型是否列於 GroupDocs.Parser 支援的格式清單中。
  • Page Index Out of Range – 請記得頁碼索引從 0 開始;傳入無效索引會拋出 IndexOutOfBoundsException

實務應用

條碼提取有多種應用,包括:

  1. Inventory Management – 透過從收到的 PDF 讀取條碼,快速更新庫存記錄。
  2. Supply Chain Optimization – 透過比對提取的條碼與預期項目,驗證出貨清單。
  3. Point‑of‑Sale Systems – 從 PDF 發票直接提取條碼資料,自動生成收據。

效能考量

為了保持提取速度快且記憶體效能佳:

  • Batch Processing – 在單一執行緒池中處理 PDF 群組,以降低開銷。
  • Memory Management – 立即關閉 Parser 實例(使用 try‑with‑resources),讓 Java GC 回收記憶體。
  • Asynchronous Operations – 使用 CompletableFuture 或類似機制,在高吞吐服務中進行非阻塞提取。

常見問題

Q: 如何判斷文件格式是否支援條碼提取?
A: 使用 parser.getFeatures().isBarcodes() 在嘗試提取前檢查支援情況。

Q: GroupDocs.Parser 能從 PDF 中嵌入的影像提取條碼嗎?
A: 可以,它能處理 PDF 文件中各種影像格式。

Q: 提取條碼時常見的錯誤是什麼?
A: 常見問題包括不支援的文件格式以及錯誤的(零基)頁碼索引。

Q: 如何優化對非常大型 PDF 的條碼提取?
A: 將檔案分成較小的區塊處理,或使用非同步方法提升吞吐量。

Q: 能從掃描的 PDF 提取條碼嗎?
A: 可以,只要條碼足夠清晰,解析引擎即可辨識。

資源


最後更新: 2026-02-16
測試環境: GroupDocs.Parser 25.5
作者: GroupDocs