Java’da GroupDocs.Parser ile PDF’den QR Nasıl Çıkarılır

Modern iş akışlarında, PDF’den QR çıkarma dosyaları manuel veri girişi darboğazını tam otomatik bir boru hattına dönüştürebilir. Gönderi manifestoları, perakende makbuzları veya ürün kataloglarıyla çalışıyor olun, QR bilgilerini hızlı ve güvenilir bir şekilde çekmek, sonraki sistemler için hayati öneme sahiptir. Bu öğretici, GroupDocs.Parser for Java kullanarak PDF’lerden QR kodlarını (ve diğer barkodları) okumanızı ve sonuçları ERP, envanter veya analiz platformunuzun tüketebileceği temiz bir XML dosyasına dışa aktarmanızı adım adım gösterir.

Hızlı cevaplar

  • GroupDocs.Parser for Java ne yapar? PDF dosyalarını okur ve barkodlar, tablolar ve metin gibi yapılandırılmış verileri çıkarır.
  • QR kodları nasıl çıkarılır? BarcodeOptions‘ı QR türüyle yapılandırın ve parser.getBarcodes()‘ı çağırın.
  • Java’da QR kodlarını okuyabilir miyim? Evet—seçeneklerde barkod türünü "QR" olarak ayarlayın.
  • Lisans gerekir mi? Test için bir deneme sürümü çalışır; üretim için ticari bir lisans gereklidir.
  • Hangi Java sürümü gereklidir? Java 8 veya üzeri önerilir.

PDF işleme bağlamında “PDF’den QR çıkarma” nedir?

PDF’den QR çıkarma, her sayfayı QR kodlu grafikler için taramak, gömülü veriyi çözmek ve bunu program dostu bir formatta döndürmek anlamına gelir. GroupDocs.Parser, düşük seviyeli görüntü analizini soyutlayarak piksel manipülasyonu yerine iş mantığına odaklanmanızı sağlar.

QR çıkarımı için neden GroupDocs.Parser kullanılmalı?

GroupDocs.Parser 30’dan fazla giriş formatını destekler ve 500 MB‘a kadar PDF’leri tüm dosyayı belleğe yüklemeden işleyebilir, düşük çözünürlüklü taramalarda bile yüksek doğruluk sonuçları sunar. Hız için QualityMode.Low, maksimum hassasiyet için QualityMode.High seçebilirsiniz ve aynı API PDF’ler, görüntüler ve Office belgeleri için çalışır, birden fazla kütüphane ihtiyacını ortadan kaldırır.

Önkoşullar

  • GroupDocs.Parser for Java (sürüm 25.5 veya sonrası).
  • Maven veya manuel JAR indirme.
  • Java 8+ geliştirme ortamı (IntelliJ IDEA, Eclipse veya herhangi bir editör).

GroupDocs.Parser for Java Kurulumu

Maven Kullanarak

pom.xml dosyanıza GroupDocs deposunu ve bağımlılığı ekleyin:

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

Doğrudan indirme

Alternatif olarak, en son JAR’ı GroupDocs.Parser for Java sürümleri adresinden indirin.

Lisans edinme adımları

  • Ücretsiz deneme: Tam özellik setiyle 30‑günlük deneme.
  • Geçici lisans: Uzatılmış değerlendirme için geçici bir anahtar isteyin.
  • Satın al: Üretim dağıtımları için ticari bir lisans edinin.

Temel başlatma ve kurulum

Analiz etmek istediğiniz PDF’ye işaret eden bir Parser örneği oluşturun:

Parser, GroupDocs.Parser içinde bir belgeyi temsil eden ve metin, tablo ve barkod gibi içerikleri çıkarmak için yöntemler sağlayan temel sınıftır.

import com.groupdocs.parser.Parser;

