查询文档 (Querying Documents) _ Spring Data MongoDB 4.2.7 中文文档(官方文档中文翻译) —

最新的稳定版请使用 Spring Data MongoDB 4.3.1！Spring中文文档

可以使用和类来表示查询。它们具有镜像本机 MongoDB 运算符名称的方法名称，例如、、等。 and 类遵循流畅的 API 样式，以便您可以将多个方法条件和查询链接在一起，同时具有易于理解的代码。为了提高可读性，静态导入允许您避免使用“new”关键字来创建实例。您还可以使用从纯 JSON 字符串创建实例，如以下示例所示：QueryCriterialtlteisQueryCriteriaQueryCriteriaBasicQueryQuerySpring中文文档

例 1.从纯 JSON 字符串创建查询实例

BasicQuery query = new BasicQuery("{ age : { $lt : 50 }, accounts.balance : { $gt : 1000.00 }}");
List<Person> result = mongoTemplate.find(query, Person.class);

查询集合中的文档

前面，我们了解了如何使用上的和方法检索单个文档。这些方法以正确的方式返回单个域对象，或使用响应式 API 发出单个元素。我们还可以查询要作为域对象列表返回的文档集合。假设我们在集合中存储了许多具有名称和年龄的对象，并且每个人都有一个带有余额的嵌入式帐户文档，我们现在可以使用以下代码运行查询：findOnefindByIdMongoTemplateMonoPersonSpring中文文档

使用 MongoTemplate 查询文档

ImperativeSpring中文文档
ReactiveSpring中文文档

import static org.springframework.data.mongodb.core.query.Criteria.where;
import static org.springframework.data.mongodb.core.query.Query.query;

// ...

List<Person> result = template.query(Person.class)
  .matching(query(where("age").lt(50).and("accounts.balance").gt(1000.00d)))
  .all();

import static org.springframework.data.mongodb.core.query.Criteria.where;
import static org.springframework.data.mongodb.core.query.Query.query;

// ...

Flux<Person> result = template.query(Person.class)
  .matching(query(where("age").lt(50).and("accounts.balance").gt(1000.00d)))
  .all();

所有 find 方法都采用对象作为参数。此对象定义用于执行查询的条件和选项。这些条件是通过使用具有名为实例化新对象的静态工厂方法的对象来指定的。我们建议对和使用静态导入，使查询更具可读性。QueryCriteriawhereCriteriaorg.springframework.data.mongodb.core.query.Criteria.whereQuery.querySpring中文文档

查询应返回满足指定条件的对象的或。本节的其余部分列出了与 MongoDB 中提供的运算符相对应的 and 类的方法。大多数方法返回对象，以便为 API 提供流畅的样式。ListFluxPersonCriteriaQueryCriteriaSpring中文文档

Criteria 类的方法

该类提供以下方法，所有这些方法都对应于 MongoDB 中的运算符：CriteriaSpring中文文档

Criteria 都使用运算符创建条件(Object o)$allSpring中文文档
Criteria 和将具有指定值的链式链接添加到当前，并返回新创建的链式(String key)CriteriakeyCriteriaSpring中文文档
Criteria and运算符 使用运算符为所有提供的条件创建 and 查询（需要 MongoDB 2.0 或更高版本）(Criteria… criteria)$andSpring中文文档
Criteria and运算符 使用运算符为所有提供的条件创建 and 查询（需要 MongoDB 2.0 或更高版本）(Collection<Criteria> criteria)$andSpring中文文档
Criteria elemMatch 使用运算符创建条件(Criteria c)$elemMatchSpring中文文档
Criteria 存在使用运算符创建条件(boolean b)$existsSpring中文文档
Criteria 燃气轮机 使用运算符创建条件(Object o)$gtSpring中文文档
Criteria GTE系列 使用运算符创建条件(Object o)$gteSpring中文文档
Criteria 在使用 varargs 参数的运算符创建条件。(Object… o)$inSpring中文文档
Criteria 在使用集合的运算符创建条件(Collection<?> collection)$inSpring中文文档
Criteria 是使用字段匹配（）创建条件。如果指定的值是文档，则字段的顺序和文档中的完全相等性很重要。(Object o){ key:value }Spring中文文档
Criteria LT 使用运算符创建条件(Object o)$ltSpring中文文档
Criteria 莱特语 使用运算符创建条件(Object o)$lteSpring中文文档
Criteria 国防部 使用运算符创建条件(Number value, Number remainder)$modSpring中文文档
Criteria NE 使用运算符创建条件(Object o)$neSpring中文文档
Criteria 宁使用运算符创建条件(Object… o)$ninSpring中文文档
Criteria norOperator 使用运算符为所有提供的条件创建 nor 查询(Criteria… criteria)$norSpring中文文档
Criteria norOperator 使用运算符为所有提供的条件创建 nor 查询(Collection<Criteria> criteria)$norSpring中文文档
Criteria 不使用 meta 运算符创建一个条件，该条件会影响紧随其后的子句()$notSpring中文文档
Criteria 或运算符 使用运算符为所有提供的条件创建 or 查询(Criteria… criteria)$orSpring中文文档
Criteria 或运算符 使用运算符为所有提供的条件创建 or 查询(Collection<Criteria> criteria)$orSpring中文文档
Criteria 正则表达式 使用(String re)$regexSpring中文文档
Criteria sampleRate 使用运算符创建条件(double sampleRate)$sampleRateSpring中文文档
Criteria 大小使用运算符创建条件(int s)$sizeSpring中文文档
Criteria 类型使用运算符创建条件(int t)$typeSpring中文文档
Criteria matchingDocumentStructure 使用 JSON 架构条件的运算符创建条件。只能应用于查询的顶层，而不能应用于特定于属性的查询。使用架构的属性与嵌套字段进行匹配。(MongoJsonSchema schema)$jsonSchema$jsonSchemapropertiesSpring中文文档
Criteria bits（） 是 MongoDB 按位查询运算符的网关，如 .$bitsAllClearSpring中文文档

