返すドキュメントを指定する

Overview

このガイドでは、次のメソッドを使用して、読み取り操作から返されるドキュメントを指定する方法を学習できます。

• limit(): クエリから返されるドキュメントの最大数を指定します

• sort(): 返されるドキュメントのソート順序を指定します

• skip(): クエリ結果を返す前にスキップするドキュメントの数を指定します

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

Limit

読み取り操作から返されるドキュメントの最大数を指定するには、 limit()メソッドを呼び出します。

次の例では、 cuisineフィールドの値が"Italian"であるすべてのレストランを検索し、結果を5ドキュメントに制限します。

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

Sort

指定した順序でドキュメントを返すには、 sort()メソッドを呼び出します。 sort()メソッドは、並べ替え方向をパラメーターとして受け取ります。 並べ替え方向を指定するには、Sorts.ascending() Sorts.descending()メソッドまたは メソッドを使用します。Sorts.ascending()メソッドは値を最低から最高の順にソートし、 Sorts.descending()メソッドは値を最高から最低の順にソートします。 並べ替え方向を指定しない場合、 sort()はドキュメントを昇順で返します。

次の例では、cuisine フィールドの値が"Italian" であるすべてのドキュメントを、name フィールドの値で昇順にソートして返します。

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

スキップ

クエリ結果を返す前に指定した数のドキュメントをスキップするには、 skip()メソッドを呼び出して、スキップするドキュメント数を渡します。 skip()メソッドは、クエリ結果内の指定された数のドキュメントを無視し、残りを返します。

次の例では、 cuisineフィールドの値が"Italian"であるすべてのドキュメントを返し、最初の10ドキュメントをスキップします。

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

制限、ソート、スキップの組み合わせ

1 回の操作で、 limit() 、 sort() 、 skip()メソッドを組み合わせることができます。 これにより、返されるソートされたドキュメントの最大数を設定して、返される前に指定された数のドキュメントをスキップできます。

次の例では、 cuisineの フィールド値が"Italian"であるドキュメントを返します。 結果はアルファベット順にソートされ、最初の10ドキュメントをスキップし、結果を5ドキュメントに限定します。

val results = collection
    .find(eq(Restaurant::cuisine.name, "Italian"))
    .sort(Sorts.ascending(Restaurant::name.name))
    .skip(10)
    .limit(5)
results.forEach { result ->
    println(result)
}

詳細情報

クエリの指定の詳細については、 「 クエリの指定 」を参照してください。

ドキュメントの取得の詳細については、「データの取得 」を参照してください。