ドキュメントの検索

サンプル データ

このガイドの例では、Atlas サンプル データセットの sample_restaurants データベースの restaurants コレクションを使用します。無料の MongoDB 配置を作成し、サンプルデータセットを読み込む方法については、MongoDB の スタートガイドを参照してください。

このコレクション内のドキュメントは、次の Kotlin データ クラスによってモデル化されます。

data class Restaurant(
    val name: String,
    val cuisine: String
)

1 ドキュメントの特定の例

次の例では、first() メソッドを find() メソッド呼び出しに連鎖させて、cuisineフィールドの値が "Spanish" である最初のドキュメントを検索します。

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish")).first()

前述の例の find()操作では、次の例に示すように、印刷可能なMongoDBドキュメントが返されます。

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish")).first()
println(results)

Restaurant(name=Tropicoso Club, cuisine=Spanish)

ドキュメントの検索の例

次の例では、 find()メソッドを使用して、 cuisineフィールドの値が"Spanish"であるすべてのドキュメントを検索します。

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish"))

前述の例のfind()操作はFindIterableオブジェクトを返します。このオブジェクトは、次の例に示すように、 forEach()メソッドを使用して反復処理できます。

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish"))
results.forEach { result ->
    println(result)
}

Restaurant(name=Tropicoso Club, cuisine=Spanish)
Restaurant(name=Beso, cuisine=Spanish)
Restaurant(name=Sabor Latino Restaurant, cuisine=Spanish)
...

val results = collection.find()

検索動作の変更

find()メソッド呼び出しにメソッドを連鎖させることで、 find()メソッドの動作を変更できます。 次の表では、クエリの変更に使用される一般的な方法について説明しています。

次の例では limit() メソッドを連鎖させて、クエリによって返されるドキュメントの数を 10 に制限します。

val results = collection
    .find(eq(Restaurant::cuisine.name, "Spanish"))
    .limit(10)

の動作を変更するメソッドの完全なリストについては、find() クラスのAPIドキュメントを参照してください FindIterable。

API ドキュメント

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。

• find()

• FindIterable