Criteria 类还为地理空间查询提供以下方法。Spring中文文档

Criteria 在使用运算符创建地理空间条件。(Circle circle)$geoWithin $centerSpring中文文档
Criteria 在使用操作创建地理空间条件。(Box box)$geoWithin $boxSpring中文文档
Criteria 在Sphere内 使用运算符创建地理空间条件。(Circle circle)$geoWithin $centerSpring中文文档
Criteria 近使用操作创建地理空间条件(Point point)$nearSpring中文文档
Criteria 近球体 使用操作创建地理空间条件。这仅适用于 MongoDB 1.7 及更高版本。(Point point)$nearSphere$centerSpring中文文档
Criteria 分钟距离 使用该操作创建地理空间条件，以便与$near一起使用。(double minDistance)$minDistanceSpring中文文档
Criteria 最大距离 使用该操作创建地理空间条件，以便与$near一起使用。(double maxDistance)$maxDistanceSpring中文文档

该类有一些额外的方法，允许选择某些字段以及限制和排序结果。QuerySpring中文文档

Query 类的方法

Query addCriteria 用于向查询添加其他条件(Criteria criteria)Spring中文文档
Field 用于定义要包含在查询结果中的字段的字段()Spring中文文档
Query 用于将返回结果的大小限制为提供的限制（用于分页）(int limit)Spring中文文档
Query 跳过用于跳过结果中提供的文档数量（用于分页）(int skip)Spring中文文档
Query 用于为结果提供排序定义(Sort sort)Spring中文文档
Query 用于提供滚动位置（基于偏移或键集的分页）以启动或恢复(ScrollPosition position)ScrollSpring中文文档

模板 API 允许直接使用结果预测，使您能够将查询映射到给定的域类型，同时将操作结果投影到另一个域类型上，如下所述。Spring中文文档

class

template.query(SWCharacter.class)
    .as(Jedi.class)

有关结果预测的更多信息，请参阅文档的“预测”部分。Spring中文文档

选择字段

MongoDB支持投影查询返回的字段。投影可以根据字段的名称包含和排除字段（除非明确排除，否则始终包含该字段）。_idSpring中文文档

例 2.选择结果字段

public class Person {

    @Id String id;
    String firstname;

    @Field("last_name")
    String lastname;

    Address address;
}

query.fields().include("lastname");              (1)

query.fields().exclude("id").include("lastname") (2)

query.fields().include("address")                (3)

query.fields().include("address.city")           (4)

1	结果将同时包含和 via 。`_idlast_name{ "last_name" : 1 }`
2	结果将仅包含 via .`last_name{ "_id" : 0, "last_name" : 1 }`
3	结果将包含和整个对象通过 .`_idaddress{ "address" : 1 }`
4	结果将包含仅包含字段的 and 和对象。`_idaddresscity{ "address.city" : 1 }`

从 MongoDB 4.4 开始，您可以将聚合表达式用于字段投影，如下所示：Spring中文文档

例 3.使用表达式计算结果字段

query.fields()
  .project(MongoExpression.create("'$toUpper' : '$last_name'"))         (1)
  .as("last_name");                                                     (2)

query.fields()
  .project(StringOperators.valueOf("lastname").toUpper())               (3)
  .as("last_name");

query.fields()
  .project(AggregationSpELExpression.expressionOf("toUpper(lastname)")) (4)
  .as("last_name");

1	使用本机表达式。使用的字段名称必须引用数据库文档中的字段名称。
2	指定表达式结果投影到的字段名称。生成的字段名称不会映射到域模型。
3	使用 .除了本机，字段名称被映射到域模型中使用的名称。`AggregationExpressionMongoExpression`
4	将 SpEL 与 an 一起使用以调用表达式函数。字段名称映射到域模型中使用的字段名称。`AggregationExpression`

