Java ve Aspose için GroupDocs ile Belge Yönetimi OCR

Bu kılavuzda GroupDocs nasıl kullanılır keşfederek Java uygulamalarınıza OCR‑destekli arama eklemeyi öğreneceksiniz; bu, modern belge yönetimi OCR çözümlerinin temel bir yeteneğidir. GroupDocs.Search ile Aspose.OCR’u birleştirerek görüntü‑tabanlı içeriği aranabilir metne dönüştürebilir, belge yönetim sistemlerini son kullanıcılar için çok daha kullanışlı hâle getirebilirsiniz. Kurulum, indeksleme, arama ve özel OCR entegrasyonu adımlarını, bugün projenize kopyalayabileceğiniz net, adım‑adım örneklerle ele alacağız.

Hızlı Yanıtlar

  • OCR indekslemesini sağlayan kütüphane nedir? GroupDocs.Search paired with Aspose.OCR.
  • Hangi Java sürümü gereklidir? JDK 8 veya üzeri.
  • Lisans gerekli mi? Ücretsiz deneme mevcuttur; üretim için ücretli lisans gereklidir.
  • Ayrı ve gömülü görüntüleri indeksleyebilir miyim? Evet, IndexingOptions içinde her iki seçeneği de etkinleştirin.
  • Çoklu iş parçacığı (multi‑threading) destekleniyor mu? Evet, büyük veri setleri için indekslemeyi paralelleştirebilirsiniz.

Belge Yönetimi OCR Nedir?

Belge yönetimi OCR, görüntülerden (tarama PDF’leri dahil) metin çıkarır ve bunu aranabilir bir indeks içinde saklar. GroupDocs.Search indeksleme ve sorgu yürütmeyi yönetirken, Aspose.OCR gerçek karakter tanımasını gerçekleştirir; böylece tam bir belge yönetimi OCR boru hattına sahip olursunuz.

Java OCR İndekslemesi için GroupDocs Neden Kullanılmalı?

  • Yüksek doğruluk – Aspose’un gelişmiş OCR motoru sayesinde.
  • Sorunsuz Java entegrasyonu – Maven veya doğrudan JAR’lar aracılığıyla.
  • Esnek yapılandırma – ayrı veya gömülü görüntüler için.
  • Ölçeklenebilir performans – çoklu iş parçacığı ve bellek‑optimizasyonlarıyla.
  • Kurumsal‑hazır lisanslama – üretim dağıtımları için seçenekler.

Önkoşullar

  • GroupDocs.Search ≥ 25.4
  • Aspose.OCR (en son sürüm)
  • JDK 8+ ve bir IDE (IntelliJ, Eclipse, NetBeans)
  • Temel Java bilgisi; Maven faydalı ancak zorunlu değil

GroupDocs.Search’ı Java için Kurma

Maven Kullanarak

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

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

Doğrudan İndirme

Alternatif olarak, GroupDocs.Search for Java’ın en son sürümünü GroupDocs releases adresinden indirin.

Lisans Edinme

  • Ücretsiz Deneme – tüm özellikleri ücretsiz keşfedin.
  • Geçici Lisans – uzatılmış test süresi.
  • Satın Alma – üretim dağıtımları için gereklidir.

Temel Başlatma ve Kurulum

Bir indeks klasörü oluşturun ve Index nesnesini başlatın:

import com.groupdocs.search.Index;
// Specify the directory where the index will be stored.
String indexFolder = "YOUR_OUTPUT_DIRECTORY/OcrSupport";
// Create an instance of Index class at the specified location.
Index index = new Index(indexFolder);

OCR İndekslemesi için GroupDocs Nasıl Kullanılır

Bir İndeks Oluşturma

İndeks dosyalarını tutacak klasörü ilk olarak ayarlayın:

String indexFolder = "YOUR_OUTPUT_DIRECTORY/OcrSupport";
Index index = new Index(indexFolder);

OCR İndeksleme Seçeneklerini Ayarlama

Hem ayrı hem de gömülü görüntüler için OCR’u etkinleştirin ve özel bir OCR bağlayıcısı ekleyin:

