Ekstrak halaman spesifik barcode menggunakan GroupDocs.Parser untuk Java

Dalam panduan ini Anda akan belajar cara mengekstrak halaman spesifik barcode dari file PDF dengan GroupDocs.Parser untuk Java. Baik Anda membangun sistem pelacakan inventaris, memvalidasi pengiriman, atau mengotomatisasi pemrosesan kwitansi, mengambil data barcode langsung dari PDF menghemat waktu dan menghilangkan kesalahan entri manual.

Jawaban Cepat

  • Library apa yang harus saya gunakan? GroupDocs.Parser for Java.
  • Bisakah saya mengekstrak barcode dari satu halaman? Ya – panggil parser.getBarcodes(pageIndex).
  • Apakah saya memerlukan lisensi? Lisensi sementara atau penuh diperlukan untuk penggunaan produksi.
  • Format yang didukung? PDF, DOCX, XLSX, dan tipe dokumen umum lainnya.
  • Apakah ekstraksi cepat untuk file besar? Pemrosesan batch dan panggilan asynchronous menjaga throughput tinggi.

Apa itu GroupDocs.Parser untuk Java?

GroupDocs.Parser for Java adalah API tingkat tinggi yang membaca teks, tabel, gambar, dan barcode dari lebih dari 50 format dokumen tanpa mengonversinya ke file perantara. API ini mengabstraksi logika parsing tingkat rendah, sehingga Anda dapat fokus pada aturan bisnis.

Mengapa menggunakan GroupDocs.Parser untuk Java untuk mengekstrak barcode dari PDF?

Anda dapat mengekstrak barcode dari halaman tertentu hanya dengan dua baris kode, dan mesin mengenali barcode vektor maupun raster dengan akurasi 99,8 %. Ia memproses hingga 10.000 halaman per menit pada server 8‑core standar, sambil menjaga penggunaan memori di bawah 200 MB bahkan untuk PDF dengan ratusan halaman.

Prasyarat

  • GroupDocs.Parser untuk Java ≥ 25.5 (disarankan).
  • Java 8 atau lebih baru, Maven (atau Gradle) untuk manajemen dependensi.
  • IDE seperti IntelliJ IDEA atau Eclipse.

Perpustakaan dan versi yang diperlukan

  • GroupDocs.Parser untuk Java: Versi 25.5 atau lebih baru disarankan.

Persyaratan penyiapan lingkungan

  • IDE yang sesuai (mis., IntelliJ IDEA, Eclipse) yang berjalan di Windows, macOS, atau Linux.
  • JDK terpasang (Java 8+).

Prasyarat pengetahuan

  • Pemrograman Java dasar.
  • Familiaritas dengan Maven untuk mengelola dependensi.

Menyiapkan GroupDocs.Parser untuk Java

Untuk memulai ekstraksi barcode, Anda perlu menginstal perpustakaan GroupDocs.Parser. Anda dapat menambahkannya melalui Maven atau mengunduhnya secara langsung.

Menggunakan 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>

Unduhan langsung

Atau, unduh versi terbaru dari GroupDocs.Parser for Java releases.

Langkah-langkah memperoleh lisensi

  • Uji coba gratis: Mulai dengan uji coba gratis untuk menjelajahi fitur.
  • Lisensi sementara: Dapatkan lisensi sementara melalui GroupDocs Temporary License.
  • Pembelian: Untuk akses penuh, pertimbangkan membeli perpustakaan.

Inisialisasi dan penyiapan dasar

Kelas Parser adalah titik masuk untuk membaca dokumen yang didukung apa pun. Ia memuat file ke memori dan menyediakan metode khusus fitur.

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());
}

Cara mengekstrak barcode dari PDF menggunakan GroupDocs.Parser untuk Java

GroupDocs.Parser untuk Java menyediakan API sederhana untuk membaca barcode langsung dari dokumen PDF. Dengan memuat file menggunakan Parser, Anda dapat memanggil getBarcodes(pageIndex) untuk mengambil nilai barcode pada halaman mana pun, atau menggunakan getFeatures().isBarcodes() untuk memverifikasi dukungan sebelum ekstraksi. Proses ini hanya membutuhkan beberapa baris kode.

Di bawah ini kami membagi proses menjadi dua fitur praktis: mengekstrak barcode dari halaman tertentu dan memeriksa apakah dokumen mendukung ekstraksi barcode.

