ドキュメントの検索

サンプル データ

このガイドの例では、Atlas のサンプルデータセットから、sample_mflixデータベースのmoviesコレクションを使用します。MongoDB Atlasクラスターを無料で作成して、サンプルデータセットをロードする方法については、ガイドを参照してください。

次の Kotlin データ クラスは、このコレクション内のドキュメントをモデル化します。

data class Movie(val title: String, val runtime: Int, val imdb: IMDB){
    data class IMDB(val rating: Double)
}

次のKotlinデータクラスは、このガイドの例によって返された結果をモデル化します。

data class Results(val title: String)

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

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

val projectionFields= Projections.fields(
    Projections.include(Movie::title.name, Movie::imdb.name),
    Projections.excludeId()
)
val resultsFlow = collection.withDocumentClass<Results>()
    .find(eq(Movie::title.name, "The Room"))
    .projection(projectionFields)
    .firstOrNull()
if (resultsFlow == null) {
    println("No results found.");
} else {
    println(resultsFlow)
}

Movie(title=The Room, runtime=99, imdb=IMDB(rating=3.7))

ドキュメントの検索の例

この例では、find() メソッドを使用して、runtimeフィールドの値が 15 より小さいすべてのドキュメントを検索します。find()操作はFindFlowオブジェクトを返します。このオブジェクトは、次の例に示すように、collect() メソッドを使用して反復処理できます。

val projectionFields= Projections.fields(
    Projections.include(Movie::title.name, Movie::imdb.name),
    Projections.excludeId()
)
val resultsFlow = collection.withDocumentClass<Results>()
    .find(lt(Movie::runtime.name, 15))
    .projection(projectionFields)
resultsFlow.collect { println(it) }

Movie(title=Meshes of the Afternoon, runtime=14, imdb=IMDB(rating=8.0))
Movie(title=The Band Concert, runtime=9, imdb=IMDB(rating=7.9))
Movie(title=What's Opera, Doc?, runtime=7, imdb=IMDB(rating=8.3))
...

val resultsFlow = collection.withDocumentClass<Results>()
    .find()

検索動作の変更

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

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

val projectionFields= Projections.fields(
    Projections.include(Movie::title.name, Movie::imdb.name),
    Projections.excludeId()
)
val resultsFlow = collection.withDocumentClass<Results>()
    .find()
    .projection(projectionFields)
    .limit(10)

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

API ドキュメント

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

• MongoCollection.find()

• FindFlow