@Query(fields="…")允许在基于 MongoDB JSON 的查询方法和字段限制中所述的级别使用表达式字段投影。RepositorySpring中文文档

1	结果将同时包含和 via 。`_idlast_name{ "last_name" : 1 }`
2	结果将仅包含 via .`last_name{ "_id" : 0, "last_name" : 1 }`
3	结果将包含和整个对象通过 .`_idaddress{ "address" : 1 }`
4	结果将包含仅包含字段的 and 和对象。`_idaddresscity{ "address.city" : 1 }`

1	使用本机表达式。使用的字段名称必须引用数据库文档中的字段名称。
2	指定表达式结果投影到的字段名称。生成的字段名称不会映射到域模型。
3	使用 .除了本机，字段名称被映射到域模型中使用的名称。`AggregationExpressionMongoExpression`
4	将 SpEL 与 an 一起使用以调用表达式函数。字段名称映射到域模型中使用的字段名称。`AggregationExpression`

其他查询选项

MongoDB提供了将元信息（如注释或批处理大小）应用于查询的各种方法。使用 API 这些选项有几种方法。QuerySpring中文文档

提示

索引提示可以通过两种方式应用，即使用索引名称或其字段定义。Spring中文文档

template.query(Person.class)
    .matching(query("...").withHint("index-to-use"));

template.query(Person.class)
    .matching(query("...").withHint("{ firstname : 1 }"));

游标批处理大小

游标批大小定义每个响应批处理中要返回的文档数。Spring中文文档

Query query = query(where("firstname").is("luke"))
    .cursorBatchSize(100)

排序规则

将排序规则与集合操作结合使用是在查询或操作选项中指定实例的问题，如以下两个示例所示：CollationSpring中文文档

Collation collation = Collation.of("de");

Query query = new Query(Criteria.where("firstName").is("Amél"))
    .collation(collation);

List<Person> results = template.find(query, Person.class);

读取首选项

可以直接在要运行的对象上设置要使用，如下所述。ReadPreferenceQuerySpring中文文档

template.find(Person.class)
    .matching(query(where(...)).withReadPreference(ReadPreference.secondary()))
    .all();

在实例上设置的首选项将取代默认值。QueryReadPreferenceMongoTemplate

查询可以配备注释，这使得它们更容易在服务器日志中查找。Spring中文文档

template.find(Person.class)
    .matching(query(where(...)).comment("Use the force luke!"))
    .all();

在实例上设置的首选项将取代默认值。QueryReadPreferenceMongoTemplate

查询非重复值

MongoDB提供了一个操作，通过使用从生成的文档中查询来获取单个字段的不同值。生成的值不需要具有相同的数据类型，该功能也不限于简单类型。对于检索，实际结果类型对于转换和键入确实很重要。以下示例演示如何查询非重复值：Spring中文文档

例 4.检索不同值

template.query(Person.class)  (1)
  .distinct("lastname")       (2)
  .all();                     (3)

1	查询集合。`Person`
2	选择字段的非重复值。字段名称根据域类型属性声明进行映射，并考虑潜在的批注。`lastname@Field`
3	以 of 的形式检索所有非重复值（由于未指定显式结果类型）。`ListObject`

将不同的值检索到 of 是最灵活的方法，因为它会尝试确定域类型的属性值并将结果转换为所需的类型或映射结构。CollectionObjectDocumentSpring中文文档

有时，当期望字段的所有值都固定为某种类型时，直接获取正确键入的，如以下示例所示，会更方便：CollectionSpring中文文档

例 5.检索强类型非重复值

template.query(Person.class)  (1)
  .distinct("lastname")       (2)
  .as(String.class)           (3)
  .all();                     (4)

1	查询的集合。`Person`
2	选择字段的非重复值。字段名称根据域类型属性声明进行映射，并考虑潜在的批注。`lastname@Field`
3	检索到的值将转换为所需的目标类型，在本例中为。如果存储的字段包含文档，也可以将值映射到更复杂的类型。`String`
4	以的格式检索所有非重复值。如果无法将类型转换为所需的目标类型，则此方法将抛出 .`ListStringDataAccessException`

+= 地理空间查询Spring中文文档

MongoDB 通过使用、、和等运算符来支持 GeoSpatial 查询。该类上提供了特定于地理空间查询的方法。还有一些形状类（、和）与地理空间相关方法结合使用。$near$withingeoWithin$nearSphereCriteriaBoxCirclePointCriteriaSpring中文文档

在 MongoDB 事务中使用 GeoSpatial 查询时需要注意，请参阅事务中的特殊行为。

要了解如何执行 GeoSpatial 查询，请考虑以下类（取自集成测试并依赖于丰富的）：VenueMappingMongoConverterSpring中文文档

Venue.java

@Document(collection="newyork")
public class Venue {

  @Id
  private String id;
  private String name;
  private double[] location;

  @PersistenceConstructor
  Venue(String name, double[] location) {
    super();
    this.name = name;
    this.location = location;
  }

