same.

Author: GroupDocs => same.

Now produce final content.# GroupDocs.Search for Java ile Belge Dizini Oluşturma ve Belgeleri Ekleme

Binlerce PDF, DOCX, TXT ve diğer formatları anında aramanızı sağlayan belge dizini dosyaları oluşturmanız gerekiyorsa, GroupDocs.Search for Java bunu yapmanız için temiz bir API sunar. Bu öğreticide indeks klasörünü nasıl yapılandıracağınızı, belgeleri dizine eklemeyi ve gerçek dünya java tam metin arama senaryoları için arama performansını optimize etmeyi öğreneceksiniz.

Hızlı Yanıtlar

  • İlk adım nedir? GroupDocs.Search’i Maven üzerinden kurun veya kütüphaneyi indirin.
  • Dizine belgeleri nasıl eklerim? İndeksi başlattıktan sonra index.add(yourDocumentsFolder) çağırın.
  • İndeksi hangi klasörde saklamalı? output gibi ayrı bir klasör kullanın ve new Index(indexFolder) ile yapılandırın.
  • Arama hızını artırabilir miyim? Evet—indeksi düzenli olarak bakım yapın ve indekslemeyi arka plan iş parçacığında çalıştırın.
  • Lisans gerekli mi? Test için deneme veya geçici bir lisans yeterlidir; üretim için tam lisans gereklidir.

Belge Dizini Nedir?

Bir belge dizini, kaynak dosyalarınızdan çıkarılan aranabilir tokenları içeren yapılandırılmış bir veri deposudur. Belge dizini oluşturarak, çalışma zamanında her dosyayı taramadan tüm indekslenmiş içerik üzerinde hızlı tam‑metin sorgular yapabilirsiniz.

Neden GroupDocs.Search for Java Kullanmalısınız?

  • Yüksek performans – yerleşik optimizasyonlar, milyonlarca dosya olsa bile gecikmeyi düşük tutar.
  • Kolay entegrasyon – indeks oluşturma, belge ekleme ve sorgu çalıştırma için basit bir API.
  • Ölçeklenebilir mimari – yerinde veya bulutta çalışır ve eşanlamlı veya sıralama özellikleriyle özelleştirilebilir.
  • Java tam metin arama – kutudan çıkar çıkmaz çok çeşitli formatları destekler.

Önkoşullar

  • Java Development Kit (JDK) 8 veya üzeri.
  • IDE (IntelliJ IDEA veya Eclipse gibi).
  • Maven bağımlılık yönetimi için.
  • Java programlamaya temel aşinalık.

GroupDocs.Search for Java’ı Kurma

Maven Kurulumu

Add the following to your pom.xml file:

<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

Alternatively, download the latest version directly from GroupDocs.Search for Java releases.

Lisans Edinme

  1. Ücretsiz Deneme – taahhüt olmadan tüm özellikleri keşfedin.
  2. Geçici Lisans – deneme süresinin ötesinde test etmeyi uzatın.
  3. Satın Alma – üretim kullanımı için tam lisans edinin.

Temel Başlatma

import com.groupdocs.search.Index;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        // Create an index in the specified folder
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output";
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

Dizine Belgeleri Nasıl Eklenir

Adım 1: İndeks klasörünü ve kaynak klasörünü yapılandırma

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SynonymSearch";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with your actual document path

Açıklama: indexFolder, aranabilir indeksin saklanacağı yerdir, documentsFolder ise dizine belge eklemek istediğiniz dosyalara işaret eder.

Adım 2: İndeksi Oluşturma (indeks klasörünü yapılandırma)

Index index = new Index(indexFolder);

Açıklama: Bu satır, verilerini yapılandırdığınız klasöre yazan yeni bir indeks örneği oluşturur.

Adım 3: İndeksleme için Belgeleri Ekleyin

index.add(documentsFolder);

Açıklama: add metodu documentsFolder‘ı tarar ve belgeleri dizine ekler, böylece içerikleri aranabilir hâle gelir.