import com.groupdocs.search.options.IndexingOptions;
IndexingOptions options = new IndexingOptions();
options.getOcrIndexingOptions().setEnabledForSeparateImages(true);
options.getOcrIndexingOptions().setEnabledForEmbeddedImages(true);
// Set a custom OCR connector.
options.getOcrIndexingOptions().setOcrConnector(new OcrConnector());

Belgeleri İndeksleme

Kaynak belgelerinizi (PDF, Word dosyaları, görüntüler vb.) indekse ekleyin:

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";
index.add(documentsFolder, options);

Bir İndekste Arama

İndekslenmiş içerik üzerinde bir arama sorgusu çalıştırın:

import com.groupdocs.search.results.SearchResult;
String query = "water";
SearchResult result = index.search(query);

OCR Bağlayıcısını Uygulama

Aspose.OCR’u kullanarak görüntülerden metin tanıyın. Aşağıda gösterildiği gibi IOcrConnector arayüzünü uygulayın:

import com.groupdocs.search.options.IOcrConnector;
import com.groupdocs.search.options.OcrContext;
import java.awt.image.BufferedImage;
import javax.imageio.ImageIO;
import com.aspose.ocr.AsposeOCR;

public class OcrConnector implements IOcrConnector {
    @Override
    public final String recognize(OcrContext context) {
        if (null == context.getImageLocation()) {
            throw new RuntimeException("The image type is not supported: " + context.getImageLocation());
        }
        
        BufferedImage image = ImageIO.read(context.getImageLocation().toFile());
        AsposeOCR api = new AsposeOCR();
        String text = api.RecognizePage(image);
        return text;
    }
}

Pratik Uygulamalar

  1. Belge Yönetim Sistemleri – taranmış görüntüler içeren belgelerin hızlı geri getirilmesi.
  2. Arşiv Geri Getirme – büyük arşivlerde tarihsel kayıtların bulunması.
  3. Hukuki Belge Analizi – taranmış imzalar veya diyagramlar içeren sözleşme ve delillerin aranması.
  4. Tıbbi Kayıt Araması – hasta formları, laboratuvar sonuçları ve röntgen notlarının indekslenmesi.

Performans Düşünceleri

  • İndeks Boyutu – gereksiz meta verileri dışarıda bırakarak indeksi hafif tutun.
  • Çoklu İş Parçacığı – büyük partileri paralel işleyerek indeksleme hızını artırın.
  • Bellek Yönetimi – yüksek çözünürlüklü görüntülerle çalışırken JVM yığınını izleyin.

Yaygın Sorunlar ve Çözümler

  • Lisans Hataları – lisans dosyasının uygulamanın çalışma dizinine doğru yerleştirildiğinden emin olun.
  • Eksik Görüntüler – görüntü yollarının erişilebilir ve desteklenen formatlarda (PNG, JPEG, BMP) olduğundan emin olun.
  • Bellek Tükenmesi – JVM yığınını (-Xmx) artırın veya belgeleri daha küçük partilerde işleyin.

Sıkça Sorulan Sorular

S: GroupDocs.Search ile lisans sorunlarını nasıl çözerim?
C: Tam özellikleri açmak için GroupDocs web sitesinden geçici bir lisans alın.

S: Büyük belge indekslemesini yönetmenin en iyi yolu nedir?
C: Performansı artırmak ve bellek baskısını azaltmak için çoklu iş parçacığı ve toplu işleme (batch processing) kullanın.

S: GroupDocs.Search içinde OCR ayarlarını daha da özelleştirebilir miyim?
C: Evet, IndexingOptions OCR davranışını, dil seçimi ve görüntü ön işleme gibi detayları ince ayar yapmanıza olanak tanır.

S: GroupDocs.Search kullanırken yaygın hata ayıklama ipuçları nelerdir?
C: Dizin yollarını iki kez kontrol edin, tüm bağımlılıkların mevcut olduğundan emin olun ve eksik dosyalar için günlük çıktısını inceleyin.

S: Aspose.OCR’u mevcut Java uygulamama nasıl entegre ederim?
C: Yukarıda gösterildiği gibi IOcrConnector arayüzünü uygulayın ve görüntü girişini doğru şekilde işlediğinizden emin olun.

Kaynaklar

Last Updated: 2026-03-20
Tested With: GroupDocs.Search 25.4, Aspose.OCR latest release
Author: GroupDocs