限制返回结果的数量

在此页面上

Overview

指定限制
结合使用 Skip 和 Limit

Overview

在本指南中，您可以了解如何使用 MongoDB Java 驱动程序限制从读取操作返回的结果数量。

使用 limit()来限制读取操作返回的文档数量。此实例方法指定读取操作可以返回的最大文档数。如果文档数量不足以达到指定的限制，则可以返回一个较小的数字。如果将limit()与skip()实例方法结合使用，则首先应用 skip，并且限制仅应用于在 skip 操作后剩余的文档。有关skip()方法的更多信息，请参阅有关跳过返回的指南的指南。

以下示例分别演示如何向集合中插入数据，如何使用 limit() 限制返回的文档数量，以及如何将 limit() 与 skip() 组合以进一步缩小查询返回的结果范围。

示例文档

以下操作将表示书籍的文档插入到集合中：

collection.insertMany(Arrays.asList(
    new Document().append("_id", 1)
        .append("title", "The Brothers Karamazov").append("length", 824)
        .append("author", "Dostoyevsky"),
    new Document().append("_id", 2)
        .append("title", "Les Misérables").append("length", 1462).append("author", "Hugo"),
    new Document().append("_id", 3)
        .append("title", "Atlas Shrugged").append("length", 1088).append("author", "Rand"),
    new Document().append("_id", 4)
        .append("title", "Infinite Jest").append("length", 1104).append("author", "Wallace"),
    new Document().append("_id", 5)
        .append("title", "Cryptonomicon").append("length", 918).append("author", "Stephenson"),
    new Document().append("_id", 6)
        .append("title", "A Dance with Dragons").append("length", 1104)
        .append("author", "Martin")
));

指定限制

下一个示例会查询集合以返回长度排名前三的图书。它首先将所有文档与查询相匹配，然后对 length 字段进行排序，以先返回长度较长的书籍，然后返回长度较短的书籍。最后，它将返回值限制为 3 个文档：

import com.mongodb.client.*;
import org.bson.Document;
import static com.mongodb.client.model.Sorts.descending;
// ...
// define a cursor that will return the first 3 sorted items
MongoCursor<Document> cursor = collection.find()
    .sort(descending("length"))
    .limit(3)
    .iterator();
// print out items
try {
    while (cursor.hasNext()) {
        System.out.println(cursor.next());
    }
}
// close the cursor
finally {
    cursor.close();
}

前面的代码示例打印以下三份文档，按长度排序：

 Document{{_id=2, title=Les Misérables, author=Hugo, length=1462}}
 Document{{_id=6, title=A Dance with Dragons, author=Martin, length=1104}}
 Document{{_id=4, title=Infinite Jest, author=Wallace, length=1104}}

提示

调用 limit() 和 sort() 的顺序并不重要，因为驱动程序会对调用重新排序以首先应用排序，然后再应用限制。以下两个调用是等效的：

collection.find().sort(descending("length")).limit(3);
collection.find().limit(3).sort(descending("length"));

结合使用 Skip 和 Limit

要查看接下来的三本最长的书，请将 skip() 方法附加到您的 find() 调用中，如以下代码示例所示：

MongoCursor<Document> cursor = collection.find()
    .sort(descending("length"))
    .limit(3)
    .skip(3)
    .iterator();

此操作返回说明第四至第六长书籍的文档：

Document{{_id=3, title=Atlas Shrugged, author=Rand, length=1088}}
Document{{_id=5, title=Cryptonomicon, author=Stephenson, length=918}}
Document{{_id=1, title=The Brothers Karamazov, author=Dostoyevsky, length=824}}

您可以通过这种方式，结合 skip() 和 limit() 来为您的集合实现分页，一次仅返回集合的小“切片”。

注意

为了确保在多个查询中稳定排序，必须使用唯一键（例如_id ）进行排序。否则，当调用skip()和limit()与sort()结合使用时，可能会产生不可预测的结果。

例如，考虑以下数据：

{ type: "computer", data: "1", serial_no: 235235 }
{ type: "computer", data: "2", serial_no: 235237 }
{ type: "computer", data: "3", serial_no: 235239 }
{ type: "computer", data: "4", serial_no: 235241 }

如果仅按type排序， sort()并不能保证返回时顺序相同。将skip()和limit()附加到sort()可以为不同的查询返回不同的文档。在这种情况下，按data或serial_no排序将保证稳定排序，因为两者都是唯一键。

有关本指南中提到的方法和类的详情，请参阅以下 API 文档：

后退

跳过返回的结果

来年

指定要返回的字段