JavaでGroupDocs.Searchの同義語を使用する方法
ユーザーが異なる単語で入力しても適切なコンテンツを見つけられるようにしたい場合、search with synonyms が解決策です。このガイドでは、同義語辞書の作成、インポート・エクスポート、同義語グループの管理、そして同義語を使用してクエリを自動的に拡張する検索の実行方法を学びます。CMS、eコマースカタログ、法務文書リポジトリの構築に関わらず、同義語サポートを追加することで、関連性とコンバージョン率を大幅に向上させることができます。
クイック回答
- 同義語を追加する最初のステップは何ですか?
Indexインスタンスを作成し、SynonymDictionaryAPI を使用します。 - 既製の同義語辞書をインポートできますか? はい – ファイルの場所を指定して
importDictionary(path)を呼び出します。 - 同義語対応検索を有効にするにはどうすればよいですか?
SearchOptions.setUseSynonymSearch(true)を有効にします。 - 実行時に同義語グループを編集できますか? もちろんです – 辞書 API を通じてグループをクリア、追加、取得できます。
- インデックスをスケールする際に何を監視すべきですか? 未使用エントリを定期的に削除し、大規模な同義語ファイル用に JVM ヒープを調整します。
同義語検索とは?
Search with synonyms は、エンジンが単語やフレーズのセットを相互に置き換え可能とみなすことを意味します。ユーザーが “better” と入力すると、エンジンは同じ同義語グループで定義された “improve”、“enhance”、その他の用語も検索し、ユーザーのクエリを変更せずにより豊富な結果を提供します。
GroupDocs.Searchで同義語サポートを有効にする理由
同義語サポートを有効にすると、エンジンはクエリを自動的に拡張して同等の用語を含めるようになり、結果の関連性が向上し、ユーザー満足度が高まり、eコマースやコンテンツ中心のサイトのコンバージョン率を上げることができます。また、用語管理を一元化し、複数のアプリケーション間での保守負荷を削減します。
前提条件
- GroupDocs.Search for Java バージョン 25.4 以上。
- Maven 対応の Java IDE(IntelliJ IDEA、Eclipse など)。
- 基本的な Java の知識と Maven プロジェクト構造の理解。
必要なライブラリとバージョン
- GroupDocs.Search for Java 25.4 以上。
環境設定
- お好みの IDE(IntelliJ IDEA、Eclipse など)。
- 依存関係管理のための Maven。
知識要件
- Java におけるオブジェクト指向プログラミング。
- 基本的なファイル I/O 操作。
GroupDocs.Search for Java の設定
インストール情報
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 – 最新の JAR は GroupDocs.Search for Java releases からもダウンロードできます。
ライセンス取得
- Free trial: ライセンスなしでコア機能をテストできます。
- Temporary license: 評価期間中に試用機能を拡張します。
- Purchase: 本番利用とフル機能セットには購入が必要です。
基本的な初期化と設定
Index インスタンスを作成し、検索対象のドキュメントを追加します:
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: インデックスの作成とインデックス化
Index クラスは、ディスクまたはメモリに保存された検索可能なドキュメントコレクションを表します。
// 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 は同義語グループを管理し、用語の同義語を照会するメソッドを提供します。
String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");
機能 3: 同義語グループの取得
SynonymDictionary.getGroups() は、定義されたすべての同義語グループとその識別子のリストを返します。
String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");
機能 4: 同義語辞書エントリの管理
add(word, synonym) は辞書に新しい同義語関係を挿入します。clear() はすべてのエントリを削除し、remove(word) は辞書から特定の用語を削除します。
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) は現在の同義語辞書を指定された場所のバイナリ .dat ファイルに書き込みます。
String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);
機能 6: ファイルから同義語をインポート
importDictionary(path) は以前にエクスポートされた .dat ファイルを同義語辞書にロードします。
index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);
機能 7: 同義語サポート付き検索の実行
SearchOptions はクエリの動作を設定し、同義語展開が有効かどうかを含みます。setUseSynonymSearch(true) は次のクエリに対して同義語対応検索を有効にします。
String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);
SearchResult result = index.search(query, options);
同義語を使用した検索方法
Index をロードし、同義語検索を有効にしてクエリを実行します。エンジンは構築またはインポートした同義語辞書を使用してクエリを自動的に展開し、すべての関連用語の一致を返します。
同義語辞書のインポート方法
別の環境で作成された .dat ファイルが既にある場合は、単に importDictionary(path) を呼び出すだけです。開発、ステージング、本番サーバー間で辞書を同期するのに最適です。
同義語グループの管理方法
同義語グループは、用語のセットを単一の論理エンティティとして扱うことを可能にします。グループの追加、クリア、取得は、上記のコードスニペットに示すように SynonymDictionary API を通じて行います。
検索インデックスの最適化方法
- Regularly prune unused entries: バルク更新前に
clear()を使用します。 - Adjust JVM heap: 大規模な辞書はより多くのメモリが必要になる可能性があるため、
-Xmxパラメータを適宜増やします。 - Keep the library up‑to‑date: 新しいリリースにはパフォーマンス向上とバグ修正が含まれます。
実用的な適用例
- Content management systems (CMS): ユーザーは代替用語を使用していても記事を見つけられます。
- E‑commerce platforms: 「laptop」対「notebook」のような同義語に寛容な商品検索が可能になります。
- Document repositories: 法務や医療のアーカイブは、ドメイン固有の同義語グループから恩恵を受け、専門家の発見性が向上します。
パフォーマンス上の考慮点
- Optimize index storage: 定期的にインデックスを再構築して古いデータを削除します。
- Manage memory usage: 大規模な同義語ファイルをロードする際にヒープ使用量を監視します。500 MB の辞書は 64 ビット JVM で通常 2 GB のヒープが必要です。
- Regular updates: バグ修正と速度向上のため、最新の GroupDocs.Search バージョンを使用し続けます。
よくある問題と解決策
| 問題 | 考えられる原因 | 解決策 |
|---|---|---|
| 同義語の一致が表示されない | setUseSynonymSearch(true) が設定されていない、または辞書がインポートされていない | オプションが有効であり、辞書ファイルが存在することを確認してください。 |
| インポート中のメモリ不足エラー | 非常に大きな .dat ファイルが JVM ヒープを超えている | -Xmx ヒープサイズを増やすか、より小さなバッチでインポートしてください。 |
| 結果に重複エントリがある | 同じ用語が複数の同義語グループに存在する | clear() 後に addRange() を使用して重複するグループを統合します。 |
よくある質問
Q: GroupDocs.Search を使用するための最小システム要件は何ですか?
A: 互換性のある JDK(Java 8 以上)を搭載した最新の OS であれば十分です。
Q: 同義語辞書はどの頻度で更新すべきですか?
A: 新しい用語が出たら随時更新してください。クリーンなリフレッシュには clear() の後に addRange() を使用します。
Q: ライセンスを購入せずに GroupDocs.Search を実行できますか?
A: 評価目的であれば無料トライアルで動作しますが、本番環境での使用にはライセンスが必要です。
Q: 大規模データセットをインデックス化するベストプラクティスは何ですか?
A: データを論理的なバッチに分割し、ヒープ使用量を監視し、定期的なインデックスメンテナンスをスケジュールします。
Q: 期待した同義語の一致が見られません—何を確認すべきですか?
A: 辞書が正しくインポートされているか、setUseSynonymSearch(true) が有効か、用語が同義語グループに存在するかを確認してください。
リソース
- Documentation
- API Reference
- Download GroupDocs.Search for Java
- GitHub Repository
- Free Support Forum
- Temporary License Acquisition
最終更新日: 2026-10-17
テスト環境: GroupDocs.Search 25.4 for Java
作者: GroupDocs