GroupDocs.Parser ile Java’da QR kodunu verimli bir şekilde okuma

Modern kurumsal uygulamalarda, read QR code java faturalar, gönderi manifestoları ve envanter sayfalarından veri yakalamayı otomatikleştirmek için yaygın bir gereksinimdir. GroupDocs.Parser’ı kullanarak, düşük seviyeli görüntü işleme kodu yazmadan QR‑kod verilerini doğrudan PDF’lerden, Word dosyalarından, elektronik tablolardan veya düz görüntü formatlarından çıkarabilirsiniz. Bu öğretici, kurulum, şablon oluşturma, ayrıştırma ve en iyi uygulama ipuçlarıyla sizi yönlendirerek barkod çıkarımını herhangi bir Java projesine güvenle entegre etmenizi sağlar.

Hızlı cevaplar

  • Hangi kütüphane Java’da QR kodunu okumamı sağlar? GroupDocs.Parser for Java.
  • Bir lisansa ihtiyacım var mı? Ücretsiz deneme değerlendirme için çalışır; üretim için tam lisans gereklidir.
  • Hangi belge türleri destekleniyor? PDF’ler, DOCX, XLSX, PNG, JPEG, TIFF ve daha fazlası.
  • Birden fazla barkodu aynı anda çıkarabilir miyim? Evet – ayrıştırıcı belge başına birçok barkodu algılayıp döndürebilir.
  • Hangi Java sürümü gerekiyor? Java 8 veya üzeri.

read qr code java nedir?

QR kodunu Java’da okuma, PDF’lerde, görüntülerde veya ofis belgelerinde gömülü QR barkodlarını bulmak ve çözmek için GroupDocs.Parser Java kütüphanesinin kullanılmasını ifade eder. Kütüphane düşük seviyeli görüntü işleme detaylarını soyutlayarak, kodlanmış metni almak için birkaç yöntem çağırmanıza olanak tanır. Bu yaklaşım manuel taramayı ortadan kaldırır ve otomatik iş akışlarında veri girişi hatalarını azaltır.

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

GroupDocs.Parser, QR, Data Matrix ve Code‑128 dahil olmak üzere 30’dan fazla barkod formatı için yüksek doğruluklu tanıma sağlar ve 30’dan fazla giriş ve çıkış belge türünü destekler. Şablon‑tabanlı motoru, tam barkod konumlarını belirlemenizi sağlar ve yanlış pozitif oranlarını %95’e kadar düşürür. API tamamen iş parçacığı‑güvenli olup, standart sunucu donanımında saatte binlerce dosya toplu işleme imkanı tanır; bu da büyük ölçekli PDF’den QR kodu ayrıştırma senaryoları için idealdir.

Önkoşullar

  • Java Development Kit 8 veya daha yeni bir sürüm, çalışma istasyonunuzda veya derleme sunucunuzda yüklü.
  • Maven, bağımlılık yönetimi için (veya tercih ederseniz Gradle).
  • GroupDocs.Parser for Java sürüm 25.5 veya üzeri (Maven Central üzerinden temin edilebilir).
  • Java proje yapısı ve IDE kurulumu hakkında temel bilgi.

GroupDocs.Parser’ı Java için nasıl kurulur

GroupDocs.Parser’ı kurmak için Maven koordinatlarını projenizin pom.xml dosyasına ekleyin. Dosyayı kaydettikten sonra Maven, kütüphaneyi ve bağımlılıklarını otomatik olarak indirecektir. {{VERSION}} ifadesini mevcut sürüm numarasıyla değiştirdiğinizden emin olun, ardından IDE’nizde veya komut satırında bir Maven yenilemesi çalıştırarak kurulumu doğrulayın.

Kütüphaneyi Maven pom.xml dosyanıza ekleyin ve projeyi yenileyin.
({{VERSION}} ifadesini en son sürüm numarasıyla değiştirin.)

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-parser</artifactId>
    <version>{{VERSION}}</version>
</dependency>

Manuel indirmeyi tercih ederseniz, JAR dosyasını resmi sürüm sayfasından edinin.

Doğrudan indirme

