Especifica los documentos a devolver

Overview

En esta guía, puede aprender a especificar qué documentos devolver de una operación de lectura encadenando los siguientes métodos a la find() :

• limit(): especifica el número máximo de documentos que se devolverán de una consulta

• sort(): Especifica el orden de clasificación para los documentos devueltos

• skip(): especifica la cantidad de documentos que se deben omitir antes de devolver los resultados de la consulta

val database: MongoDatabase = mongoClient.getDatabase("sample_restaurants")
val collection: MongoCollection[Document] = database.getCollection("restaurants")

Limit

Para especificar el número máximo de documentos devueltos en una operación de lectura, utilice el método limit() de la clase FindObservable. Después de llamar al método find(), encadene el método limit() para modificar el comportamiento de la operación.

El siguiente ejemplo encuentra todos los restaurantes que tienen un valor de campo cuisine de "Italian" y limita los resultados a 5 documentos:

val filter = equal("cuisine", "Italian")
collection.find(filter).limit(5).subscribe((doc: Document) => println(doc.toJson()),
                            (e: Throwable) => println(s"There was an error: $e"))

{"_id": {"$oid": "..."}, ... , "name": "Isle Of Capri Resturant", "restaurant_id": "40364373"}
{"_id": {"$oid": "..."}, ... , "name": "Marchis Restaurant", "restaurant_id": "40364668"}
{"_id": {"$oid": "..."}, ... , "name": "Crystal Room", "restaurant_id": "40365013"}
{"_id": {"$oid": "..."}, ... , "name": "Forlinis Restaurant", "restaurant_id": "40365098"}
{"_id": {"$oid": "..."}, ... , "name": "Angelo Of Mulberry St.", "restaurant_id": "40365293"}

Sort

Para devolver los documentos en un orden específico, utilice el método sort() de la clase FindObservable. Después de llamar al método find(), encadene el método sort() para modificar el comportamiento de la operación.

Al llamar a sort(), pase el campo por el que se ordenarán los resultados y la dirección de ordenación. Puede usar el método ascending() para ordenar los valores de menor a mayor, o el método descending() para ordenarlos de mayor a menor.

El siguiente ejemplo devuelve todos los documentos que tienen un valor de campo cuisine de "Italian", ordenados en orden ascendente de valores de campo name:

val filter = equal("cuisine", "Italian")
collection.find(filter).sort(ascending("name")).subscribe((doc: Document) => println(doc.toJson()),
                            (e: Throwable) => println(s"There was an error: $e"))

{"_id": {"$oid": "..."}, ... , "name": "44 Sw Ristorante & Bar", "restaurant_id": "40698807"}
{"_id": {"$oid": "..."}, ... , "name": "900 Park", "restaurant_id": "41707964"}
{"_id": {"$oid": "..."}, ... , "name": "A Voce", "restaurant_id": "41434084"}
...
{"_id": {"$oid": "..."}, ... , "name": "Zucchero E Pomodori", "restaurant_id": "41189590"}

Omitir

Para omitir un número específico de documentos antes de devolver los resultados de la consulta, utilice el método skip() de la clase FindObservable. Después de llamar al método find(), encadene el método skip() para modificar el comportamiento de la operación.

El siguiente ejemplo devuelve todos los documentos que tienen un valor de campo borough de "Manhattan" y omite los primeros 10 documentos:

val filter = equal("borough", "Manhattan")
collection.find(filter).skip(10).subscribe((doc: Document) => println(doc.toJson()),
                            (e: Throwable) => println(s"There was an error: $e"))

{"_id": {"$oid": "..."}, ... , "name": "Cafe Metro", "restaurant_id": "40363298"}
{"_id": {"$oid": "..."}, ... , "name": "Lexler Deli", "restaurant_id": "40363426"}
{"_id": {"$oid": "..."}, ... , "name": "Domino'S Pizza", "restaurant_id": "40363644"}
...

Combinar límite, ordenar y omitir

Puede encadenar los métodos limit(), sort() y skip() a una sola llamada al método find(). Esto le permite establecer un número máximo de documentos ordenados que se devolverán de la operación de lectura, omitiendo un número específico de documentos antes de devolverlos.

El siguiente ejemplo devuelve 5 documentos cuyo valor cuisine es "Italian". Los resultados se ordenan en orden ascendente según el valor del campo name, omitiendo los primeros 10 documentos:

val filter = equal("cuisine", "Italian")
collection.find(filter)
          .limit(5)
          .skip(10)
          .sort(ascending("name"))
          .subscribe((doc: Document) => println(doc.toJson()),
                    (e: Throwable) => println(s"There was an error: $e"))

{"_id": {"$oid": "..."}, ... , "name": "Acqua", "restaurant_id": "40871070"}
{"_id": {"$oid": "..."}, ... , "name": "Acqua Restaurant", "restaurant_id": "41591488"}
{"_id": {"$oid": "..."}, ... , "name": "Acqua Santa", "restaurant_id": "40735858"}
{"_id": {"$oid": "..."}, ... , "name": "Acquista Trattoria", "restaurant_id": "40813992"}
{"_id": {"$oid": "..."}, ... , "name": "Acquolina Catering", "restaurant_id": "41381423"}

Información Adicional

Para obtener más información sobre cómo recuperar documentos, consulte la Guíade recuperación de datos.

Para obtener más información sobre cómo especificar una consulta, consulte la guía Especificar una consulta.