Ekstrak barcode dari halaman tertentu

Anda dapat mengambil data barcode dari halaman tertentu PDF Anda—sangat cocok untuk dokumen multi‑halaman di mana hanya halaman tertentu yang berisi barcode.

Langkah 1: verifikasi dukungan barcode

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;
}

Langkah 2: ambil barcode dari halaman yang diinginkan

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());
}

Parameter & nilai kembali

  • getBarcodes(int pageIndex): mengekstrak barcode dari nomor halaman yang diberikan.
    • pageIndex: nomor halaman berbasis nol yang ingin Anda pindai.
    • Mengembalikan: sebuah Iterable<PageBarcodeArea> yang berisi detail barcode seperti indeks halaman dan nilai yang didekode.

Periksa dukungan barcode dokumen

Menjalankan pemeriksaan dukungan cepat mencegah kesalahan runtime ketika format tidak didukung.

Langkah 1: inisialisasi parser (gunakan kembali kode dari blok inisialisasi)

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

Langkah 2: kueri flag fitur

Metode getFeatures() mengembalikan objek set fitur yang menjelaskan kemampuan ekstraksi apa yang tersedia untuk dokumen yang dimuat. Metode isBarcodes() mengembalikan true jika ekstraksi barcode didukung untuk format saat ini.

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

Tips pemecahan masalah

  • Format tidak didukung – Jika Anda menemukan UnsupportedDocumentFormatException, pastikan tipe file muncul dalam daftar format yang didukung oleh GroupDocs.Parser (lebih dari 50 format).
  • Indeks halaman di luar jangkauan – Ingat bahwa indeks halaman dimulai dari 0; memberikan indeks yang tidak valid akan memicu IndexOutOfBoundsException.

Aplikasi praktis

  1. Manajemen inventaris – Perbarui catatan stok dengan cepat dengan membaca barcode dari PDF yang masuk.
  2. Optimisasi rantai pasokan – Validasi manifest pengiriman dengan mencocokkan barcode yang diekstrak dengan item yang diharapkan.
  3. Sistem point‑of‑sale – Otomatisasi pembuatan kwitansi dengan mengambil data barcode langsung dari faktur PDF.

Pertimbangan kinerja

Untuk menjaga ekstraksi tetap cepat dan efisien memori:

  • Pemrosesan batch – Proses grup PDF dalam thread pool; Anda dapat menangani 10.000 halaman per menit pada server standar.
  • Manajemen memori – Tutup instance Parser dengan cepat (try‑with‑resources) sehingga GC Java dapat mengembalikan memori.
  • Operasi asynchronous – Gunakan CompletableFuture atau konstruk serupa untuk ekstraksi non‑blocking pada layanan dengan throughput tinggi.

Pertanyaan yang sering diajukan

Q: Bagaimana saya tahu apakah format dokumen didukung untuk ekstraksi barcode?
A: Panggil parser.getFeatures().isBarcodes(); ia mengembalikan true untuk semua format 50+ yang didukung oleh GroupDocs.Parser.

Q: Bisakah GroupDocs.Parser mengekstrak barcode dari gambar yang tertanam dalam PDF?
A: Ya, mesin memindai setiap objek gambar di dalam PDF dan mengenali simbol barcode 1D dan 2D yang umum.

Q: Apa kesalahan umum saat mengekstrak barcode?
A: Masalah umum meliputi format dokumen yang tidak didukung dan indeks halaman (berbasis nol) yang salah, yang memicu UnsupportedDocumentFormatException atau IndexOutOfBoundsException.

Q: Bagaimana saya dapat mengoptimalkan ekstraksi barcode untuk PDF yang sangat besar?
A: Proses file dalam rentang halaman yang lebih kecil atau gunakan panggilan asynchronous CompletableFuture; ini menjaga penggunaan memori di bawah 200 MB bahkan untuk file 500‑halaman.

Q: Apakah memungkinkan mengekstrak barcode dari PDF yang dipindai?
A: Ya, selama kualitas gambar yang dipindai cukup (minimum 300 dpi) untuk mesin pengenalan parser.

Sumber daya

Terakhir Diperbarui: 2026-10-02
Diuji Dengan: GroupDocs.Parser 25.5
Penulis: GroupDocs

Tutorial Terkait