JavaでGroupDocs.Searchを使用して形態を生成する方法

このガイドでは、GroupDocs.Search API を使用して Javaで形態を生成する方法 を学びます。カスタム word‑forms プロバイダーを作成することで、検索またはテキスト分析エンジンが用語のすべてのバリエーション（「cat」「cats」「city」「citis」など）を認識できるようになります。これにより、リコールが大幅に向上し、精度は高いまま保たれます。

クイック回答

  • word forms プロバイダーは何をするものですか？ 与えられた単語の代替形（単数形、複数形など）を生成し、検索がすべてのバリエーションに一致できるようにします。
  • どのライブラリが必要ですか？ GroupDocs.Search for Java (version 25.4 or newer)。
  • ライセンスは必要ですか？ 無料トライアルは評価に使用できますが、本番環境では永続的なライセンスが必要です。
  • サポートされている Java バージョンは何ですか？ JDK 8 以上。
  • 必要なコード行数はどれくらいですか？ シンプルなプロバイダー実装で約30行です。

「create word forms provider」機能とは何ですか？

A create word forms provider は IWordFormsProvider を実装するカスタムクラスです。IWordFormsProvider はプロバイダーが検索エンジンに代替単語形を提供する方法を定義するインターフェイスです。単語を受け取り、定義したルールに基づいて可能な形（単数形、複数形、その他の言語的変形）の配列を返します。これにより、検索インデックスは「cat」と「cats」を同等とみなすことができ、精度を犠牲にせずリコールが向上します。

なぜ GroupDocs.Search を word‑form 生成に使用するのか？

GroupDocs.Search は組み込みの拡張性を提供し、独自のプロバイダーをインデックス作成パイプラインに直接組み込むことができます。ストリーミングアーキテクチャにより、メモリ使用量を 500 MB 未満に抑えながら、最大 10 million documents のインデックスを処理でき、結果をキャッシュしてサブミリ秒の検索時間を実現できます。

前提条件

  • Maven がインストールされ、JDK 8 以上がマシンに設定されていること。
  • Java 開発と Maven の pom.xml 設定に基本的な知識があること。
  • GroupDocs.Search Java ライブラリ（バージョン 25.4 以上）へのアクセス。

Java 用 GroupDocs.Search の設定

Maven 設定

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>

直接ダウンロード

あるいは、公式リリースページから最新の JAR をダウンロードしてください: GroupDocs.Search for Java releases。

ライセンス取得手順

  1. Free trial: コア機能を試すためにトライアルにサインアップします。
  2. Temporary license: 拡張テスト用に一時キーをリクエストします。
  3. Purchase: 制限のない本番利用のために商用ライセンスを取得します。

基本的な初期化と設定

以下のスニペットは、インデックスを作成する方法を示しています。これは、ドキュメントと word‑form ロジックを追加する出発点です。

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Initialize an index
        Index index = new Index("path/to/index");
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

実装ガイド

以下では、シンプルな単数形から複数形、複数形から単数形への変換を処理する create a word forms provider の手順を説明します。

SimpleWordFormsProvider の実装

概要

SimpleWordFormsProvider クラスは IWordFormsProvider を実装します。定義アンカーはその目的を明確にします：

SimpleWordFormsProvider はインデックスエンジン向けに単数‑複数の変形を提供する IWordFormsProvider のカスタム実装です。

Step 1 – クラスの骨格を作成

IWordFormsProvider を実装するクラスを定義することから始めます。import 文は変更しないでください：

import com.groupdocs.search.dictionaries.IWordFormsProvider;
import java.util.ArrayList;

public class SimpleWordFormsProvider implements IWordFormsProvider {

Step 2 – getWordForms を実装

可能な形のリストを構築するメソッドを追加します。このブロックはコアロジックを含んでおり、後でより複雑なルールに拡張できます。

getWordForms は用語を受け取り、生成されたすべての変形を含む String[] を返します。