  public Venue(String name, double x, double y) {
    super();
    this.name = name;
    this.location = new double[] { x, y };
  }

  public String getName() {
    return name;
  }

  public double[] getLocation() {
    return location;
  }

  @Override
  public String toString() {
    return "Venue [id=" + id + ", name=" + name + ", location="
        + Arrays.toString(location) + "]";
  }
}

要在中查找位置，可以使用以下查询：CircleSpring中文文档

Circle circle = new Circle(-73.99171, 40.738868, 0.01);
List<Venue> venues =
    template.find(new Query(Criteria.where("location").within(circle)), Venue.class);

若要使用球面坐标查找场地，可以使用以下查询：CircleSpring中文文档

Circle circle = new Circle(-73.99171, 40.738868, 0.003712240453784);
List<Venue> venues =
    template.find(new Query(Criteria.where("location").withinSphere(circle)), Venue.class);

要在中查找场地，可以使用以下查询：BoxSpring中文文档

//lower-left then upper-right
Box box = new Box(new Point(-73.99756, 40.73083), new Point(-73.988135, 40.741404));
List<Venue> venues =
    template.find(new Query(Criteria.where("location").within(box)), Venue.class);

要查找附近的场地，可以使用以下查询：PointSpring中文文档

Point point = new Point(-73.99171, 40.738868);
List<Venue> venues =
    template.find(new Query(Criteria.where("location").near(point).maxDistance(0.01)), Venue.class);

Point point = new Point(-73.99171, 40.738868);
List<Venue> venues =
    template.find(new Query(Criteria.where("location").near(point).minDistance(0.01).maxDistance(100)), Venue.class);

若要使用球面坐标查找附近的场地，可以使用以下查询：PointSpring中文文档

Point point = new Point(-73.99171, 40.738868);
List<Venue> venues =
    template.find(new Query(
        Criteria.where("location").nearSphere(point).maxDistance(0.003712240453784)),
        Venue.class);

1	查询集合。`Person`
2	选择字段的非重复值。字段名称根据域类型属性声明进行映射，并考虑潜在的批注。`lastname@Field`
3	以 of 的形式检索所有非重复值（由于未指定显式结果类型）。`ListObject`

1	查询的集合。`Person`
2	选择字段的非重复值。字段名称根据域类型属性声明进行映射，并考虑潜在的批注。`lastname@Field`
3	检索到的值将转换为所需的目标类型，在本例中为。如果存储的字段包含文档，也可以将值映射到更复杂的类型。`String`
4	以的格式检索所有非重复值。如果无法将类型转换为所需的目标类型，则此方法将抛出 .`ListStringDataAccessException`

在 MongoDB 事务中使用 GeoSpatial 查询时需要注意，请参阅事务中的特殊行为。

地理邻近查询

在 2.2 中更改！
MongoDB 4.2 删除了对以前用于运行 .geoNearNearQuerySpring中文文档

Spring Data MongoDB 2.2 使用聚合而不是命令来运行 .MongoOperations#geoNear$geoNeargeoNearNearQuerySpring中文文档

以前在包装器类型中返回的计算距离（使用 geoNear 命令时）现在已嵌入添加到生成的文档中。如果给定的域类型已包含具有该名称的属性，则计算距离以可能随机的后缀命名。discalculated-distanceSpring中文文档

目标类型可能包含以返回距离命名的属性，以便（另外）将其直接读回域类型，如下所示。Spring中文文档

GeoResults<VenueWithDistanceField> = template.query(Venue.class) (1)
    .as(VenueWithDistanceField.class)                            (2)
    .near(NearQuery.near(new GeoJsonPoint(-73.99, 40.73), KILOMETERS))
    .all();

1	用于标识目标集合和潜在查询映射的域类型。
2	包含类型为的字段的目标类型。`disNumber`

MongoDB支持在数据库中查询地理位置，同时计算到给定原点的距离。使用地理邻近查询，您可以表达诸如“查找周围 10 英里内的所有餐馆”之类的查询。若要执行此操作，请提供将 a 作为参数的方法（以及已经熟悉的实体类型和集合），如以下示例所示：MongoOperationsgeoNear(…)NearQuerySpring中文文档

Point location = new Point(-73.99171, 40.738868);
NearQuery query = NearQuery.near(location).maxDistance(new Distance(10, Metrics.MILES));

GeoResults<Restaurant> = operations.geoNear(query, Restaurant.class);

我们使用构建器 API 设置一个查询，以将给定的所有实例返回到 10 英里。这里使用的枚举实际上实现了一个接口，以便其他指标也可以插入到距离中。 A 由乘数支持，用于将给定指标的距离值转换为原生距离。此处显示的示例将 10 视为英里。使用其中一个内置指标（英里和公里）会自动触发要在查询上设置的球形标志。如果要避免这种情况，请将纯值传递给。有关更多信息，请参见和的 JavaDoc。NearQueryRestaurantPointMetricsMetricdoublemaxDistance(…)NearQueryDistanceSpring中文文档

