Cara Mencari dengan Sinonim di Java Menggunakan GroupDocs.Search

Jika Anda ingin pengguna Anda menemukan konten yang tepat bahkan ketika mereka mengetik kata yang berbeda, pencarian dengan sinonim adalah jawabannya. Dalam panduan ini kami akan menjelaskan semua yang perlu Anda ketahui—membuat kamus sinonim, mengimpor/mengekspor, mengelola grup sinonim, dan akhirnya menjalankan pencarian yang secara otomatis memperluas kueri menggunakan sinonim tersebut. Baik Anda membangun CMS, katalog e‑commerce, atau repositori dokumen hukum, menambahkan dukungan sinonim dapat secara dramatis meningkatkan relevansi dan tingkat konversi.

Jawaban Cepat

Apa langkah utama untuk menambahkan sinonim? Inisialisasi sebuah Index dan gunakan API SynonymDictionary.
Apakah saya dapat mengimpor kamus sinonim? Ya – gunakan importDictionary(path) untuk memuat file yang sudah dibangun.
Bagaimana cara mengaktifkan pencarian dengan sinonim? Setel SearchOptions.setUseSynonymSearch(true).
Apakah memungkinkan mengelola grup sinonim? Tentu – Anda dapat menghapus, menambah, atau mengambil grup melalui API kamus.
Apa yang harus dipertimbangkan saat mengoptimalkan indeks pencarian? Secara rutin pangkas entri yang tidak terpakai dan sesuaikan heap JVM untuk dataset besar.

Apa Itu Pencarian dengan Sinonim?

“Pencarian dengan sinonim” berarti mesin memperlakukan sekumpulan kata atau frasa sebagai dapat dipertukarkan. Ketika pengguna mengetik “better”, mesin juga mencari “improve”, “enhance”, atau istilah lain yang Anda definisikan dalam grup sinonim yang sama, memberikan hasil yang lebih kaya tanpa mengubah kueri pengguna.

Mengapa Mengaktifkan Dukungan Sinonim di GroupDocs.Search?

Pengalaman pengguna yang lebih baik: Pengunjung menemukan dokumen yang relevan meskipun mereka menggunakan terminologi yang berbeda.
Tingkat konversi yang lebih tinggi: Platform e‑commerce menangkap lebih banyak penjualan dengan mencocokkan istilah produk yang beragam.
Pemeliharaan yang disederhanakan: Satu kamus pusat dapat melayani banyak aplikasi, membuat pembaruan menjadi mudah.

Prasyarat

GroupDocs.Search untuk Java versi 25.4 atau lebih baru.
IDE Java (IntelliJ IDEA, Eclipse, dll.) dengan dukungan Maven.
Pengetahuan dasar Java dan familiaritas dengan struktur proyek Maven.

Perpustakaan dan Versi yang Diperlukan

GroupDocs.Search untuk Java versi 25.4 atau lebih tinggi.

Penyiapan Lingkungan

IDE pilihan Anda (IntelliJ IDEA, Eclipse, dll.).
Maven untuk manajemen dependensi.

Persyaratan Pengetahuan

Pemrograman berorientasi objek di Java.
Operasi file I/O dasar.

Menyiapkan GroupDocs.Search untuk Java

Informasi Instalasi

Tambahkan repositori dan dependensi ke pom.xml Anda:

<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 – Anda juga dapat mengunduh JAR terbaru dari GroupDocs.Search for Java releases.

Akuisisi Lisensi

Free Trial: Uji fitur inti tanpa lisensi.
Temporary License: Perpanjang kemampuan percobaan selama evaluasi.
Purchase: Diperlukan untuk penggunaan produksi dan set fitur lengkap.

Inisialisasi dan Penyiapan Dasar

Buat instance Index, kemudian tambahkan dokumen yang akan dapat dicari:

import com.groupdocs.search.*;

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Index";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath2";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Adding documents from a specific folder to the index
index.add(documentsFolder);

Cara Menambahkan Sinonim ke Indeks Pencarian Anda

Membuat indeks adalah dasar. Di bawah ini kami menjelaskan langkah-langkah penting, masing-masing dipasangkan dengan kode yang tepat yang Anda butuhkan.

Fitur 1: Membuat dan Mengindeks sebuah Indeks

// Create an index in the specified folder
Index index = new Index(indexFolder);

// Add documents from the given folder to the index
index.add(documentsFolder);

Fitur 2: Mengambil Sinonim untuk Sebuah Kata

String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");

Fitur 3: Mengambil Grup Sinonim

String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");

Fitur 4: Mengelola Entri Kamus Sinonim

