Aranabilir indeks oluşturma java: belgeleri ekle büyük/küçük harf duyarlı arama

Modern Java uygulamalarında, searchable index java oluşturma büyük belge koleksiyonlarından hızlı ve doğru bilgi almanın temelidir. Bu öğreticide bir indekse belge ekleme, büyük/küçük harf duyarlı aramayı etkinleştirme ve süreci GroupDocs.Search ile ince ayar yapma adımlarını gösteriyoruz. Hukuki bir depo, bir e‑ticaret kataloğu veya bir içerik‑yönetim sistemi oluşturuyor olsanız da, bu adımlar kullanıcıları memnun edecek kesin sonuçlar sunmanıza yardımcı olur.

Hızlı cevaplar

• Aramaya başlamak için birincil adım nedir? index.add(...) ile bir indekse belge ekleyin.
• Büyük/küçük harf duyarlı aramayı nasıl etkinleştirirsiniz? options.setUseCaseSensitiveSearch(true) ayarlayın.
• Birden fazla dizin arasında arama yapabilir misiniz? Evet – dahil etmek istediğiniz her klasör için index.add() çağırın.
• Hangi yöntem nesnelerle arama yapmanıza olanak tanır? SearchQuery.createWordQuery(...) kullanın.
• Test için lisansa ihtiyacınız var mı? Deneme amaçlı geçici bir lisans mevcuttur.

“add documents to index” ne anlama geliyor?

Bir indekse belge eklemek, kaynak dosyalarınızı (PDF’ler, Word belgeleri, düz metin vb.) GroupDocs.Search’e beslemek anlamına gelir, böylece aranabilir bir veri yapısı oluşturabilir. İndeks, token’lanmış terimleri, konumları ve meta verileri saklar ve motorun büyük/küçük harf duyarlı sorgular da dahil olmak üzere hızlı sorgular çalıştırmasına ve sonuçları verimli bir şekilde sıralamasına olanak tanır.

Java’da büyük/küçük harf duyarlı aramayı neden etkinleştirmelisiniz?

Büyük/küçük harf duyarlı aramayı etkinleştirmek, motorun yalnızca harf büyüklüğüyle farklılaşan terimleri ayırt etmesini sağlar; bu, büyük harf kullanımının anlam taşıdığı alanlar için kritiktir. Tam terim eşleşmesine izin verir, düzenleyici uyumluluk gereksinimlerini destekler ve kullanıcının sorgusundaki harf durumuyla tam olarak eşleşen sonuçları döndürerek alaka düzeyini artırır.

• Tam terim eşleşmesi – örn., “Apple” (şirket) vs. “apple” (meyve).
• Düzenleyici uyumluluk – birçok sektör kesin ifade eşleşmesi gerektirir.
• Geliştirilmiş alaka – teknik ve hukuki kullanıcılar genellikle harf durumuna özgü sonuçlar bekler.

Önkoşullar

• JDK 17 veya üzeri (önerilir)
• Bağımlılık yönetimi için Maven
• IntelliJ IDEA veya Eclipse gibi bir IDE
• Java programlamaya temel aşinalık

GroupDocs.Search for Java Kurulumu

Aşağıdaki Maven snippet’i, projenize GroupDocs.Search deposunu ve gerekli bağımlılığı ekler.

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

Alternatif olarak, en son sürümü doğrudan GroupDocs.Search for Java sürümleri adresinden indirebilirsiniz.

Lisanslama

Deneme sürümüne başlamak için GroupDocs sitesini ziyaret ederek geçici bir lisans edinin. Bu, tüm özellikleri sınırlama olmadan test etmenizi sağlar.

Aranabilir indeks oluşturma java – metin sorgu araması

Adım 1: bir indeks oluşturun ve belgelerinizi ekleyin

Index sınıfı, belgelerin indekslendiği, diskteki aranabilir bir depolama alanını temsil eder.

String indexFolder = YOUR_OUTPUT_DIRECTORY + "/CaseSensitiveSearch/QueryInTextForm";
Index index = new Index(indexFolder);
index.add(YOUR_DOCUMENT_DIRECTORY); // Add documents to the index

Pro ipucu: Tek bir indekste birden fazla dizin arasında arama yapmak için index.add() metodunu birden çok kez çağırabilirsiniz.

Adım 2: büyük/küçük harf duyarlı aramayı etkinleştirin

SearchOptions, sorguların nasıl işlendiğini, büyük/küçük harf duyarlılığı ve diğer arama davranışlarını yapılandırır.

SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true);

Adım 3: büyük/küçük harf duyarlı bir metin sorgusu çalıştırın

SearchQuery, motorun indeks üzerinde değerlendirdiği sorgu nesnesini oluşturur.

String query = "Advantages";
SearchResult result = index.search(query, options);

// Output results
for (FoundDocument doc : result.getDocuments()) {
    System.out.println("Document: " + doc.getDocumentInfo().getFilePath());
}

Döngü, tam olarak büyük/küçük harfe uygun terimi içeren her belgenin tam yolunu yazdırır.

Aranabilir indeks oluşturma java – nesne sorgu araması

Adım 1: ikinci bir indeks başlatın (isteğe bağlı)

Nesne tabanlı aramaları düz metin aramalarından izole etmek için ikinci bir Index örneği oluşturulabilir.

String indexFolder = YOUR_OUTPUT_DIRECTORY + "/CaseSensitiveSearch/QueryInObjectForm";
Index index = new Index(indexFolder);
index.add(YOUR_DOCUMENT_DIRECTORY); // Add documents to the index

Adım 2: büyük/küçük harf duyarlı seçeneği yeniden kullanın

SearchOptions, tutarlı harf durumu işleme için farklı sorgu tiplerinde yeniden kullanılabilir.

SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true);

Adım 3: bir nesne sorgusu oluşturun ve çalıştırın

WordQuery, karmaşık aramalar için diğer sorgu tipleriyle birleştirilebilen kelime‑düzeyinde bir aramayı temsil eder.

SearchQuery query = SearchQuery.createWordQuery("Advantages");
SearchResult result = index.search(query, options);

// Output results
for (FoundDocument doc : result.getDocuments()) {
    System.out.println("Document: " + doc.getDocumentInfo().getFilePath());
}

createWordQuery kullanmak, daha karmaşık senaryolar için bunu ifade, joker karakter veya Boolean sorgularıyla birleştirmenize olanak tanır.

Pratik uygulamalar

• Hukuki belge yönetimi: Büyük harf kullanımının önemli olduğu durum‑spesifik yasaları alın.
• E‑ticaret platformları: “PRO‑X” ile “pro‑x” gibi ürün SKU’larını ayırın.
• İçerik yönetim sistemleri (CMS): Yazarların tam başlıkları veya etiketleri bulmasını sağlayın.

Performans değerlendirmeleri

• İndeksi güncel tutun – yeni dosyalar eklendiğinde veya mevcut dosyalar değiştiğinde yeniden indeksleyin.
• Bellek kullanımını izleyin – büyük veri kümeleri artımlı indeksleme ve uygun JVM yığın boyutlandırmasından fayda sağlar.
• Java’nın çöp toplayıcısını kullanın – Index nesnelerini artık ihtiyaç duyulmadığında serbest bırakın.

Yaygın sorunlar ve çözümler

Sıkça sorulan sorular

Q: GroupDocs.Search ile büyük veri setlerini nasıl yönetirim?
A: Performansı optimal tutmak için indeks bölümlendirmesini kullanın, JVM bellek ayarlarını ayarlayın ve indeksi periyodik olarak sıkıştırın.

Q: Aynı anda birden fazla dizin arasında arama yapabilir miyim?
A: Evet – dahil etmek istediğiniz her dizin için index.add() çağırın, ardından birleşik indeks üzerinde tek bir sorgu çalıştırın.

Q: Büyük/küçük harf duyarlı aramaları ayarlarken yaygın hatalar nelerdir?
A: useCaseSensitiveSearch etkinleştirildikten sonra indeksi yeniden oluşturmayı unutmak veya sorgu dizesinde yanlış harf durumunu kullanmak.

Q: Arama hatalarını nasıl gideririm?
A: GroupDocs.Search tarafından oluşturulan günlük dosyalarında yığın izlerini kontrol edin ve tüm Maven bağımlılıklarının doğru çözüldüğünden emin olun.

Q: GroupDocs.Search gerçek‑zamanlı uygulamalar için uygun mu?
A: Uygun indeksleme stratejileri (artımlı güncellemeler ve bellek içi önbellekleme) ile neredeyse gerçek‑zamanlı arama sonuçları sağlayabilir.

Kaynaklar

• Documentation: GroupDocs.Search Java Belgeleri
• API reference: Java API Referansı
• Download: En Son Sürümler
• GitHub repository: GroupDocs.Search for Java
• Support forum: GroupDocs Ücretsiz Destek
• Temporary license: Geçici Lisans Edinin

Last Updated: 2026-08-10
Tested With: GroupDocs.Search 25.4
Author: GroupDocs

İlgili Öğreticiler

• Arama İndeksi Oluşturma Java – GroupDocs.Search Öğreticileri
• GroupDocs.Search for Java ile İndexe Belge Ekleme
• GroupDocs.Search kullanarak Java’da Metaveri İndeksleme ile İndexe Belge Ekleme