geo-near 操作返回封装实例的包装对象。换行允许访问所有结果的平均距离。单个对象携带找到的实体及其与原点的距离。GeoResultsGeoResultGeoResultsGeoResultSpring中文文档

在 2.2 中更改！
MongoDB 4.2 删除了对以前用于运行 .geoNearNearQuerySpring中文文档

Spring Data MongoDB 2.2 使用聚合而不是命令来运行 .MongoOperations#geoNear$geoNeargeoNearNearQuerySpring中文文档

目标类型可能包含以返回距离命名的属性，以便（另外）将其直接读回域类型，如下所示。Spring中文文档

GeoResults<VenueWithDistanceField> = template.query(Venue.class) (1)
    .as(VenueWithDistanceField.class)                            (2)
    .near(NearQuery.near(new GeoJsonPoint(-73.99, 40.73), KILOMETERS))
    .all();

1	用于标识目标集合和潜在查询映射的域类型。
2	包含类型为的字段的目标类型。`disNumber`

1	用于标识目标集合和潜在查询映射的域类型。
2	包含类型为的字段的目标类型。`disNumber`

GeoJSON 支持

MongoDB 支持地理空间数据的 GeoJSON 和简单（旧版）坐标对。这些格式既可用于存储数据，也可用于查询数据。请参阅 MongoDB 手册中有关 GeoJSON 支持的信息，了解要求和限制。Spring中文文档

域类中的 GeoJSON 类型

在域类中使用 GeoJSON 类型非常简单。该包包含、等类型。这些类型是对现有类型的扩展。以下示例使用：org.springframework.data.mongodb.core.geoGeoJsonPointGeoJsonPolygonorg.springframework.data.geoGeoJsonPointSpring中文文档

public class Store {

	String id;

	/**
	 * { "type" : "Point", "coordinates" : [ x, y ] }
	 */
	GeoJsonPoint location;
}

如果 GeoJSON 对象表示纬度和经度对，则经度首先出现，然后是纬度。
因此被视为经度和纬度。coordinatesGeoJsonPointgetX()getY()Spring中文文档

存储库查询方法中的 GeoJSON 类型

使用 GeoJSON 类型作为存储库查询参数会强制在创建查询时使用运算符，如以下示例所示：$geometrySpring中文文档

public interface StoreRepository extends CrudRepository<Store, String> {

	List<Store> findByLocationWithin(Polygon polygon);  (1)

}

/*
 * {
 *   "location": {
 *     "$geoWithin": {
 *       "$geometry": {
 *         "type": "Polygon",
 *         "coordinates": [
 *           [
 *             [-73.992514,40.758934],
 *             [-73.961138,40.760348],
 *             [-73.991658,40.730006],
 *             [-73.992514,40.758934]
 *           ]
 *         ]
 *       }
 *     }
 *   }
 * }
 */
repo.findByLocationWithin(                              (2)
  new GeoJsonPolygon(
    new Point(-73.992514, 40.758934),
    new Point(-73.961138, 40.760348),
    new Point(-73.991658, 40.730006),
    new Point(-73.992514, 40.758934)));                 (3)

/*
 * {
 *   "location" : {
 *     "$geoWithin" : {
 *        "$polygon" : [ [-73.992514,40.758934] , [-73.961138,40.760348] , [-73.991658,40.730006] ]
 *     }
 *   }
 * }
 */
repo.findByLocationWithin(                              (4)
  new Polygon(
    new Point(-73.992514, 40.758934),
    new Point(-73.961138, 40.760348),
    new Point(-73.991658, 40.730006)));

1	使用 commons 类型的存储库方法定义允许使用 GeoJSON 和旧格式调用它。
2	使用 GeoJSON 类型来使用运算符。`$geometry`
3	请注意，GeoJSON 多边形需要定义闭环。
4	使用旧格式运算符。`$polygon`

1	使用 commons 类型的存储库方法定义允许使用 GeoJSON 和旧格式调用它。
2	使用 GeoJSON 类型来使用运算符。`$geometry`
3	请注意，GeoJSON 多边形需要定义闭环。
4	使用旧格式运算符。`$polygon`

指标和距离计算

然后，MongoDB运算符允许使用GeoJSON点或传统坐标对。$geoNearSpring中文文档

NearQuery.near(new Point(-73.99171, 40.738868))

{
  "$geoNear": {
    //...
    "near": [-73.99171, 40.738868]
  }
}

NearQuery.near(new GeoJsonPoint(-73.99171, 40.738868))

{
  "$geoNear": {
    //...
    "near": { "type": "Point", "coordinates": [-73.99171, 40.738868] }
  }
}

尽管语法不同，但无论集合中的目标文档格式如何，服务器都可以接受这两种格式正在使用。Spring中文文档

距离计算存在巨大差异。使用旧格式操作在类似地球的球体上的弧度上，而 GeoJSON 格式使用米。

