Java’da arama dizini oluşturma ve yazım denetimini etkinleştirme

Modern Java uygulamalarında doğru arama sonuçları sunmak vazgeçilmez bir özelliktir. Bu öğreticide how to create search index java ve GroupDocs.Search ile yazım düzeltmeyi nasıl etkinleştireceğinizi gösteriyoruz; böylece kullanıcılar sorgularını yanlış yazsalar bile ilgili sonuçları alır. Kütüphaneyi nasıl kuracağınızı, belgeleri nasıl ekleyeceğinizi, maksimum hata sayısını nasıl yapılandıracağınızı ve yazım hatalarına toleranslı bir arama nasıl yapacağınızı göreceksiniz — ekstra bir konfigürasyon kodu satırı yazmadan.

Hızlı Yanıtlar

  • “enable spelling” ne yapar? Arama sırasında yanlış yazılmış terimleri en yakın doğru formlara yeniden yazarak yerleşik yazım denetleyiciyi etkinleştirir.
  • Bu özelliği hangi kütüphane sağlar? GroupDocs.Search for Java.
  • Bir lisansa ihtiyacım var mı? Değerlendirme için ücretsiz deneme çalışır; üretim kullanımı için tam lisans gereklidir.
  • Toleransı kontrol edebilir miyim? Evet – sorgu başına kaç yazım hatasına izin verileceğini tanımlamak için setMaxMistakeCount kullanın.
  • Büyük dizinler için uygun mu? Kesinlikle – motor, tipik sunucu donanımında sorgu gecikmesini 100 ms’nin altında tutarak milyonlarca kayıttan oluşan dizinleri yönetir.

GroupDocs.Search Nedir?

GroupDocs.Search, yerleşik yazım düzeltme dahil hızlı tam metin indeksleme ve gelişmiş arama özellikleri sunan bir Java kütüphanesidir. 50’den fazla giriş formatını destekler ve tüm dosyayı belleğe yüklemeden çok sayfalı belgeleri işleyebilir.

Java uygulamalarında yazım düzeltmeyi neden etkinleştirmelisiniz?

  • Kullanıcı memnuniyetini artırır – ziyaretçiler eksik yazım olsa bile doğru sonuçlar alır.
  • Hemen çıkma oranlarını azaltır – doğru sonuçlar kullanıcıların daha uzun süre etkileşimde kalmasını sağlar.
  • Çeşitli alanlarda çalışır – kütüphane kataloglarından e-ticaret ürün aramalarına kadar, yazım düzeltme her yerde alaka düzeyini artırır.

Önkoşullar

  • Java Development Kit (JDK) yüklü.
  • Temel Java ve Maven bilgisi.
  • İndeksleme kavramları hakkında anlayış.
  • Bir GroupDocs.Search deneme veya lisans anahtarı.

GroupDocs.Search for Java Kurulumu

Kütüphaneyi Maven projenize entegre edin.

Maven kurulumu
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 indirme
Alternatif olarak, en son sürümü GroupDocs.Search for Java releases adresinden indirin.

Lisans edinme

Değerlendirme için ücretsiz deneme lisansı alın. Üretim kullanımı için tam lisans satın alın veya resmi siteden geçici bir anahtar talep edin.

Java’da bir arama dizini nasıl oluşturulur?

SearchIndex, diskte depolanan aranabilir bir dizini temsil eden birincil sınıftır.
Diskte bir klasöre işaret eden bir SearchIndex örneği oluşturun, ardından kaynak dizinden belgeleri ekleyin. Motor, hızlı aramaları sağlayan ters bir indeks oluşturur. Her dosya için index.add() çağırabilirsiniz; kütüphane dosya türüne göre metni otomatik olarak çıkarır.

Yazım düzeltmeyi nasıl etkinleştiririm?

getSpellingOptions() indeks için yazım yapılandırma nesnesini döndürür ve yazım denetimi özelliklerini etkinleştirmenize veya ayarlamanıza olanak tanır.
Yazım denetimini etkinleştirmek için index.getSpellingOptions().setEnabled(true) çağırın. Bu, motorun sorgu terimlerini analiz etmesini ve uyumsuzluk tespit edildiğinde düzeltilmiş alternatifler önermesini sağlar. Özellik, kütüphanenin desteklediği tüm indekslenmiş diller için kutudan çıkar çıkmaz çalışır.

max mistake count ayarı nedir?

setMaxMistakeCount, yazım denetleyicisinin bir terim başına tolerans göstereceği maksimum karakter düzenlemesini yapılandırır.
setMaxMistakeCount(int), bir terim başına tolerans gösterecek maksimum karakter düzenlemesini (eklemeler, silmeler, değişiklikler) tanımlar. 2 olarak ayarlamak, motorun yaygın iki karakterli yazım hatalarını düzeltmesine izin verirken, alakasız sonuçlar döndürebilecek aşırı agresif düzeltmelerden kaçınır.

Yazım‑düzeltmeli bir arama nasıl yapılır