if (index.getDictionaries().getSynonymDictionary().getCount() > 0) {
    index.getDictionaries().getSynonymDictionary().clear();
}

String[][] newSynonymGroups = new String[][]{
    new String[] { "achieve", "accomplish", "attain", "reach" },
    new String[] { "accept", "take", "have" },
    new String[] { "improve", "better" }
};

index.getDictionaries().getSynonymDictionary().addRange(newSynonymGroups);

Fitur 5: Mengekspor Sinonim ke File

String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);

Fitur 6: Mengimpor Sinonim dari File

index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);

Fitur 7: Melakukan Pencarian dengan Dukungan Sinonim

String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);

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

Cara Mencari dengan Sinonim

Dengan mengaktifkan setUseSynonymSearch(true), mesin secara otomatis memperluas kueri menggunakan kamus sinonim yang Anda buat atau impor. Langkah ini penting untuk memberikan hasil yang lebih kaya tanpa mengubah perilaku pencarian pengguna.

Cara Mengimpor Kamus Sinonim

Jika Anda sudah memiliki file .dat yang disiapkan oleh lingkungan lain, cukup panggil importDictionary(path). Ini ideal untuk menyinkronkan kamus di antara server pengembangan, staging, dan produksi.

Cara Mengelola Grup Sinonim

Grup sinonim memungkinkan Anda memperlakukan sekumpulan istilah sebagai satu entitas logis. Menambah, menghapus, atau mengambil grup dilakukan melalui API SynonymDictionary, seperti yang ditunjukkan dalam cuplikan kode di atas.

Cara Mengoptimalkan Indeks Pencarian

Secara rutin pangkas entri yang tidak terpakai: Gunakan clear() sebelum pembaruan massal.
Sesuaikan heap JVM: Kamus besar mungkin memerlukan lebih banyak memori.
Jaga perpustakaan tetap terbaru: Rilis baru berisi perbaikan kinerja.

Aplikasi Praktis

Sistem Manajemen Konten (CMS): Pengguna menemukan artikel meskipun mereka menggunakan terminologi alternatif.
Platform E‑commerce: Pencarian produk menjadi toleran terhadap sinonim seperti “laptop” vs. “notebook”.
Repositori Dokumen: Arsip hukum atau medis mendapat manfaat dari grup sinonim khusus domain.

Pertimbangan Kinerja

Optimalkan Penyimpanan Indeks: Secara berkala bangun kembali indeks untuk menghapus data usang.
Kelola Penggunaan Memori: Pantau konsumsi heap saat memuat file sinonim besar.
Pembaruan Rutin: Tetap gunakan versi GroupDocs.Search terbaru untuk perbaikan bug dan peningkatan kecepatan.

Masalah Umum dan Solusinya

Masalah	Penyebab Kemungkinan	Solusi
Tidak ada hasil sinonim yang muncul	`setUseSynonymSearch(true)` tidak diatur atau kamus tidak diimpor	Pastikan opsi diaktifkan dan file kamus ada.
Kesalahan out‑of‑memory selama impor	File `.dat` yang sangat besar melebihi heap JVM	Tingkatkan ukuran heap `-Xmx` atau impor dalam batch yang lebih kecil.
Entri duplikat dalam hasil	Istilah yang sama muncul di beberapa grup sinonim	Konsolidasikan grup yang tumpang tindih menggunakan `clear()` lalu `addRange()`.

Pertanyaan yang Sering Diajukan

Q: Apa persyaratan sistem minimum untuk menggunakan GroupDocs.Search?
A: Sistem operasi modern apa pun dengan JDK yang kompatibel (Java 8 atau lebih baru) sudah cukup.

Q: Seberapa sering saya harus memperbarui kamus sinonim saya?
A: Perbarui setiap kali terminologi baru muncul—gunakan clear() diikuti addRange() untuk penyegaran bersih.

Q: Bisakah saya menjalankan GroupDocs.Search tanpa membeli lisensi?
A: Versi percobaan gratis dapat digunakan untuk evaluasi, tetapi lisensi diperlukan untuk penerapan produksi.

Q: Apa praktik terbaik untuk mengindeks kumpulan data besar?
A: Bagi data menjadi batch logis, pantau penggunaan heap, dan jadwalkan pemeliharaan indeks secara rutin.

Q: Saya tidak melihat hasil sinonim yang diharapkan—apa yang harus saya periksa?
A: Pastikan kamus telah diimpor dengan benar, bahwa setUseSynonymSearch(true) aktif, dan bahwa istilah-istilah ada dalam grup sinonim.

Sumber Daya

Terakhir Diperbarui: 2026-03-04
Diuji Dengan: GroupDocs.Search 25.4 untuk Java
Penulis: GroupDocs