为避免严重的头痛，请确保将设置为所需的测量单位，以确保要正确计算的距离。MetricSpring中文文档

换言之：Spring中文文档

假设您有 5 个文档，如下所示：Spring中文文档

{
    "_id" : ObjectId("5c10f3735d38908db52796a5"),
    "name" : "Penn Station",
    "location" : { "type" : "Point", "coordinates" : [  -73.99408, 40.75057 ] }
}
{
    "_id" : ObjectId("5c10f3735d38908db52796a6"),
    "name" : "10gen Office",
    "location" : { "type" : "Point", "coordinates" : [ -73.99171, 40.738868 ] }
}
{
    "_id" : ObjectId("5c10f3735d38908db52796a9"),
    "name" : "City Bakery ",
    "location" : { "type" : "Point", "coordinates" : [ -73.992491, 40.738673 ] }
}
{
    "_id" : ObjectId("5c10f3735d38908db52796aa"),
    "name" : "Splash Bar",
    "location" : { "type" : "Point", "coordinates" : [ -73.992491, 40.738673 ] }
}
{
    "_id" : ObjectId("5c10f3735d38908db52796ab"),
    "name" : "Momofuku Milk Bar",
    "location" : { "type" : "Point", "coordinates" : [ -73.985839, 40.731698 ] }
}

从中获取 400 米半径内的所有文档如下所示 GeoJSON：[-73.99171, 40.738868]Spring中文文档

例 6.使用 GeoJSON 的 GeoNear

{
    "$geoNear": {
        "maxDistance": 400, (1)
        "num": 10,
        "near": { type: "Point", coordinates: [-73.99171, 40.738868] },
        "spherical":true, (2)
        "key": "location",
        "distanceField": "distance"
    }
}

返回以下 3 个文档：Spring中文文档

{
    "_id" : ObjectId("5c10f3735d38908db52796a6"),
    "name" : "10gen Office",
    "location" : { "type" : "Point", "coordinates" : [ -73.99171, 40.738868 ] }
    "distance" : 0.0 (3)
}
{
    "_id" : ObjectId("5c10f3735d38908db52796a9"),
    "name" : "City Bakery ",
    "location" : { "type" : "Point", "coordinates" : [ -73.992491, 40.738673 ] }
    "distance" : 69.3582262492474 (3)
}
{
    "_id" : ObjectId("5c10f3735d38908db52796aa"),
    "name" : "Splash Bar",
    "location" : { "type" : "Point", "coordinates" : [ -73.992491, 40.738673 ] }
    "distance" : 69.3582262492474 (3)
}

1	距中心点的最大距离（以米为单位）。
2	GeoJSON 始终在球体上运行。
3	距中心点的距离（以米为单位）。

现在，当使用传统坐标对时，如前所述，对弧度进行操作。所以我们使用命令。确保距离乘数设置正确。Metrics#KILOMETERS when constructing the `$geoNearMetricSpring中文文档

例 7.具有传统坐标对的 GeoNear

{
    "$geoNear": {
        "maxDistance": 0.0000627142377, (1)
        "distanceMultiplier": 6378.137, (2)
        "num": 10,
        "near": [-73.99171, 40.738868],
        "spherical":true, (3)
        "key": "location",
        "distanceField": "distance"
    }
}

像 GeoJSON 变体一样返回 3 个文档：Spring中文文档

{
    "_id" : ObjectId("5c10f3735d38908db52796a6"),
    "name" : "10gen Office",
    "location" : { "type" : "Point", "coordinates" : [ -73.99171, 40.738868 ] }
    "distance" : 0.0 (4)
}
{
    "_id" : ObjectId("5c10f3735d38908db52796a9"),
    "name" : "City Bakery ",
    "location" : { "type" : "Point", "coordinates" : [ -73.992491, 40.738673 ] }
    "distance" : 0.0693586286032982 (4)
}
{
    "_id" : ObjectId("5c10f3735d38908db52796aa"),
    "name" : "Splash Bar",
    "location" : { "type" : "Point", "coordinates" : [ -73.992491, 40.738673 ] }
    "distance" : 0.0693586286032982 (4)
}

1	距中心点的最大距离（以弧度为单位）。
2	距离乘数，因此我们得到公里作为结果距离。
3	确保我们在2d_sphere指数上运作。
4	距中心点的距离（以公里为单位） - 乘以 1000 以匹配 GeoJSON 变体的米。

距离计算存在巨大差异。使用旧格式操作在类似地球的球体上的弧度上，而 GeoJSON 格式使用米。

1	距中心点的最大距离（以米为单位）。
2	GeoJSON 始终在球体上运行。
3	距中心点的距离（以米为单位）。

1	距中心点的最大距离（以弧度为单位）。
2	距离乘数，因此我们得到公里作为结果距离。
3	确保我们在2d_sphere指数上运作。
4	距中心点的距离（以公里为单位） - 乘以 1000 以匹配 GeoJSON 变体的米。

