Docs 菜单
Docs 主页
/
语言
/
Java
/
Java (Sync) 驱动程序
/
Fundamentals
/
增删改查操作
/
读取操作

指定要返回的字段

在此页面上

  • Overview
  • 行为
  • 解释

Overview

在本指南中，您可以了解如何控制 MongoDB Java 驱动程序读取操作返回的文档中显示的字段。

许多读取请求仅需要文档中的部分字段。 例如，当用户登录时，您可能只需要他们的用户名，而不需要他们的所有个人资料信息。默认情况下，MongoDB 中的查询返回匹配文档中的所有字段。您可以使用投影仅返回所需的数据。

投影是一个文档，用于指示MongoDB返回文档的哪些字段。 使用投影类构造投影文档。

行为

投影有两种工作方式：

  • 显式包含字段。此举的不利影响是会隐式排除所有未指定的字段。

  • 隐性排除字段。这样做的不利影响是会隐式包含所有未指定的字段。

这两种投影方法是互斥的：如果显式包含字段，则不能显式排除字段，反之亦然。

重要

_id 字段不受这些机制的约束。如果不希望返回 _id 字段，则必须明确将其排除。即使您已指定要包含某些字段，也可以排除 _id 字段。

解释

考虑以下集合，其中包含描述各种水果的文档：

{ "_id": 1, "name": "apples", "qty": 5, "rating": 3 },
{ "_id": 2, "name": "bananas", "qty": 7, "rating": 1 },
{ "_id": 3, "name": "oranges", "qty": 6, "rating": 2 },
{ "_id": 4, "name": "avocados", "qty": 3, "rating": 5 },

在以下查询中，传递此投影以仅返回每个文档的 name 字段：

// return all documents with *only* the name field
Bson filter = Filters.empty();
Bson projection = Projections.fields(Projections.include("name"));
collection.find(filter).projection(projection).forEach(doc -> System.out.println(doc));

投影文档指定读取操作结果应包含每个返回文档的 name 字段。因此，此投影隐式排除了 qty 和 rating 字段。使用空查询筛选器将此投影链接到 find() 会产生以下结果：

{ "_id": 1, "name": "apples" }
{ "_id": 2, "name": "bananas" }
{ "_id": 3, "name": "oranges" }
{ "_id": 4, "name": "avocados" }

该投影仅明确包含了 name 字段，但查询同时返回了 _id 字段。

_id 字段是一个特例：除非明确排除，否则它始终包含在每个查询结果中。这是因为 _id 字段是每个文档的唯一标识符，该属性在构造查询时有用。

movies 集合能够很好地说明此属性的价值：由于翻拍甚至独立作品有时会重复使用电影标题，因此您需要一个唯一的 _id 值来指代任何特定的电影。

_id 是投影中互斥的包含-排除行为的唯一例外：如果您不希望 _id 出现在返回的文档中，即使在显式包含其他字段的情况下，您也可以显式排除 _id 字段。

// return all documents with only the name field
Bson filter = Filters.empty();
Bson projection = Projections.fields(Projections.include("name"), Projections.excludeId());
collection.find(filter).projection(projection).forEach(doc -> System.out.println(doc));

投影文档指定读取操作结果应包含每个返回文档的 name 字段，并指定排除 _id 字段。因此，此投影隐式排除了 qty 和 rating 字段。使用空查询筛选器将此投影链接到 find() 会产生以下结果：

{ "name": "apples" }
{ "name": "bananas" }
{ "name": "oranges" }
{ "name": "avocados" }

您还可以指定要包含在投影中的多个字段。

提示

注：投影中指定字段的顺序不会改变字段的返回顺序。

Bson filter = Filters.empty();
Bson projection = Projections.fields(Projections.include("name", "rating"), Projections.excludeId());
collection.find(filter).projection(projection).forEach(doc -> System.out.println(doc));

此示例标识了要包含在投影中的两个字段，产生了以下结果：

  { "name": "apples", "rating": 3 }
  { "name": "bananas", "rating": 1 }
  { "name": "oranges", "rating": 2 }
  { "name": "avocados", "rating": 5 }

有关其他投影示例，请参阅 MongoDB 手册中关于从查询返回的项目字段的页面。

后退

限制返回结果的数量

来年

按地理空间搜索

在此页面上