En son JAR dosyasını ayrıca GroupDocs.Parser for Java releases adresinden indirebilirsiniz.

Lisans edinimi

  • Free trial – tüm özellikleri keşfetmek için bir deneme ile başlayın.
  • Temporary license – uzun vadeli test için kısa süreli bir anahtar isteyin.
  • Full license – sınırsız üretim kullanımı için bir abonelik satın alın.

Bir barkod şablonu nasıl tanımlanır ve ayrıştırılır

Bir barkod şablonu oluşturmak, çıkarmak istediğiniz her barkodu tanımlamayı içerir. Şablon, ayrıştırıcıya tam bölgeyi, beklenen formatı ve ölçekleme kurallarını bildirir; bu da farklı belge düzenlerinde güvenilir algılamayı sağlar. Tanımlandıktan sonra, ayrıştırıcı her barkodu manuel görüntü analizine gerek kalmadan bulup çözebilir.

Adım 1: bir barkod alanı tanımla

BarcodeField sınıfı barkodun konumunu, boyutunu ve tipini tanımlar.
Definition anchor: BarcodeField, ayrıştırıcıya barkodun nerede aranacağını ve hangi formatın bekleneceğini söyleyen nesnedir.

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

Adım 2: bir şablon oluştur

Template, bir veya daha fazla BarcodeField nesnesini gruplar, böylece ayrıştırıcı neyi çıkaracağını tam olarak bilir.
Definition anchor: Template, ayrıştırıcının bir belgeye uyguladığı alan tanımlarının bir koleksiyonunu temsil eder.

// Define a barcode field with its position and type
TemplateBarcode barcode = new TemplateBarcode(
        new Rectangle(new Point(405, 55), new Size(100, 50)),
        "QR");

Adım 3: ayrıştırıcıyı kullanarak belgeyi ayrıştır

Bir belgeyi yükleyen, şablonları uygulayan ve çıkarılan verileri döndüren bir Parser nesnesi oluşturun.
Definition anchor: Parser, bir belgeyi yükleyen, şablonları uygulayan ve çıkarılan verileri döndüren temel sınıftır.

// Create a template containing the barcode field
template = new Template(Arrays.asList(new TemplateItem[]{barcode}));

Ayrıştırıcı her sayfayı tarar, QR‑kod bölgesini eşleştirir ve tek bir çağrıda çözülen dizeyi döndürür.

Bir belge ayrıştırıcı örneği nasıl oluşturulur ve kullanılır

Birden fazla belgeyle verimli çalışmak için, kaynak dosyaların bulunduğu dizini referans alan tek bir Parser nesnesi oluşturun. Bu paylaşılan örnek iç kaynakları korur, kütüphaneyi tekrar tekrar yükleme maliyetini azaltır. İşlem hacmini artırmak ve çöp toplama baskısını azaltmak için toplu işlerde kullanın.

Parser sınıfı, belgeleri yükleyen, şablonları uygulayan ve çıkarılan barkod verilerini döndüren temel bileşendir.

Adım 1: ayrıştırıcıyı örnekleyin

Kaynak dosyalarınızı içeren klasöre işaret eden yeniden kullanılabilir bir Parser nesnesi oluşturun. Aynı örneği birçok dosyada yeniden kullanmak, nesne oluşturma yükünü %40’a kadar azaltır.

try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY")) {
    DocumentData data = parser.parseByTemplate(template);

    // Iterate through extracted data and print barcode values
    for (int i = 0; i < data.getCount(); i++) {
        PageArea pageArea = data.get(i).getPageArea();
        if (pageArea instanceof PageBarcodeArea) {
            PageBarcodeArea area = (PageBarcodeArea) pageArea;
            System.out.println(data.get(i).getName() + ": " + area.getValue());
        } else {
            System.out.println(data.get(i).getName() + ": Not a template barcode field");
        }
    }
}

Artık bir dizini döngüyle gezebilir, her belgeyi ayrıştırabilir ve kütüphaneyi her seferinde yeniden başlatmadan barkod değerlerini toplayabilirsiniz.

