GroupDocs.Search を使用した Java でフォルダーをインデックスに追加する方法
何百万ものドキュメントにスケールできる java full text search が必要な場合、ここが適切な場所です。
このチュートリアルでは、GroupDocs.Search を使用して add folder to index を行い、高圧縮ストレージを設定し、超高速クエリを実行する方法を学びます。最後まで読むと、任意の Java プロジェクトに組み込める本番環境向けソリューションが手に入ります。
クイック回答
- 主要なライブラリは何ですか? GroupDocs.Search for Java
- フォルダーをインデックスに追加する方法は? Use
index.add(folderPath) - テキスト圧縮を設定できますか? Yes, via
TextStorageSettings(Compression.High) - 必要な Java バージョンはどれですか? JDK 8 or higher
- トライアルライセンスはどこで取得できますか? From the GroupDocs website or the repository page
java full text search とは何か、そしてなぜ重要なのか
Java full text search は、生のドキュメントを逆インデックスに変換し、数千ファイルにわたる任意の用語をサブ秒で取得できるようにします。この機能は、ユーザーが即時の結果を期待する法務リポジトリ、研究図書館、エンタープライズナレッジベースに不可欠です。また、最新のアプリケーションの生産性も向上させます。
Java のフルテキスト検索に groupdocs.search を使用する理由
GroupDocs.Search は、高スループットのインデックス作成とクエリ実行を提供し、組み込みの高圧縮も備えています。50+ input and output formats(PDF、DOCX、EML、HTML など)をサポートし、ファイル全体をメモリに読み込むことなく数百ページのドキュメントを処理でき、典型的なワークロードでメモリ使用量を 200 MB 未満に抑えます。
前提条件
- GroupDocs.Search for Java (version 25.4 or later) – インデックス作成と検索を支えるコアライブラリです。
- JDK 8+ がインストールされ設定済み – SDK に必要な最小ランタイムです。
- Maven(依存関係管理) – ライブラリのプロジェクトへの追加を簡素化します。
- IntelliJ IDEA や Eclipse などの IDE – Java コードの作成とデバッグに使用します。
GroupDocs.Search の設定(Java)
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>
直接ダウンロード
あるいは、最新バージョンを GroupDocs.Search for Java releases からダウンロードしてください。
ライセンス取得
- Free trial – コミットせずにすべての機能を試せます。
- Temporary license – テスト期間を延長できます。
- Purchase – 本番環境のすべての機能を利用可能にします。
基本的な初期化と設定
Index は、検索インデックスの作成、オープン、管理に使用されるコアクラスです。
import com.groupdocs.search.Index;
public class InitializeSearch {
public static void main(String[] args) {
// Path to store index data
String indexPath = "path/to/index";
// Creating an index at specified location
Index index = new Index(indexPath);
System.out.println("GroupDocs.Search initialized successfully!");
}
}
カスタム圧縮でテキストをインデックス化
手順 1: インデックスフォルダーを定義する
インデックスファイルが格納されるディレクトリを選択します:
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";
手順 2: インデックス設定を構成する
TextStorageSettings は、圧縮レベルを含むテキストのインデックス内での保存方法を設定します。Compression は、目的の圧縮アルゴリズムを指定する列挙型です。
import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
手順 3: カスタム設定でインデックスを作成する
上記で定義した設定を使用してインデックスをインスタンス化します:
Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");
フォルダーをインデックスに追加する方法
Index は検索可能なインデックスを表す主要クラスです。
既存のインデックスをロード(または新規作成)し、Index オブジェクトの add メソッドを呼び出します。add 操作は指定されたディレクトリをスキャンし、サポートされている各ファイルからテキストを抽出し、圧縮インデックスに保存して即時検索が可能になります。
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);
インデックス化されたドキュメントを検索する方法
SearchResult は、ドキュメントパスと関連度を含む単一のマッチを表します。
検索したい用語またはフレーズを表す検索クエリ文字列を定義し、Index インスタンスの search メソッドを呼び出します。このメソッドは SearchResult オブジェクトのコレクションを返し、各オブジェクトはドキュメントパス、関連度スコア、およびマッチ部分をハイライトしたスニペットを含みます。
index.add(documentsFolder);
System.out.println("Documents added successfully.");
実用的な応用例
Real‑world scenarios where java full text search shines:
- Legal document management – ケースファイルの即時取得。
- Academic research libraries – 論文や学位論文の高速検索。
- Enterprise knowledge bases – マニュアルや FAQ への迅速なアクセス。
- Content management systems – 大規模サイト向けの効率的なコンテンツ検索。
- Customer service archives – 過去のチケットやチャットの高速検索。
パフォーマンス上の考慮点
- Compression vs. speed: 高圧縮は最大 70 % のディスク容量を節約しますが、インデックス作成のオーバーヘッドがやや増加します。データ量に対してベンチマークテストを実行してください。
- Memory management: 10 GB を超えるインデックスには少なくとも 2 GB のヒープを割り当て、
OutOfMemoryErrorを回避してください。 - Index updates:
index.add()で新しいドキュメントを増分的に追加し、定期的にindex.optimize()を呼び出してインデックスをコンパクトに保ちます。 - Query optimization: 高度なクエリ構文(ワイルドカード、近接検索、ファジー検索)を使用して結果を絞り込み、応答時間を短縮します。
よくある落とし穴とプロのコツ
Pitfall: 大量追加後に
index.optimize()を呼び出し忘れること。
Pro tip: インデックスをコンパクトに保つため、毎晩index.optimize()を実行してください。Pitfall: 大規模データセットでデフォルト(低)圧縮を使用すること。
Pro tip: 本番環境ではCompression.Highに切り替えてストレージコストを削減してください。Pitfall: ネットワーク共有からファイルを追加する際に
IOExceptionを処理しないこと。
Pro tip:index.add()を try‑catch ブロックでラップし、失敗をログに記録して後で確認できるようにしてください。
よくある質問
Q: GroupDocs.Search とは何ですか?
A: 高度なフルテキスト検索機能(インデックス作成、圧縮、複雑なクエリサポート)を提供する堅牢な Java ライブラリです。
Q: 大規模データセットを GroupDocs.Search でどのように扱いますか?
A: Compression.High を有効にし、定期的に変更をコミットしてインデックスを軽量に保ちます。また、十分なヒープメモリを割り当てます(例:20 GB 超のインデックスには 4 GB)。
Q: 既存のエンタープライズシステムに GroupDocs.Search を統合できますか?
A: はい、任意の Java ベースのバックエンド、REST サービス、マイクロサービスアーキテクチャに組み込むことが可能です。
Q: インデックスが古くなった場合はどうすればよいですか?
A: 新しいファイルを追加するには index.add()、不要なファイルを削除するには index.delete() を使用し、必要に応じて index.optimize() を再実行してください。
Q: サポートやヘルプはどこで得られますか?
A: トラブルシューティングやベストプラクティスのヒントは、GroupDocs forums のコミュニティフォーラムをご覧ください。
追加リソース
- 詳細な使用ガイド: GroupDocs Search Documentation
- 完全な API リファレンス: API Reference Guide
- 新機能の最新情報を入手: Latest Releases
最終更新日: 2026-11-02
テスト対象: GroupDocs.Search 25.4
作者: GroupDocs
String query = "sample";
import com.groupdocs.search.results.SearchResult;
SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());