GroupDocs.Parser for Java를 사용하여 바코드 특정 페이지 추출

이 가이드에서는 GroupDocs.Parser for Java를 사용하여 PDF 파일에서 바코드 특정 페이지를 추출하는 방법을 배웁니다. 재고 추적 시스템을 구축하든, 선적을 검증하든, 영수증 처리를 자동화하든, PDF에서 직접 바코드 데이터를 추출하면 시간 절약과 수동 입력 오류를 방지할 수 있습니다.

빠른 답변

  • 어떤 라이브러리를 사용해야 하나요? GroupDocs.Parser for Java.
  • 단일 페이지에서 바코드를 추출할 수 있나요? Yes – call parser.getBarcodes(pageIndex).
  • 라이선스가 필요합니까? 프로덕션 사용을 위해 임시 또는 정식 라이선스가 필요합니다.
  • 지원되는 형식은? PDF, DOCX, XLSX 및 기타 일반 문서 유형.
  • 대용량 파일에서도 추출이 빠른가요? 배치 처리와 비동기 호출로 처리량을 높게 유지합니다.

GroupDocs.Parser for Java란?

GroupDocs.Parser for Java는 50개 이상의 문서 형식에서 텍스트, 표, 이미지 및 바코드를 중간 파일로 변환하지 않고 읽어들이는 고수준 API입니다. 저수준 파싱 로직을 추상화하여 비즈니스 규칙에 집중할 수 있습니다.

PDF에서 바코드를 추출하기 위해 GroupDocs.Parser for Java를 사용하는 이유

두 줄의 코드만으로 특정 페이지에서 바코드를 추출할 수 있으며, 엔진은 벡터와 래스터 바코드를 99.8 % 정확도로 인식합니다. 일반적인 8코어 서버에서 분당 최대 10,000 페이지를 처리하면서도 수백 페이지 PDF에서도 메모리 사용량을 200 MB 이하로 유지합니다.

사전 요구 사항

  • GroupDocs.Parser for Java ≥ 25.5 (권장).
  • Java 8 이상, Maven(또는 Gradle)으로 의존성 관리.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE.

필요 라이브러리 및 버전

  • GroupDocs.Parser for Java: 버전 25.5 이상을 권장합니다.

환경 설정 요구 사항

  • Windows, macOS 또는 Linux에서 실행되는 적절한 IDE(예: IntelliJ IDEA, Eclipse).
  • JDK 설치(Java 8 이상).

지식 사전 요구 사항

  • 기본 Java 프로그래밍.
  • 의존성 관리를 위한 Maven에 대한 친숙함.

GroupDocs.Parser for Java 설정

바코드 추출을 시작하려면 GroupDocs.Parser 라이브러리를 설치해야 합니다. Maven을 통해 추가하거나 직접 다운로드할 수 있습니다.

Maven 사용

Add the following configuration to your 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에서 다운로드하십시오.

라이선스 획득 단계

  • 무료 체험: 기능을 살펴보려면 무료 체험을 시작하십시오.
  • 임시 라이선스: GroupDocs Temporary License를 통해 임시 라이선스를 얻으십시오.
  • 구매: 전체 액세스를 위해 라이브러리 구매를 고려하십시오.

기본 초기화 및 설정

Parser 클래스는 지원되는 모든 문서를 읽기 위한 진입점입니다. 파일을 메모리로 로드하고 기능별 메서드를 제공합니다.

Initialize the Parser with the path to your PDF:

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에서 바코드 추출 방법

GroupDocs.Parser for Java는 PDF 문서에서 바코드를 직접 읽을 수 있는 간단한 API를 제공합니다. Parser로 파일을 로드한 후 getBarcodes(pageIndex)를 호출하여 모든 페이지에서 바코드 값을 가져오거나, getFeatures().isBarcodes()를 사용해 추출 전에 지원 여부를 확인할 수 있습니다. 이 과정은 몇 줄의 코드만 필요합니다.

아래에서는 두 가지 실용적인 기능으로 과정을 나눕니다: 특정 페이지에서 바코드 추출 및 문서가 바코드 추출을 지원하는지 확인.

특정 페이지에서 바코드 추출

PDF의 특정 페이지에서 바코드 데이터를 가져올 수 있습니다—바코드가 포함된 특정 페이지만 있는 다중 페이지 문서에 적합합니다.

단계 1: 바코드 지원 확인