全文搜索

从MongoDB版本2.6开始，可以使用运算符运行全文查询。特定于全文查询的方法和操作在和中可用。进行全文搜索时，请参阅 MongoDB 参考，了解其行为和限制。$textTextQueryTextCriteriaSpring中文文档

在实际使用全文搜索之前，必须正确设置搜索索引。有关如何创建索引结构的更多详细信息，请参阅文本索引。以下示例演示如何设置全文搜索：Spring中文文档

db.foo.createIndex(
{
  title : "text",
  content : "text"
},
{
  weights : {
              title : 3
            }
}
)

可以按如下方式定义和运行搜索查询：coffee cakeSpring中文文档

例 8.全文查询

Query query = TextQuery
  .queryText(new TextCriteria().matchingAny("coffee", "cake"));

List<Document> page = template.find(query, Document.class);

根据用途按相关性对结果进行排序。weightsTextQuery.sortByScoreSpring中文文档

例 9.全文查询 - 按分数排序

Query query = TextQuery
  .queryText(new TextCriteria().matchingAny("coffee", "cake"))
  .sortByScore() (1)
  .includeScore(); (2)

List<Document> page = template.find(query, Document.class);

1	使用 score 属性按触发 .`.sort({'score': {'$meta': 'textScore'}})`
2	用于将计算出的相关性包含在结果中。`TextQuery.includeScore()Document`

您可以通过在搜索词前面加上或 using 来排除搜索词，如以下示例所示（请注意，这两行具有相同的效果，因此是多余的）：-notMatchingSpring中文文档

// search for 'coffee' and not 'cake'
TextQuery.queryText(new TextCriteria().matching("coffee").matching("-cake"));
TextQuery.queryText(new TextCriteria().matching("coffee").notMatching("cake"));

TextCriteria.matching按原样采用提供的术语。因此，您可以通过将短语放在双引号之间来定义短语（例如，或使用以下示例显示了定义短语的两种方法：\"coffee cake\")TextCriteria.phrase.Spring中文文档

// search for phrase 'coffee cake'
TextQuery.queryText(new TextCriteria().matching("\"coffee cake\""));
TextQuery.queryText(new TextCriteria().phrase("coffee cake"));

您可以使用上的相应方法为和设置标志。请注意，这两个可选标志已在 MongoDB 3.2 中引入，除非显式设置，否则不会包含在查询中。$caseSensitive$diacriticSensitiveTextCriteriaSpring中文文档

1	使用 score 属性按触发 .`.sort({'score': {'$meta': 'textScore'}})`
2	用于将计算出的相关性包含在结果中。`TextQuery.includeScore()Document`

按示例查询

“按示例查询”可用于模板 API 级别运行示例查询。Spring中文文档

以下截图显示了如何通过示例进行查询：Spring中文文档

类型化示例查询

Person probe = new Person();
probe.lastname = "stark";

Example example = Example.of(probe);

Query query = new Query(new Criteria().alike(example));
List<Person> result = template.find(query, Person.class);

默认情况下是严格键入的。这意味着映射查询具有包含的类型匹配，将其限制为探测可分配类型。例如，当坚持使用默认类型键（）时，查询具有（）等限制。Example_class_class : { $in : [ com.acme.Person] }Spring中文文档

通过使用，可以绕过默认行为并跳过类型限制。因此，只要字段名称匹配，几乎任何域类型都可以用作创建引用的探测器，如以下示例所示：UntypedExampleMatcherSpring中文文档

例 10.非类型化示例查询

class JustAnArbitraryClassWithMatchingFieldName {
  @Field("lastname") String value;
}

JustAnArbitraryClassWithMatchingFieldNames probe = new JustAnArbitraryClassWithMatchingFieldNames();
probe.value = "stark";

Example example = Example.of(probe, UntypedExampleMatcher.matching());

Query query = new Query(new Criteria().alike(example));
List<Person> result = template.find(query, Person.class);

在中包含值时，Spring Data Mongo 使用嵌入式文档匹配而不是点表示法属性匹配。这样做会强制对嵌入文档中的所有属性值和属性顺序进行精确的文档匹配。nullExampleSpecSpring中文文档

UntypedExampleMatcher如果要在单个集合中存储不同的实体或选择不编写类型提示，则可能是您的正确选择。Spring中文文档

另外，请记住，使用需要急切地初始化 .为此，请配置为确保读取操作的别名解析正确。@TypeAliasMappingContextinitialEntitySetSpring中文文档

Spring Data MongoDB 提供对不同匹配选项的支持：Spring中文文档

StringMatcher选项

匹配合乎逻辑的结果

