カーソルからデータにアクセスする

最初に

クエリ結果の最初のドキュメントを取得するには、 first()メソッドを使用します。

FindIterable<Document> iterable = collection.find();
System.out.println(iterable.first());

このメソッドは、一意なインデックスでフィルタリングする場合など、クエリフィルターが 1 つのドキュメントと一致する場合によく使用されます。

結果の数

ブロックせずにローカルに存在する結果の数を取得するには、 available()メソッドを使用します。

MongoCursor<Document> cursor = collection.find().cursor();
System.out.println(cursor.available());

このメソッドは、アプリケーションがカーソル内のすべてのドキュメントをすでに反復処理している場合、またはカーソルが閉じている場合は0を返します。

into

クエリ結果をListに保存するには、 into()メソッドを使用します。

List<Document> results = new ArrayList<>();
FindIterable<Document> iterable = collection.find();
iterable.into(results);
System.out.println(results);

この方法は、クエリフィルターが、使用可能なメモリに収まる少数のドキュメントを返す場合によく使用されます。

Cursor

cursor()メソッドを使用して、取得されたドキュメントを反復処理し、早期終了が発生した場合にはカーソルが閉じられるようにします。

MongoCursor<Document> cursor = collection.find().cursor();

カーソルが閉じられるようにする方法の詳細については、「カーソルのクリーンアップ 」セクションを参照してください。

explain

MongoDB が操作を実行する方法に関する情報を表示するには、 explain()メソッドを使用します。

explain()メソッドは実行プランとパフォーマンス統計を返します。 実行プランは、MongoDB が操作を完了できる潜在的な方法です。 explain()メソッドは、当選プラン（MongoDB が実行されたプラン）と拒否されたプランの両方を提供します。

explain() メソッドに冗長レベルを渡すことで、説明の詳細度を指定できます。

次のテーブルには、説明のすべての冗長レベルとそのユースケースが示されています。

次の例では、実行プランを生成する集計ステージの勝利プランの JSON 表現を出力します。

Document explanation = collection.find().explain(ExplainVerbosity.EXECUTION_STATS);
List<String> keys = Arrays.asList("queryPlanner", "winningPlan");
System.out.println(explanation.getEmbedded(keys, Document.class).toJson());

上記のコード スニペットでは、次の出力が生成されます。

{ "stage": "COLLSCAN", "direction": "forward" }

explain 操作の詳細については、次のサーバー マニュアル エントリを参照してください。

• Explain の出力

• クエリプラン

このセクションで説明されるメソッドとクラスの詳細については、次の API ドキュメントを参照してください。

• first()

• available()

• into()

• cursor()

• explain()

• ExplainVerbosity

関数の反復

FindIterableのforEach()メソッドに関数を渡して、関数スタイルの結果を反復処理します。

FindIterable<Document> iterable = collection.find();
iterable.forEach(doc -> System.out.println(doc.toJson()));

for (Document cursor : collection.find()) {
   ...
}

条件付き反復

hasNext()メソッドを使用してカーソルで使用可能なドキュメントがあるかどうかを確認し、 next()メソッドを使用してカーソルから次の使用可能なドキュメントを取得します。

MongoCursor<Document> cursor = collection.find().cursor();
while (cursor.hasNext()){
    System.out.println(cursor.next().toJson());
}

このセクションで説明されるメソッドとクラスの詳細については、次の API ドキュメントを参照してください。

• forEach()

• hasNext()

• next()

閉じる

クライアント アプリケーションと MongoDB 配置の両方でカーソルがリソースを消費するのを解放するには、 finallyブロックのclose()メソッドを使用します。

MongoCursor<Document> cursor = collection.find().cursor();
try {
    while (cursor.hasNext()){
        System.out.println(cursor.next().toJson());
    }
} finally {
    cursor.close();
}

リソース ステートメントで試す

リソースの試行 ステートメントを使用して、クライアント アプリケーションと MongoDB 配置の両方でカーソルがリソースを消費するリソースを自動的に解放します。

try(MongoCursor<Document> cursor = collection.find().cursor()) {
    while (cursor.hasNext()){
        System.out.println(cursor.next().toJson());
    }
}

このセクションで説明されるメソッドとクラスの詳細については、次の API ドキュメントを参照してください。

• close()

• リソース ステートメント