Pratik uygulamalar

  1. Inventory management – gönderi PDF’lerinden ürün kimliklerini çekerek stokları otomatik güncelleyin.
  2. Retail loyalty programs – makbuzlardaki QR kodlarını okuyarak satın alımları müşteri hesaplarıyla ilişkilendirin.
  3. Supply‑chain tracking – gümrük belgelerindeki barkodları çıkararak malların hareketini gerçek zamanlı izleyin.

Performans değerlendirmeleri

  • Reuse parser instances toplu işler için GC baskısını azaltmak amacıyla yeniden kullanın.
  • Keep template rectangles tight; daha küçük arama alanları algılama hızını %20‑30 artırır.
  • Profile memory VisualVM veya YourKit ile çok sayfalı PDF’leri işlerken bellek sızıntılarını önleyin.

Yaygın sorunlar ve çözümler

SorunNedenÇözüm
Barkod değeri döndürülmediDikdörtgen koordinatları gerçek barkod konumuyla eşleşmiyorKoordinatları bir PDF görüntüleyicisinin ölçüm aracıyla doğrulayın; x, y, width ve height değerlerini buna göre ayarlayın.
IOException dosya açma sırasındaYanlış veya erişilemeyen dosya yoluMutlak bir yol kullanın veya uygulamanın dizine okuma izni olduğundan emin olun.
Büyük PDF’lerde yavaş işlemeHer sayfa için yeni bir Parser oluşturmaSayfalar arasında tek bir Parser örneğini yeniden kullanın veya Java’nın ExecutorService ile dosyaları paralel işleyin.
Desteklenmeyen belge formatı hatasıEski bir kütüphane sürümü kullanmaEk format desteği ekleyen en son GroupDocs.Parser sürümüne yükseltin.
Çıktıda beklenmeyen karakterlerQR kodu UTF‑8 kodlaması kullanıyor ancak ASCII olarak okunuyorDöndürülen dizeyi yorumlarken doğru karakter setini belirtin.

Sıkça sorulan sorular

S: Desteklenmeyen belge formatlarıyla nasıl başa çıkabilirim?
C: Tüm desteklenen formatları listeleyen en son GroupDocs.Parser sürümüne yükseltin. Eğer bir format hâlâ eksikse, dosyayı PDF’ye veya desteklenen bir görüntü türüne dönüştürerek ayrıştırın.

S: Görüntülerden de barkodları ayrıştırabilir miyim?
C: Evet. GroupDocs.Parser, PDF’lerde kullanacağınız aynı BarcodeField tanımını kullanarak PNG, JPEG, BMP ve TIFF dosyalarından QR kodlarını çıkarır.

S: Şablon tanımlarken yaygın tuzaklar nelerdir?
C: Yanlış hizalanmış dikdörtgenler, yanlış barkod tipinin seçilmesi (ör. “QR” vs. “CODE_128”) ve barkod alanını şablonun öğe listesine eklemeyi unutmak.

S: Aynı anda ayrıştırabileceğim barkod sayısında bir limit var mı?
C: Kütüphane belge başına düzinelerce barkodu işleyebilir; performans sayfa sayısı ve barkod yoğunluğuyla lineer olarak ölçeklenir.

S: Sorun yaşarsam nereden yardım alabilirim?
C: Sorularınızı GroupDocs Support Forum adresinde paylaşın veya sorun giderme kılavuzları için resmi belgeleri inceleyin.

Sonraki adımlar

Tam API referansını inceleyerek dinamik şablon oluşturma, çok iş parçacıklı toplu işleme ve özel barkod tipi uzantıları gibi daha derin özellikleri keşfedin. Standart dışı düzenlerde algılamayı iyileştirmek için farklı dikdörtgen şekilleri (elips, çokgen) deneyin ve ayrıştırıcıyı mevcut belge‑işleme hattınıza entegre ederek uçtan uca otomasyon sağlayın.

Kaynaklar


Son Güncelleme: 2026-10-07
Test Edilen Versiyon: GroupDocs.Parser 25.5 (Java)
Yazar: GroupDocs

try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY")) {
    System.out.println("Document parser created and ready to use.");
}

İlgili Öğreticiler