匹配	合乎逻辑的结果
`DEFAULT`（区分大小写）Spring中文文档	`{"firstname" : firstname}`Spring中文文档
`DEFAULT`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: firstname, $options: 'i'}}`Spring中文文档
`EXACT`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname$/}}`Spring中文文档
`EXACT`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname$/, $options: 'i'}}`Spring中文文档
`STARTING`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname/}}`Spring中文文档
`STARTING`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname/, $options: 'i'}}`Spring中文文档
`ENDING`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname$/}}`Spring中文文档
`ENDING`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname$/, $options: 'i'}}`Spring中文文档
`CONTAINING`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /.firstname./}}`Spring中文文档
`CONTAINING`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /.firstname./, $options: 'i'}}`Spring中文文档
`REGEX`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname/}}`Spring中文文档
`REGEX`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname/, $options: 'i'}}`Spring中文文档

DEFAULT（区分大小写）Spring中文文档

{"firstname" : firstname}Spring中文文档

DEFAULT（不区分大小写）Spring中文文档

{"firstname" : { $regex: firstname, $options: 'i'}}Spring中文文档

EXACT（区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname$/}}Spring中文文档

EXACT（不区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname$/, $options: 'i'}}Spring中文文档

STARTING（区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname/}}Spring中文文档

STARTING（不区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname/, $options: 'i'}}Spring中文文档

ENDING（区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname$/}}Spring中文文档

ENDING（不区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname$/, $options: 'i'}}Spring中文文档

CONTAINING（区分大小写）Spring中文文档

{"firstname" : { $regex: /.*firstname.*/}}Spring中文文档

CONTAINING（不区分大小写）Spring中文文档

{"firstname" : { $regex: /.*firstname.*/, $options: 'i'}}Spring中文文档

REGEX（区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname/}}Spring中文文档

REGEX（不区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname/, $options: 'i'}}Spring中文文档

UntypedExampleMatcher如果要在单个集合中存储不同的实体或选择不编写类型提示，则可能是您的正确选择。Spring中文文档

另外，请记住，使用需要急切地初始化 .为此，请配置为确保读取操作的别名解析正确。@TypeAliasMappingContextinitialEntitySetSpring中文文档

匹配合乎逻辑的结果

匹配	合乎逻辑的结果
`DEFAULT`（区分大小写）Spring中文文档	`{"firstname" : firstname}`Spring中文文档
`DEFAULT`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: firstname, $options: 'i'}}`Spring中文文档
`EXACT`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname$/}}`Spring中文文档
`EXACT`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname$/, $options: 'i'}}`Spring中文文档
`STARTING`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname/}}`Spring中文文档
`STARTING`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /^firstname/, $options: 'i'}}`Spring中文文档
`ENDING`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname$/}}`Spring中文文档
`ENDING`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname$/, $options: 'i'}}`Spring中文文档
`CONTAINING`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /.firstname./}}`Spring中文文档
`CONTAINING`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /.firstname./, $options: 'i'}}`Spring中文文档
`REGEX`（区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname/}}`Spring中文文档
`REGEX`（不区分大小写）Spring中文文档	`{"firstname" : { $regex: /firstname/, $options: 'i'}}`Spring中文文档

DEFAULT（区分大小写）Spring中文文档

{"firstname" : firstname}Spring中文文档

DEFAULT（不区分大小写）Spring中文文档

{"firstname" : { $regex: firstname, $options: 'i'}}Spring中文文档

EXACT（区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname$/}}Spring中文文档

EXACT（不区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname$/, $options: 'i'}}Spring中文文档

STARTING（区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname/}}Spring中文文档

STARTING（不区分大小写）Spring中文文档

{"firstname" : { $regex: /^firstname/, $options: 'i'}}Spring中文文档

ENDING（区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname$/}}Spring中文文档

ENDING（不区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname$/, $options: 'i'}}Spring中文文档

CONTAINING（区分大小写）Spring中文文档

{"firstname" : { $regex: /.*firstname.*/}}Spring中文文档

CONTAINING（不区分大小写）Spring中文文档

{"firstname" : { $regex: /.*firstname.*/, $options: 'i'}}Spring中文文档

REGEX（区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname/}}Spring中文文档

REGEX（不区分大小写）Spring中文文档

{"firstname" : { $regex: /firstname/, $options: 'i'}}Spring中文文档

查询集合以匹配 JSON 架构

您可以使用架构查询与 JSON 架构定义的给定结构匹配的文档的任何集合，如以下示例所示：Spring中文文档

例 11.查询与$jsonSchema

MongoJsonSchema schema = MongoJsonSchema.builder().required("firstname", "lastname").build();

template.find(query(matchingDocumentStructure(schema)), Person.class);

请参阅 JSON 架构部分，了解有关 Spring Data MongoDB 中的架构支持的更多信息。Spring中文文档

查询集合中的文档

选择字段

其他查询选项

提示

游标批处理大小

排序规则

读取首选项

评论

查询非重复值

地理邻近查询

GeoJSON 支持

域类中的 GeoJSON 类型

存储库查询方法中的 GeoJSON 类型

指标和距离计算

全文搜索

按示例查询

查询集合以匹配 JSON 架构