class BarcodeExtractor {
    public static void main(String[] args) {
        // Initialize Parser object with the path to your PDF document.
        try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY")) {
            // Additional setup and usage will follow in the next sections.
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

GroupDocs.Parser ile Java PDF’lerinde QR kodlarını nasıl okuyabilirsiniz

GroupDocs.Parser ile Java PDF’lerinde QR kodlarını okumak, bir parser örneği oluşturmayı, QR türlerini hedeflemek için barkod seçeneklerini yapılandırmayı, barkod çıkarma yöntemini çağırmayı ve ardından dönen barkod nesnelerini işlemeyi içerir. İşlem basittir, herhangi bir PDF sayfasında çalışır ve çözülen değerleri, sonraki işleme yönelik konumsal meta verilerle birlikte döndürür.

Adım 1: barkod desteğini doğrula

Çıkarma işlemine başlamadan önce, belge formatının barkod taramayı desteklediğini doğrulayın:

if (!parser.getFeatures().isBarcodes()) {
    System.out.println("Document does not support barcode extraction.");
    return; // Exit if the document does not support barcode extraction
}

Açıklama: Bu koruma, desteklenmeyen dosya türlerinde çalışma zamanı hatalarını önler.

Adım 2: barkod seçeneklerini yapılandır (Java’da QR kodlarını oku)

BarcodeOptions, hangi barkod sembollerinin algılanacağını belirlemenizi, tarama kalite modunu ayarlamanızı ve tespit eşik değerleri gibi parametreleri ince ayar yapmanızı sağlayan bir yapılandırma nesnesidir; bu, hedef QR kodları için optimum performans sağlar.

import com.groupdocs.parser.options.BarcodeOptions;
import com.groupdocs.parser.options.QualityMode;

BarcodeOptions options = new BarcodeOptions(QualityMode.Low, QualityMode.Low, "QR");

Açıklama: QualityMode.Low işleme hızını artırır; ekstra doğruluk gerekiyorsa High‘a geçin. "QR" argümanı, motorun yalnızca QR‑tipi barkodları aramasını söyler.

Adım 3: QR verisini çıkar

parser.getBarcodes(options), verilen BarcodeOptions ile belgeyi tarar ve her biri çözülen QR değerini, sayfa numarasını ve barkodun sayfa içindeki tam koordinatlarını kapsayan PageBarcodeArea nesnelerinin bir koleksiyonunu döndürür; bu, kesin sonraki işlemeyi mümkün kılar.

import com.groupdocs.parser.data.PageBarcodeArea;
import java.util.List;

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

Açıklama: parser.getBarcodes, her biri çözülen QR değerini ve sayfadaki konumunu içeren PageBarcodeArea nesnelerinin yinelemeli bir koleksiyonunu döndürür.

Çıkarılan veriyi XML’e Dışa Aktarma

Adım 4: XML dışa aktarıcısını başlat

XmlExporter, barkod nesnelerinin bir koleksiyonunu iyi yapılandırılmış bir XML belgesine dönüştüren bir yardımcı sınıftır; her barkod için sayfa indeksi, konum ve çözülen değer gibi özniteliklerle öğeler otomatik olarak oluşturur ve ardından diğer sistemlere kaydedilebilir veya akışa gönderilebilir.

import com.groupdocs.parser.export.XmlExporter;

XmlExporter exporter = new XmlExporter();

Açıklama: XmlExporter, barkod nesnelerinin standart XML’e serileştirilmesini yönetir ve ERP veya envanter sistemleriyle entegrasyona hazır hale getirir.

Adım 5: XML dosyasını yaz

Çıkarılan QR bilgilerini diske kaydedin:

exporter.exportBarcodes(barcodes, "YOUR_OUTPUT_DIRECTORY/data.xml");

Açıklama: Oluşan data.xml, her QR kodu için bir <Barcode> öğesi içerir; öğeler sayfa numarası, koordinatlar ve çözülen değer özniteliklerine sahiptir.

Pratik uygulamalar

  1. Envanter yönetimi: Gelen gönderi PDF’lerindeki QR etiketlerini okuyarak stok veritabanlarını otomatik doldurun.
  2. Tedarik zinciri görünürlüğü: Lojistik belgelerde gömülü QR tanımlayıcıları çıkararak paketleri gerçek zamanlı izleyin.
  3. Perakende makbuzları: Dijital makbuzlarda basılmış QR kodlarından promosyon veya garanti bilgilerini çekin.

Performans değerlendirmeleri

  • Bellek yönetimi: Çok büyük PDF’lerde, tüm dosyayı belleğe yüklemek yerine sayfaları akış biçiminde işleyin.
  • QualityMode seçimi: Toplu işleme için Low, düşük çözünürlüklü taramalarla çalışırken High‘a geçin.
  • Kütüphane güncellemeleri: En son performans iyileştirmelerinden ve hata düzeltmelerinden yararlanmak için GroupDocs.Parser’ı güncel tutun.

Yaygın sorunlar ve sorun giderme

SorunMuhtemel nedenÇözüm
Barkod bulunamadıYanlış barkod türü belirtildi"QR"‘yi uygun türle (ör. "CODE_128") değiştirin.
Büyük PDF’lerde bellek yetersizliği hatasıTüm belge bir kerede yüklendiSayfaları tek tek işleyin veya JVM yığın boyutunu artırın (-Xmx2g).
Boş XML dosyasıexportBarcodes çıkarma işleminden önce çağrıldıDışa aktarmadan önce parser.getBarcodes(options)‘ın veri döndürdüğünden emin olun.

Sıkça Sorulan Sorular

Q: GroupDocs.Parser ile görüntü dosyalarından barkod çıkarabilir miyim?
A: Evet, kütüphane yaygın görüntü formatlarından (PNG, JPEG, TIFF) barkod çıkarımını destekler.

Q: Hangi barkod formatları tanınır?
A: QR, Code 39, Code 128, DataMatrix, PDF417 ve daha birçokları. Tam liste için API belgelerine bakın.

Q: Şifre korumalı PDF’leri nasıl ele almalı?
A: Şifreyi Parser yapıcısına geçirin: new Parser(filePath, "password").

Q: Deneme sürümü üretim testi için yeterli mi?
A: Deneme sürümü tam işlevsellik sağlar ancak çıkarılan verilere bir filigran ekler. Üretim için ticari bir lisans edinin.

Q: PDF’im hem QR hem de doğrusal barkodlar içeriyorsa ne yapmalıyım?
A: Birden fazla BarcodeOptions örneği oluşturun veya tüm gerekli formatları tek geçişte taramak için bir dizi tür geçirin.


Son Güncelleme: 2026-10-12
Test Edilen Versiyon: GroupDocs.Parser 25.5
Yazar: GroupDocs

Kaynaklar

İlgili Eğitimler