Cara Mencari Dokumen Menggunakan GroupDocs.Search Java

Dalam aplikasi perusahaan modern, cara mencari dokumen dengan cepat dan akurat merupakan kebutuhan penting. Baik Anda menangani kontrak, laporan, atau repositori dokumen besar apa pun, GroupDocs.Search untuk Java memberikan mesin pencarian full‑text yang kuat dengan pencocokan fuzzy bawaan. Tutorial ini memandu Anda melalui penyiapan pustaka, pembuatan indeks, penambahan dokumen, konfigurasi fuzzy search Java, dan pengambilan hasil—semua dengan penjelasan yang jelas dan bersahabat.

Jawaban Cepat

  • Apa langkah pertama? Instal pustaka GroupDocs.Search Java melalui Maven atau unduh langsung.
  • Bagaimana cara membuat indeks? Buat objek Index yang menunjuk ke folder di disk; pustaka secara otomatis membangun struktur yang dapat dicari.
  • Apakah saya dapat mencari dengan typo? Ya—aktifkan fuzzy search untuk mencocokkan istilah yang salah eja atau memiliki variasi kecil.
  • Bagaimana menambahkan dokumen? Gunakan metode add pada instance Index, dengan memberikan folder yang berisi file Anda.
  • Versi Java apa yang diperlukan? JDK 8 atau lebih tinggi didukung.

Apa itu “cara mencari dokumen” dalam konteks GroupDocs.Search?

“Cara mencari dokumen” mengacu pada proses membangun indeks yang dapat dicari dan mengirimkan kueri yang mengembalikan file yang cocok, secara opsional menggunakan logika fuzzy untuk menoleransi kesalahan ejaan. GroupDocs.Search menangani tokenisasi, pengindeksan, dan perankingan di balik layar, sehingga Anda dapat fokus pada logika bisnis.

Mengapa menggunakan GroupDocs.Search untuk Java?

GroupDocs.Search mendukung lebih dari 30 format file (termasuk DOCX, PDF, TXT, HTML, dan XLSX) dan dapat mengindeks dokumen ratusan halaman tanpa memuat seluruh file ke memori, memberikan respons kueri sub‑detik pada perangkat keras server tipikal. Kemampuan fuzzy search-nya meningkatkan pengalaman pengguna dengan mengembalikan hasil yang relevan bahkan ketika kueri mengandung typo.

Prasyarat

  • Java Development Kit (JDK): versi 8 atau lebih baru.
  • IDE: IntelliJ IDEA, Eclipse, atau editor kompatibel Java apa pun.
  • Pustaka GroupDocs.Search untuk Java: tambahkan via Maven (direkomendasikan) atau unduh JAR.

Cara Menyiapkan GroupDocs.Search untuk Java?

Untuk memulai, tambahkan dependensi GroupDocs.Search ke file build Anda, pastikan URL repositori dapat dijangkau, dan verifikasi bahwa versi JDK memenuhi persyaratan minimum. Setelah pustaka terresolusi, Anda dapat mengimpor kelasnya dalam kode Anda dan membuat folder indeks di disk tempat semua data yang dapat dicari akan disimpan.

Pengaturan Maven

Tambahkan repositori dan dependensi ke file pom.xml Anda persis seperti yang ditunjukkan dalam panduan asli.

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

Unduhan Langsung

Sebagai alternatif, dapatkan JAR dari halaman rilis resmi:

GroupDocs.Search for Java releases

GroupDocs.Search Documentation

Cara Membuat Indeks?

Buat folder indeks persisten tempat GroupDocs.Search menyimpan data yang ditokenisasi. Muat indeks pertama Anda dengan satu baris kode—new Index("path/to/indexFolder"). Kelas Index adalah komponen inti yang mewakili koleksi dokumen yang dapat dicari dalam memori dan di disk.

   import com.groupdocs.search.*;

   String indexFolder = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/Searching/SearchResults";
   Index index = new Index(indexFolder);

Cara Menambahkan Dokumen ke Indeks?

Gunakan metode add pada instance Index untuk menunjuk ke folder yang berisi file sumber Anda. Mesin akan memindai secara rekursif format yang didukung, mengekstrak konten teks, dan memperbarui struktur internal. Panggilan tunggal ini menangani batch besar secara efisien, menghilangkan kebutuhan pemrosesan file‑per‑file manual.

   String documentFolder = "YOUR_DOCUMENT_DIRECTORY";
   index.add(documentFolder);

Cara Mengonfigurasi Fuzzy Search Java?

Kelas FuzzySearchOptions mendefinisikan parameter seperti jarak edit dan panjang prefiks yang mengontrol seberapa toleran pencarian terhadap kesalahan ejaan. Objek SearchOptions mengelompokkan semua pengaturan waktu pencarian, termasuk opsi fuzzy, batas hasil, dan preferensi penyorotan. Aktifkan pencocokan fuzzy dengan menetapkan FuzzySearchOptions pada objek SearchOptions. Ini memberi tahu mesin untuk mempertimbangkan istilah dalam jarak edit yang dapat dikonfigurasi, membuat pencarian toleran terhadap kesalahan ejaan.

  String indexFolder = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/Searching/SearchResults";
  Index index = new Index(indexFolder);