Before you attempt extraction, confirm that the document format can be processed for barcodes:

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

단계 2: 원하는 페이지에서 바코드 가져오기

The getBarcodes(int pageIndex) method scans a single page (zero‑based index) and returns all detected barcodes. The example extracts barcodes from the second page (index 1):

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

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

매개변수 및 반환값

  • getBarcodes(int pageIndex): 제공된 페이지 번호에서 바코드를 추출합니다.
    • pageIndex: 스캔하려는 0부터 시작하는 페이지 번호.
    • 반환: 페이지 인덱스와 디코딩된 값 등 바코드 세부 정보를 포함하는 Iterable<PageBarcodeArea>.

문서 바코드 지원 확인

빠른 지원 확인을 실행하면 형식이 지원되지 않을 때 런타임 오류를 방지할 수 있습니다.

단계 1: 파서 초기화 (초기화 블록의 코드를 재사용)

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

단계 2: 기능 플래그 조회

getFeatures() 메서드는 로드된 문서에 대해 사용할 수 있는 추출 기능을 설명하는 기능 집합 객체를 반환합니다. isBarcodes() 메서드는 현재 형식에 대해 바코드 추출이 지원되는 경우 true를 반환합니다.

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

문제 해결 팁

  • 지원되지 않는 형식 – UnsupportedDocumentFormatException이 발생하면 파일 유형이 GroupDocs.Parser 지원 형식 목록(50개 이상)에 포함되는지 확인하십시오.
  • 페이지 인덱스 범위 초과 – 페이지 인덱스는 0부터 시작한다는 점을 기억하십시오; 잘못된 인덱스를 전달하면 IndexOutOfBoundsException이 발생합니다.

실용적인 적용 사례

바코드 추출은 다음과 같은 다양한 적용 사례가 있습니다:

  1. 재고 관리 – 들어오는 PDF에서 바코드를 읽어 재고 기록을 신속하게 업데이트합니다.
  2. 공급망 최적화 – 추출된 바코드를 예상 항목과 일치시켜 선적 명세서를 검증합니다.
  3. POS 시스템 – PDF 청구서에서 바코드 데이터를 직접 가져와 영수증 생성을 자동화합니다.

성능 고려 사항

추출을 빠르고 메모리 효율적으로 유지하려면:

  • 배치 처리 – 스레드 풀에서 PDF 그룹을 처리합니다; 표준 서버에서 분당 10,000 페이지를 처리할 수 있습니다.
  • 메모리 관리 – Parser 인스턴스를 즉시 닫고(try‑with‑resources) Java GC가 메모리를 회수하도록 합니다.
  • 비동기 작업 – CompletableFuture 등 유사한 구조를 사용해 고처리량 서비스에서 논블로킹 추출을 수행합니다.

자주 묻는 질문

Q: 문서 형식이 바코드 추출을 지원하는지 어떻게 알 수 있나요?
A: parser.getFeatures().isBarcodes()를 호출하십시오; GroupDocs.Parser가 처리하는 50개 이상의 형식 모두에 대해 true를 반환합니다.

Q: GroupDocs.Parser가 PDF에 삽입된 이미지에서 바코드를 추출할 수 있나요?
A: 네, 엔진은 PDF 내부의 모든 이미지 객체를 스캔하고 일반적인 1D 및 2D 바코드 심볼을 인식합니다.

Q: 바코드 추출 시 흔히 발생하는 오류는 무엇인가요?
A: 일반적인 문제는 지원되지 않는 문서 형식과 잘못된(0 기반) 페이지 인덱스로, UnsupportedDocumentFormatException 또는 IndexOutOfBoundsException을 발생시킵니다.

Q: 매우 큰 PDF에서 바코드 추출을 최적화하려면 어떻게 해야 하나요?
A: 파일을 작은 페이지 범위로 나누어 처리하거나 비동기 CompletableFuture 호출을 사용하십시오; 이렇게 하면 500페이지 파일에서도 메모리 사용량을 200 MB 이하로 유지할 수 있습니다.

Q: 스캔된 PDF에서 바코드를 추출할 수 있나요?
A: 네, 스캔 이미지 품질이 파서 인식 엔진에 충분히 (최소 300 dpi) 좋다면 가능합니다.

리소스

마지막 업데이트: 2026-10-02
테스트 환경: GroupDocs.Parser 25.5
작성자: GroupDocs

관련 튜토리얼