    @Override
    public final String[] getWordForms(String word) {
        // Initialize a list to store generated word forms
        ArrayList<String> result = new ArrayList<>();

        // Singular form for words ending in 'es'
        if (word.length() > 2 && word.toLowerCase().endsWith("es")) {
            result.add(word.substring(0, word.length() - 2));
        }

        // Singular form for words ending in 's'
        if (word.length() > 1 && word.toLowerCase().endsWith("s")) {
            result.add(word.substring(0, word.length() - 1));
        }

        // Plural form by replacing 'y' with 'is'
        if (word.length() > 1 && word.toLowerCase().endsWith("y")) {
            result.add(word.substring(0, word.length() - 1).concat("is"));
        }

        // Basic plural forms
        result.add(word.concat("s"));
        result.add(word.concat("es"));

        // Convert list to array and return
        return result.toArray(new String[0]);
    }
}

ロジックの説明

  • Singularization: 一般的な複数形サフィックス（es、s）を検出し、基本語を推測するために削除します。
  • Pluralization: y で終わる名詞を is に置き換えて処理します。これは多くの英語単語で機能するシンプルなルールです。
  • Suffix appending: 以前のチェックで捕捉できない通常の複数形をカバーするために s と es を付加します。

トラブルシューティングのヒント

  • Case sensitivity: メソッドは比較のために toLowerCase() を使用し、“Cats” と “cats” が同じように扱われることを保証します。
  • Edge cases: サフィックスの長さ未満の単語は空文字列が返らないように無視されます。
  • Performance: 大規模な語彙の場合、結果を ConcurrentHashMap にキャッシュすることを検討してください。

実用的な応用例

create word forms provider を実装することで、いくつかの実際のシナリオを向上させることができます：

  1. Search engines: ユーザーが “mouse” と入力した場合でも “mice” を含む文書が見つかるべきです。プロバイダーはこのような不規則形を生成できます。
  2. Text analysis tools: すべての単語バリエーションが認識されることで、感情分析やエンティティ抽出がより信頼性を持ちます。
  3. Content management systems: 自動タグ生成に複数形の同義語を含めることで、SEO と内部リンクが向上します。

パフォーマンス上の考慮点

プロバイダーを本番システムに組み込む際は、以下の点に留意してください：

  • Cache frequently used forms: 同じ単語の再計算を避けるために結果をメモリに保存します。
  • Monitor JVM heap: 大規模インデックスはメモリ圧力を高める可能性があるため、-Xmx を適切に調整してください。
  • Use efficient collections: 小規模セットには ArrayList が機能しますが、数千の形態には重複を迅速に排除するために HashSet の使用を検討してください。

ベストプラクティス

  • ライブラリを最新に保ち、パフォーマンスパッチの恩恵を受けましょう。
  • 現実的なクエリ負荷でプロバイダーをプロファイルし、ボトルネックを早期に発見します。

結論

これで、GroupDocs.Search とカスタム SimpleWordFormsProvider を使用して Javaで形態を生成する方法 を学びました。この軽量コンポーネントは、検索結果の関連性と多くのアプリケーションにおける言語解析の精度を劇的に向上させることができます。

次のステップ

  • より高度な言語規則（不規則複数形、ステミング）を試してみてください。
  • プロバイダーをインデックスパイプラインに統合し、リコールの向上を測定します。
  • 同義語辞書やカスタムアナライザーなど、他の GroupDocs.Search 機能も探求してください。

Call to action: SimpleWordFormsProvider を今日自分のプロジェクトに追加して、検索体験がどれだけ向上するかをご確認ください！

FAQ セクション

Q: GroupDocs.Search for Java とは何ですか？
A: フルテキスト検索、インデックス作成、言語機能を提供する強力なライブラリで、カスタム word‑form プロバイダーを組み込む機能も含まれます。

Q: SimpleWordFormsProvider はどのように機能しますか？
A: 簡単なサフィックスベースのルール（“s/es” の除去、“y” を “is” に変換、そして “s/es” を付加）を適用して代替形を生成します。

Q: 単語形生成ルールをカスタマイズできますか？
A: もちろんです。getWordForms メソッドを変更して、不規則形、ロケール固有のルール、または外部辞書との統合を含めることができます。

Q: この機能の一般的な用途は何ですか？
A: 検索エンジン、テキスト分析パイプライン、CMS プラットフォームは、単数形/複数形のバリエーションを認識することで利益を得ます。

Q: 本番利用には商用ライセンスが必要ですか？
A: はい。トライアルで API を試すことはできますが、購入したライセンスは使用制限を解除し、サポートを提供します。

最終更新日: 2026-09-02
テスト環境: GroupDocs.Search 25.4 (Java)
作者: GroupDocs

関連チュートリアル