Cara menggunakan sinonim di Java dengan GroupDocs.Search
Jika Anda ingin pengguna menemukan konten yang tepat bahkan ketika mereka mengetik kata yang berbeda, search with synonyms adalah jawabannya. Dalam panduan ini Anda akan belajar cara membuat kamus sinonim, mengimpor atau mengekspornya, mengelola grup sinonim, dan 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 pertama untuk menambahkan sinonim? Create an
Indexinstance and work with theSynonymDictionaryAPI. - Bisakah saya mengimpor kamus sinonim yang sudah jadi? Yes – call
importDictionary(path)with the file location. - Bagaimana cara mengaktifkan pencarian yang sadar sinonim? Enable
SearchOptions.setUseSynonymSearch(true). - Apakah memungkinkan mengedit grup sinonim saat runtime? Absolutely – you can clear, add, or retrieve groups via the dictionary API.
- Apa yang harus saya pantau saat memperbesar indeks? Regularly prune unused entries and tune the JVM heap for large synonym files.
Apa itu search with synonyms?
Search with synonyms 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?
Mengaktifkan dukungan sinonim memungkinkan mesin secara otomatis memperluas kueri untuk menyertakan istilah yang setara, yang meningkatkan relevansi hasil, meningkatkan kepuasan pengguna, dan dapat meningkatkan tingkat konversi untuk situs e‑commerce atau berbasis konten. Ini juga memusatkan manajemen terminologi, mengurangi beban pemeliharaan di banyak aplikasi.
Prasyarat
- GroupDocs.Search for 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 for Java 25.4 atau lebih tinggi.
Pengaturan 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
Add the repository and dependency to your pom.xml:
<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>
Direct download – Anda juga dapat mengunduh JAR terbaru dari GroupDocs.Search for Java releases.
Perolehan 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 pengaturan dasar
Create an Index instance, then add documents to be searchable:
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
Fitur 1: membuat dan mengindeks sebuah indeks
The Index class represents a searchable collection of documents stored on disk or in memory.
// 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
SynonymDictionary manages synonym groups and provides methods to query synonyms for a term.
String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");
Fitur 3: mengambil grup sinonim
SynonymDictionary.getGroups() returns a list of all defined synonym groups with their identifiers.
String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");
Fitur 4: mengelola entri kamus sinonim
add(word, synonym) inserts a new synonym relationship into the dictionary. clear() removes all entries, and remove(word) deletes a specific term from the dictionary.
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
exportDictionary(path) writes the current synonym dictionary to a binary .dat file at the specified location.
String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);
Fitur 6: mengimpor sinonim dari file
importDictionary(path) loads a previously exported .dat file into the synonym dictionary.
index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);
Fitur 7: melakukan pencarian dengan dukungan sinonim
SearchOptions configures query behavior, including whether synonym expansion is enabled. setUseSynonymSearch(true) turns on synonym‑aware searching for the upcoming query.
String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);
SearchResult result = index.search(query, options);
Cara mencari dengan sinonim
Load your Index, enable synonym search, and execute a query. The engine automatically expands the query using the synonym dictionary you built or imported, returning matches for all related terms.
Cara mengimpor kamus sinonim
If you already have a .dat file prepared by another environment, simply call importDictionary(path). This is ideal for synchronizing dictionaries across development, staging, and production servers.
Cara mengelola grup sinonim
Synonym groups let you treat a set of terms as a single logical entity. Adding, clearing, or retrieving groups is done through the SynonymDictionary API, as shown in the code snippets above.
Cara mengoptimalkan indeks pencarian
- Regularly prune unused entries: Gunakan
clear()sebelum pembaruan massal. - Adjust JVM heap: Kamus besar mungkin memerlukan lebih banyak memori; tingkatkan parameter
-Xmxsesuai. - Keep the library up‑to‑date: Rilis baru berisi perbaikan kinerja dan perbaikan bug.
Aplikasi praktis
- Content management systems (CMS): Pengguna menemukan artikel bahkan ketika mereka menggunakan terminologi alternatif.
- E‑commerce platforms: Pencarian produk menjadi toleran terhadap sinonim seperti “laptop” vs. “notebook”.
- Document repositories: Arsip hukum atau medis mendapat manfaat dari grup sinonim khusus domain, meningkatkan kemampuan penemuan bagi profesional.
Pertimbangan kinerja
- Optimize index storage: Secara berkala bangun kembali indeks untuk menghapus data usang.
- Manage memory usage: Pantau konsumsi heap saat memuat file sinonim besar; kamus 500 MB biasanya memerlukan heap 2 GB pada JVM 64‑bit.
- Regular updates: Tetap gunakan versi GroupDocs.Search terbaru untuk perbaikan bug dan peningkatan kecepatan.
Masalah umum dan solusi
| Issue | Likely cause | Fix |
|---|---|---|
| Tidak ada hasil sinonim yang muncul | setUseSynonymSearch(true) tidak diatur atau kamus tidak diimpor | Verifikasi opsi diaktifkan dan file kamus ada. |
| Kesalahan out‑of‑memory saat 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 berfungsi 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: Verifikasi bahwa kamus telah diimpor dengan benar, bahwa setUseSynonymSearch(true) aktif, dan bahwa istilah ada dalam grup sinonim.
Sumber daya
- Dokumentasi
- Referensi API
- Unduh GroupDocs.Search untuk Java
- Repositori GitHub
- Forum Dukungan Gratis
- Perolehan Lisensi Sementara
Terakhir Diperbarui: 2026-10-17
Diuji Dengan: GroupDocs.Search 25.4 for Java
Penulis: GroupDocs