Cara Melakukan Operasi Pencarian?

Panggil metode search pada objek Index, dengan memberikan string kueri dan SearchOptions yang telah dikonfigurasi. Mesin memproses permintaan, menerapkan pencocokan fuzzy jika diaktifkan, dan memberi peringkat hasil berdasarkan skor relevansi. Operasi selesai dengan cepat bahkan pada indeks besar karena pencarian dilakukan pada struktur token yang telah dibangun sebelumnya. Metode mengembalikan koleksi SearchResult yang berisi dokumen yang cocok, jumlah hit, dan cuplikan yang disorot.

  String documentFolder = "YOUR_DOCUMENT_DIRECTORY";
  index.add(documentFolder);

Cara Memproses dan Menampilkan Hasil Pencarian?

SearchResult adalah koleksi yang menyimpan objek SearchResultItem individual, masing‑masing menggambarkan dokumen yang cocok, jumlah hit, dan cuplikan yang disorot. Iterasi melalui item SearchResult dan cetak path setiap dokumen, jumlah kemunculan, dan frasa yang cocok. Loop sederhana ini memungkinkan Anda membangun tabel UI, log, atau respons API yang menunjukkan secara tepat mengapa sebuah dokumen cocok.

  import com.groupdocs.search.options.*;

  SearchOptions options = new SearchOptions();
  options.getFuzzySearch().setEnabled(true);
  options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3));

Aplikasi Praktis

Skenario dunia nyata di mana cara mencari dokumen penting:

  1. Manajemen Dokumen Hukum: Temukan klausul atau pihak dalam ribuan kontrak dalam hitungan detik.
  2. Penelitian Akademik: Dapatkan makalah relevan bahkan jika istilah pencarian salah eja.
  3. Manajemen Konten Perusahaan: Dukung portal internal dengan pencarian cepat dan toleran typo di seluruh laporan, email, dan presentasi.

Pertimbangan Kinerja

  • Penyegaran Indeks: Jalankan kembali add atau update setiap kali file sumber berubah untuk menjaga hasil tetap segar.
  • Manajemen Memori: GroupDocs.Search melakukan streaming file besar, sehingga jejak memori tetap rendah bahkan untuk PDF 500‑halaman.
  • Pengindeksan Berbagi: Bagi korpus besar menjadi beberapa folder indeks untuk memparalelkan proses dan meningkatkan latensi kueri.

Pertanyaan yang Sering Diajukan

Q: Apa itu fuzzy search Java dan mengapa berguna?
A: Fuzzy search Java memungkinkan pencocokan string perkiraan, memungkinkan kueri mengembalikan hasil meskipun ada typo atau ejaan alternatif, yang meningkatkan pengalaman pengguna akhir.

Q: Bagaimana cara memperbarui indeks saya setelah menambahkan file baru?
A: Panggil index.add("new/files/folder") lagi; pustaka secara cerdas menggabungkan konten baru tanpa membangun ulang seluruh indeks.

Q: Bisakah GroupDocs.Search menangani PDF yang dilindungi kata sandi?
A: Ya—berikan kata sandi dalam DocumentLoadOptions saat menambahkan file, dan mesin akan mendekripsi serta mengindeks kontennya.

Q: Apakah ada batas jumlah dokumen yang dapat saya indeks?
A: Pustaka dapat diskalakan hingga jutaan file; kinerja tergantung pada perangkat keras dan penyimpanan, bukan batas yang ditetapkan secara keras.

Q: Di mana saya dapat menemukan contoh yang lebih maju?
A: Kunjungi dokumentasi resmi untuk topik yang lebih mendalam seperti analyzer khusus dan perankingan hasil.

Kesimpulan

Anda sekarang mengetahui cara mencari dokumen dengan GroupDocs.Search untuk Java, mulai dari membuat indeks hingga mengaktifkan fuzzy search Java dan memproses hasil. Terapkan langkah‑langkah ini untuk memberikan pengalaman pencarian cepat dan toleran typo dalam aplikasi berbasis Java apa pun.

Terakhir Diperbarui: 2026-05-28
Diuji Dengan: GroupDocs.Search 23.10 untuk Java
Penulis: GroupDocs

  String query = "water OR \"Lorem ipsum\"";
  SearchResult result = index.search(query, options);

  for (int i = 0; i < result.getDocumentCount(); i++) {
      FoundDocument document = result.getFoundDocument(i);
      System.out.println("\tDocument: " + document.getDocumentInfo().getFilePath());
      System.out.println("\tOccurrences: " + document.getOccurrenceCount());

      for (FoundDocumentField field : document.getFoundFields()) {
          System.out.println("\t\tField: " + field.getFieldName());
          if (field.getTerms() != null) {
              for (int k = 0; k < field.getTerms().length; k++) {
                  System.out.println("\t\t\t" + field.getTerms()[k] + " - " + field.getTermsOccurrences()[k]);
              }
          }
      }
  }

Tutorial Terkait