Sorun Giderme İpuçları

  • Eksik bağımlılıklarpom.xml içindeki Maven girdilerini iki kez kontrol edin.
  • Geçersiz klasör yoluindexFolder ve documentsFolder‘ın mevcut ve JVM tarafından erişilebilir olduğundan emin olun.

Büyük Belgelerle Çalışma

Gigabayt boyutunda PDF’ler veya devasa DOCX koleksiyonlarıyla çalışırken aşağıdakileri göz önünde bulundurun:

  1. Toplu işleme – kaynak klasörü daha küçük alt klasörlere bölün ve her toplu işlem için index.add() çağırın.
  2. Arka plan indeksleme – indeksleme kodunu ayrı bir iş parçacığında çalıştırın, böylece ana uygulamanız yanıt verir.
  3. Yığın ayarı – büyük dosyalar için süreç yeterli belleğe sahip olsun diye JVM -Xmx ayarını artırın.

Arama Performansını Optimize Etme

Arama performansını optimize etmek ve arama gecikmesini iyileştirmek için şu en iyi uygulamaları izleyin:

  • İndeks segmentlerini düzenli olarak birleştirin – bu, sorgular sırasında disk okuma sayısını azaltır.
  • Toplu eklemelerden sonra sıfırdan indeks oluşturmak yerine index.update() (varsa) kullanın.
  • Yığın kullanımını izleyin – büyük indeksler önemli bellek tüketebilir; JVM seçeneklerini buna göre ayarlayın.
  • Uygulama deseniniz izin veriyorsa sık çalışan sorgular için önbelleği etkinleştirin.

Pratik Uygulamalar

  1. Kurumsal Belge Yönetimi – sözleşmeleri, politikaları veya İK dosyalarını hızlıca alın.
  2. Hukuki Araştırma – dava dosyalarını ve içtihatları minimum gecikmeyle bulun.
  3. Akademik Kütüphaneler – akademisyenlerin binlerce araştırma makalesi arasında arama yapmasını sağlayın.

Yaygın Sorunlar ve Çözümler

SorunÇözüm
Toplu indeksleme sırasında bellek dışı hatalarKaynak klasörü daha küçük partilere bölün ve her partiyi ayrı ayrı indeksleyin.
Arama eski sonuçlar döndürürBüyük güncellemelerden sonra Index nesnesini yeniden açın veya mevcutsa index.update() çağırın.
Lisans tanınmıyorLisans dosyası yolunun doğru olduğundan ve lisans sürümünün kütüphane sürümüyle eşleştiğinden emin olun.

Sıkça Sorulan Sorular

S: Minimum hangi Java sürümü gereklidir?
C: Tam uyumluluk için Java 8 veya üzeri önerilir.

S: Çok büyük belge setlerini verimli bir şekilde nasıl yönetebilirim?
C: Toplu işleme kullanın, indekslemeyi arka plan iş parçacıklarında çalıştırın ve JVM bellek ayarlarını düzenleyin.

S: GroupDocs.Search bir bulut ortamına dağıtılabilir mi?
C: Evet, ancak indeks klasörü için depolama konumunun tüm örnekler tarafından erişilebilir olduğundan emin olun.

S: Eşanlamlı arama ne gibi faydalar sağlar?
C: Sorgu terimlerini ilgili kelimelerle genişleterek geri getirme oranını artırır, kesinlikten ödün vermeden.

S: Daha gelişmiş belgeleri nereden bulabilirim?
C: Resmi API referansına GroupDocs.Search API Reference adresinden ulaşın.

Kaynaklar

Bu adımları izleyerek artık belge dizini oluşturmayı, dizine belgeleri eklemeyi, indeks klasörünü yapılandırmayı ve GroupDocs.Search for Java ile arama performansını optimize etmeyi biliyorsunuz. Kodlamanın tadını çıkarın!


Last Updated: 2026-03-15
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs