วิธีใช้คำพ้องความหมายใน Java กับ GroupDocs.Search

หากคุณต้องการให้ผู้ใช้ของคุณค้นหาเนื้อหาที่ถูกต้องแม้พิมพ์คำต่างกัน search with synonyms คือคำตอบ ในคู่มือนี้คุณจะได้เรียนรู้วิธีสร้างพจนานุกรมคำพ้องความหมาย, การนำเข้าและส่งออก, การจัดการกลุ่มคำพ้องความหมาย, และการทำการค้นหาที่ขยายคำค้นโดยอัตโนมัติด้วยคำพ้องความหมายเหล่านั้น ไม่ว่าคุณจะสร้าง CMS, แคตาล็อกอี‑คอมเมิร์ซ, หรือคลังเอกสารกฎหมาย การเพิ่มการสนับสนุนคำพ้องความหมายสามารถเพิ่มความเกี่ยวข้องและอัตราการแปลงได้อย่างมาก

คำตอบด่วน

  • ขั้นตอนแรกในการเพิ่มคำพ้องความหมายคืออะไร? Create an Index instance and work with the SynonymDictionary API.
  • ฉันสามารถนำเข้าพจนานุกรมคำพ้องความหมายที่เตรียมไว้แล้วได้หรือไม่? Yes – call importDictionary(path) with the file location.
  • ฉันจะเปิดการค้นหาที่รับรู้คำพ้องความหมายได้อย่างไร? Enable SearchOptions.setUseSynonymSearch(true).
  • สามารถแก้ไขกลุ่มคำพ้องความหมายในขณะทำงานได้หรือไม่? Absolutely – you can clear, add, or retrieve groups via the dictionary API.
  • ฉันควรตรวจสอบอะไรเมื่อขยายขนาดดัชนี? Regularly prune unused entries and tune the JVM heap for large synonym files.

การค้นหาด้วยคำพ้องความหมายคืออะไร?

Search with synonyms หมายความว่าเอนจินจะถือชุดของคำหรือวลีว่าเทียบเท่ากัน เมื่อผู้ใช้พิมพ์ “better” เอนจินจะค้นหา “improve”, “enhance”, หรือคำอื่นใดที่คุณกำหนดในกลุ่มคำพ้องความหมายเดียวกัน ส่งผลให้ได้ผลลัพธ์ที่หลากหลายยิ่งขึ้นโดยไม่ต้องเปลี่ยนคำค้นของผู้ใช้

ทำไมต้องเปิดการสนับสนุนคำพ้องความหมายใน GroupDocs.Search?

การเปิดการสนับสนุนคำพ้องความหมายทำให้เอนจินขยายคำค้นโดยอัตโนมัติเพื่อรวมคำที่เทียบเท่า ซึ่งช่วยปรับปรุงความเกี่ยวข้องของผลลัพธ์, เพิ่มความพึงพอใจของผู้ใช้, และอาจเพิ่มอัตราการแปลงสำหรับเว็บไซต์อี‑คอมเมิร์ซหรือเว็บไซต์ที่เน้นเนื้อหา นอกจากนี้ยังทำให้การจัดการคำศัพท์เป็นศูนย์กลาง ลดภาระการบำรุงรักษาข้ามแอปพลิเคชันหลายตัว

ข้อกำหนดเบื้องต้น

  • GroupDocs.Search for Java version 25.4 or newer.
  • A Java IDE (IntelliJ IDEA, Eclipse, etc.) with Maven support.
  • Basic Java knowledge and familiarity with Maven project structure.

ไลบรารีและเวอร์ชันที่จำเป็น

  • GroupDocs.Search for Java 25.4 or higher.

การตั้งค่าสภาพแวดล้อม

  • IDE of your choice (IntelliJ IDEA, Eclipse, etc.).
  • Maven for dependency management.

ความต้องการด้านความรู้

  • Object‑oriented programming in Java.
  • Basic file I/O operations.

การตั้งค่า GroupDocs.Search สำหรับ Java

ข้อมูลการติดตั้ง

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 – you can also download the latest JAR from GroupDocs.Search for Java releases.

การรับใบอนุญาต

  • Free trial: Test core features without a license.
  • Temporary license: Extend trial capabilities during evaluation.
  • Purchase: Required for production use and the full feature set.

การเริ่มต้นและตั้งค่าพื้นฐาน

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

วิธีเพิ่มคำพ้องความหมายไปยังดัชนีการค้นหาของคุณ

ฟีเจอร์ 1: การสร้างและทำดัชนี

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

ฟีเจอร์ 2: การดึงคำพ้องความหมายสำหรับคำ

SynonymDictionary manages synonym groups and provides methods to query synonyms for a term.

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

ฟีเจอร์ 3: การดึงกลุ่มคำพ้องความหมาย

SynonymDictionary.getGroups() returns a list of all defined synonym groups with their identifiers.

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

ฟีเจอร์ 4: การจัดการรายการพจนานุกรมคำพ้องความหมาย

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

ฟีเจอร์ 5: การส่งออกคำพ้องความหมายไปยังไฟล์

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

ฟีเจอร์ 6: การนำเข้าคำพ้องความหมายจากไฟล์

importDictionary(path) loads a previously exported .dat file into the synonym dictionary.

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

ฟีเจอร์ 7: การทำการค้นหาด้วยการสนับสนุนคำพ้องความหมาย

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

วิธีการค้นหาด้วยคำพ้องความหมาย

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.

วิธีการนำเข้าพจนานุกรมคำพ้องความหมาย

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.

วิธีการจัดการกลุ่มคำพ้องความหมาย

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.

วิธีการปรับแต่งดัชนีการค้นหา

  • Regularly prune unused entries: Use clear() before bulk updates.
  • Adjust JVM heap: Large dictionaries may require more memory; increase the -Xmx parameter accordingly.
  • Keep the library up‑to‑date: New releases contain performance improvements and bug fixes.

การประยุกต์ใช้งานจริง

  1. Content management systems (CMS): Users find articles even when they use alternative terminology.
  2. E‑commerce platforms: Product searches become tolerant to synonyms like “laptop” vs. “notebook”.
  3. Document repositories: Legal or medical archives benefit from domain‑specific synonym groups, improving discoverability for professionals.

ข้อควรพิจารณาด้านประสิทธิภาพ

  • Optimize index storage: Periodically rebuild the index to remove stale data.
  • Manage memory usage: Monitor heap consumption when loading large synonym files; a 500 MB dictionary typically requires a 2 GB heap on a 64‑bit JVM.
  • Regular updates: Stay on the latest GroupDocs.Search version for bug fixes and speed gains.

ปัญหาทั่วไปและวิธีแก้

IssueLikely causeFix
No synonym matches appearsetUseSynonymSearch(true) not set or dictionary not importedVerify the option is enabled and the dictionary file exists.
Out‑of‑memory errors during importVery large .dat file exceeds JVM heapIncrease -Xmx heap size or import in smaller batches.
Duplicate entries in resultsSame term appears in multiple synonym groupsConsolidate overlapping groups using clear() then addRange().

คำถามที่พบบ่อย

Q: What is the minimum system requirement for using GroupDocs.Search?
A: Any modern OS with a compatible JDK (Java 8 or newer) is sufficient.

Q: How often should I refresh my synonym dictionary?
A: Update it whenever new terminology emerges—use clear() followed by addRange() for a clean refresh.

Q: Can I run GroupDocs.Search without purchasing a license?
A: A free trial works for evaluation, but a license is required for production deployments.

Q: What are best practices for indexing large data sets?
A: Split data into logical batches, monitor heap usage, and schedule regular index maintenance.

Q: I’m not seeing expected synonym matches—what should I check?
A: Verify that the dictionary is correctly imported, that setUseSynonymSearch(true) is active, and that the terms are present in the synonym groups.

แหล่งข้อมูล


อัปเดตล่าสุด: 2026-10-17
ทดสอบกับ: GroupDocs.Search 25.4 for Java
ผู้เขียน: GroupDocs

บทแนะนำที่เกี่ยวข้อง