search() indeks üzerinde bir sorgu çalıştırır ve eşleşmeleri ile düzeltilmiş terimleri içeren bir SearchResult nesnesi döndürür.
search() metodunu kullanarak bir arama sorgusu çalıştırın. Sorgu yanlış yazılmış kelimeler içeriyorsa, motor düzeltilmiş terimleri ve en ilgili belgelerin bir listesini içeren bir SearchResult döndürür. Kullanıcıya şeffaflık sağlamak için hem orijinal sorguyu hem de düzeltilmiş versiyonu gösterebilirsiniz.
SearchResult, eşleşen belgelerin listesini ve sorgu düzeltmeleri hakkında bilgileri tutar.

Pratik uygulamalar

  1. Kütüphane sistemleri – yanlış yazılmış kitap başlıklarını veya yazar adlarını otomatik olarak düzeltir.
  2. E‑ticaret platformları – dönüşüm oranlarını artırmak için ürün adı yazım hatalarını düzeltir.
  3. İçerik yönetimi – editörlerin eksik anahtar kelimelerle bile makaleleri bulmasına yardımcı olur.

Performans değerlendirmeleri

  • İndeksi güncel tutun – yeni veya değişen dosyaları düzenli olarak yeniden indeksleyin.
  • JVM bellek ayarlarını ayarlayın – büyük indeksler için yeterli yığın ayırın (ör. -Xmx4g).
  • Kaynak kullanımını izleyin – toplu indeksleme sırasında duraklamalar fark ederseniz çöp toplama bayraklarını ayarlayın.

Yaygın sorunlar ve sorun giderme

SemptomMuhtemel nedenÇözüm
Yazım denetimi etkinleştirildikten sonra sonuç gelmiyorİndeks klasör yolu yanlış veya boşindexFolder‘ın geçerli bir indekse işaret ettiğini ve index.add()‘ın başarılı olduğunu doğrulayın
Yazım denetleyicisi bariz hataları düzeltmiyorsetMaxMistakeCount çok düşük ayarlanmışDaha toleranslı düzeltme için sayıyı 2 veya 3 olarak artırın
Uygulama büyük belge setlerinde çöküyorYetersiz JVM yığını-Xmx seçeneğini artırın (ör. -Xmx4g)

Sıkça Sorulan Sorular

S: GroupDocs.Search nedir?
C: GroupDocs.Search, hızlı indeksleme, gelişmiş sorgu yetenekleri ve herhangi bir Java uygulaması için yerleşik yazım düzeltme sağlayan bir Java kütüphanesidir.

S: GroupDocs.Search için lisansı nasıl elde ederim?
C: Resmi siteyi ziyaret ederek ücretsiz deneme indirebilir veya tam lisans satın alabilirsiniz; kısa vadeli test için geçici bir anahtar da mevcuttur.

S: GroupDocs.Search’i diğer Java çerçeveleriyle entegre edebilir miyim?
C: Evet, Spring, Jakarta EE ve herhangi bir standart Java uygulamasıyla sorunsuz çalışır.

S: Bir indeks kurarken yaygın sorunlar nelerdir?
C: Yanlış klasör yolları, eksik dosya izinleri veya eksik Maven bağımlılıkları tipik sorunlardır.

S: Yazım düzeltme arama sonuçlarını nasıl iyileştirir?
C: Yanlış yazılmış sorguları otomatik olarak en yakın doğru terimlere yeniden yazar, daha ilgili sonuçlar döndürür ve kullanıcı hayal kırıklığını azaltır.

Ek kaynaklar

Son Güncelleme: 2026-09-02
Test Edilen Versiyon: GroupDocs.Search 25.4
Yazar: GroupDocs

import com.groupdocs.search.*;

public class FeatureIndexAndAddDocuments {
    public static void main(String[] args) {
        // Define where the index will be stored
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        
        // Create an Index instance pointing to the specified folder
        Index index = new Index(indexFolder);
        
        // Specify the documents directory for indexing
        String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";  
        
        // Add documents from this directory to the index
        index.add(documentsFolder);
    }
}

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;

public class FeatureSpellingCorrectionOptions {
    public static void main(String[] args) {
        // Instantiate SearchOptions
        SearchOptions options = new SearchOptions();
        
        // Enable spelling correction
        options.getSpellingCorrector().setEnabled(true);
        
        // Allow up to one mistake during search
        options.getSpellingCorrector().setMaxMistakeCount(1);
        
        // Return only the best results after correction
        options.getSpellingCorrector().setOnlyBestResults(true);
    }
}

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

public class FeatureSpellingCorrectionSearch {
    public static void main(String[] args) {
        // Create an index in the specified directory
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        Index index = new Index(indexFolder);
        
        // Define search options with spelling correction enabled
        SearchOptions options = new SearchOptions();
        options.getSpellingCorrector().setEnabled(true);
        options.getSpellingCorrector().setMaxMistakeCount(1);
        options.getSpellingCorrector().setOnlyBestResults(true);
        
        // Specify a misspelled search query
        String query = "houseohld";
        
        // Execute the spelling‑corrected search
        SearchResult result = index.search(query, options);
    }
}

İlgili Öğreticiler