반환할 문서 지정

개요

이 가이드에서는 다음 메서드를 사용하여 읽기 작업에서 반환할 문서를 지정하는 방법을 배울 수 있습니다.

• 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() 메서드는 정렬 방향을 매개 변수로 사용합니다. 정렬 방향을 지정하려면 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() 메서드를 호출하고 건너뛸 문서 수를 전달합니다. skip() 메서드는 쿼리 결과에서 지정된 수의 문서를 무시하고 나머지를 반환합니다.

다음 예에서는 cuisine 필드 값이 "Italian" 인 모든 문서를 반환하고 처음 10 문서를 건너뜁니다.

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

제한, 정렬 및 건너뛰기 결합

단일 작업으로 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)
}

추가 정보

쿼리 지정에 대한 자세한 내용은 쿼리 지정을 참조하세요.

문서 조회에 대한 자세한 내용은 데이터 조회를 참조하세요.