Ordenar resultados

Overview

En esta guía, puede aprender a utilizar la operación de clasificación para ordenar los resultados de las operaciones de lectura con el controlador Java de MongoDB.

La operación de ordenamiento ordena los documentos devueltos por tu consulta según tus criterios de clasificación especificados. Los criterios de ordenación son las reglas que se pasan a MongoDB y que describen cómo se quiere ordenar los datos. Algunos ejemplos de criterios de ordenación son:

• Del número más pequeño al número más grande

• Hora más temprana del día a hora más tardía del día

• Orden alfabético por nombre

Deberías leer esta guía si deseas:

• Realizar ordenaciones ascendentes y descendentes.

• Combinar criterios de clasificación.

• Ordenar por puntuación de texto de un consulta de texto.

Los ejemplos de esta guía utilizan una colección de muestra que contiene los siguientes documentos:

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 6, "letter": "c", "food": "maple donut"}

Métodos de clasificación

Puede ordenar los resultados obtenidos por una consulta y dentro de una canalización de agregación. Para ordenar los resultados de su consulta, utilice el sort() Método de una FindIterable instancia. Para ordenar los resultados dentro de una canalización de agregación, utilice el Aggregates.sort() método de fábrica estático. Ambos métodos reciben objetos que implementan la Bson interfaz como argumentos. Para más información, consulte nuestra documentación de la API para la interfaz BSON.

Puede utilizar el método sort() de una instancia FindIterable de la siguiente manera:

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("_id"));

Puedes usar el método Aggregates.sort() dentro de un pipeline de agregación de la siguiente manera:

import com.mongodb.client.model.Aggregates;
import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.aggregate(Arrays.asList(Aggregates.sort(ascending("_id"))));

Los fragmentos de código anteriores ordenan los documentos de la colección de muestra del valor más pequeño al más grande del _id campo:

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
...

En los fragmentos de código anteriores, especificamos nuestros criterios de ordenación mediante la clase constructora Sorts. Si bien es posible especificar criterios de ordenación mediante cualquier clase que implemente la interfaz Bson, recomendamos especificarlos mediante la clase constructora Sorts. Para obtener más información sobre la clase constructora Sorts, consulte nuestra Guía sobre el constructor de ordenamientos.

Para obtener más información sobre las clases e interfaces en esta sección, consulte la siguiente documentación de API:

• FindIterable

• Agregados

• Ordena

• BSON

• Documento

Dirección de clasificación

La dirección de ordenación puede ser ascendente o descendente.La ordenación ascendente ordena los resultados de menor a mayor. La ordenación descendente ordena los resultados de mayor a menor.

A continuación se muestran algunos ejemplos de datos ordenados en orden ascendente:

• Numbers: 1, 2, 3, 43, 43, 55, 120

• Dates: 1990-03-10, 1995-01-01, 2005-10-30, 2005-12-21

• Palabras (ASCII): plátano, eneldo, zanahoria, pepino, hummus

A continuación se muestran algunos ejemplos de datos ordenados en orden descendente:

• Numbers: 100, 30, 12, 12, 9, 3, 1

• Dates: 2020-01-01, 1998-12-11, 1998-12-10, 1975-07-22

• Palabras (ASCII inverso): pera, uvas, manzana, queso

Las siguientes subsecciones muestran cómo especificar estos criterios de clasificación.

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("<field name>"));

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
List<Document> results = new ArrayList<>();
collection.find().sort(ascending("_id")).into(results);
for (Document result : results) {
      System.out.println(result.toJson());
}

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
...

import static com.mongodb.client.model.Sorts.descending;
// <MongoCollection setup code here>
collection.find().sort(descending("_id"));

{"_id": 6, "letter": "c", "food": "maple donut"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
...

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("letter"));

{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("letter", "_id"));

{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 6, "letter": "c", "food": "maple donut"}

import static com.mongodb.client.model.Sorts.orderBy;
import static com.mongodb.client.model.Sorts.ascending;
import static com.mongodb.client.model.Sorts.descending;
// <MongoCollection setup code here>
Bson orderBySort = orderBy(descending("letter"), ascending("_id"));
collection.find().sort(orderBySort);

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 6, "letter": "c", "food": "maple donut"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}

Consulta de texto

Puede especificar el orden de los resultados de una consulta de texto según la coincidencia entre los valores de cadena de los campos de cada resultado, especificados por el índice de texto de la colección, y la cadena de búsqueda. La consulta de texto asigna una puntuación numérica para indicar la coincidencia de cada resultado con la cadena de búsqueda. Utilice el Sorts.metaTextScore() método de fábrica estático para crear sus criterios de ordenación y ordenar por puntuación de texto.

En el siguiente ejemplo de código, mostramos cómo usar el Sorts.metaTextScore() método para ordenar los resultados de una búsqueda de texto en la colección de muestra. El ejemplo utiliza los constructores Filtros, Índices y Proyecciones. Realiza las siguientes acciones:

1. Crea un índice de texto para su colección de muestras en el food campo. Si llama a createIndex() especificando un índice ya existente en la colección, la operación no crea un nuevo índice.

2. Ejecuta tu query de texto para la frase "maple donut".

3. Proyecta puntuaciones de texto en los resultados de tu consulta como el campo score.

4. Ordena los resultados por puntuación de texto (primero la mejor coincidencia).

import com.mongodb.client.model.Sorts;
import com.mongodb.client.model.Projections;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.Indexes;
// <MongoCollection setup code here>
collection.createIndex(Indexes.text("food"));
Bson metaTextScoreSort = Sorts.metaTextScore("score");
Bson metaTextScoreProj = Projections.metaTextScore("score");
String searchTerm = "maple donut";
Bson searchQuery = Filters.text(searchTerm);
collection.find(searchQuery)
         .projection(metaTextScoreProj)
         .sort(metaTextScoreSort)
         .into(results);
for (Document result : results) {
      System.out.println(result.toJson());
}

La salida del código anterior se parece a la siguiente:

{"_id": 6, "letter": "c", "food": "maple donut", "score": 1.5}
{"_id": 2, "letter": "a", "food": "donuts and coffee", "score": 0.75}
{"_id": 3, "letter": "a", "food": "maple syrup", "score": 0.75}

Para obtener más información sobre las clases de esta sección, consulte la siguiente documentación de API:

• Filtros

• Indexes

• Proyecciones

• Colección Mongo

Para obtener más información, consulte la documentación de la API de la clase Sorts. Consulte la documentación del manual del servidor para obtener más información sobre el operador de consulta $text y el operador de canalización de agregación $meta.