Spring认证中国教育管理中心-Spring Data MongoDB教程四

原标题：Spring认证中国教育管理中心-Spring Data MongoDB教程四(内容来源：Spring中国教育管理中心）

11.5.9.删除文档的方法

您可以使用五种重载方法之一从数据库中删除对象：

template.remove(tywin, "GOT");                                              

template.remove(query(where("lastname").is("lannister")), "GOT");           

template.remove(new Query().limit(3), "GOT");                               

template.findAllAndRemove(query(where("lastname").is("lannister"), "GOT");  

template.findAllAndRemove(new Query().limit(3), "GOT");

_id从关联的集合中删除由它指定的单个实体。

从GOT集合中删除与查询条件匹配的所有文档。

删除GOT集合中的前三个文档。不同于<2>，文档，以除去由它们的标识_id，运行给定的查询，应用sort，limit和skip选择第一，然后在一次在一个单独的步骤中除去所有。

从GOT集合中删除与查询条件匹配的所有文档。与 <3> 不同的是，文档不会被批量删除，而是逐个删除。

删除GOT集合中的前三个文档。与 <3> 不同的是，文档不会被批量删除，而是逐个删除。

11.5.10。乐观锁定

该@Version注释在 MongoDB 的上下文中提供类似于 JPA 的语法，并确保更新仅应用于具有匹配版本的文档。因此，version 属性的实际值被添加到更新查询中，如果另一个操作同时更改了文档，则更新不会产生任何影响。在这种情况下，
OptimisticLockingFailureException会抛出an 。以下示例显示了这些功能：

@Documentclass Person {  @Id String id;
  String firstname;
  String lastname;  @Version Long version;
}

Person daenerys = template.insert(new Person("Daenerys"));                            

Person tmp = template.findOne(query(where("id").is(daenerys.getId())), Person.class); daenerys.setLastname("Targaryen");
template.save(daenerys);                                                              

template.save(tmp); // throws OptimisticLockingFailureException

最初插入文档。version设置为0。

加载刚刚插入的文档。version还在0。

用 更新文档version = 0。将lastname和设置version为1。

尝试更新先前加载的文档，但仍有version = 0. 操作失败并显示
OptimisticLockingFailureException，因为当前version是1。

乐观锁定需要将 设置WriteConcern为ACKNOWLEDGED。否则
OptimisticLockingFailureException可以被无声吞噬。

从版本 2.2 开始，MongoOperations还包括@Version从数据库中删除实体时的属性。要删除Document没有版本检查使用MongoOperations#remove(Query,…)的替代MongoOperations#remove(Object)。

从版本 2.2 开始，存储库在删除版本化实体时检查确认删除的结果。一
OptimisticLockingFailureException，如果一个版本实体不能被删除，通过提高CrudRepository.delete(Object)。在这种情况下，版本已更改或对象在此期间被删除。使用CrudRepository.deleteById(ID)旁路乐观锁定功能，也不管他们的版本中删除对象。

11.6.查询文件

您可以使用Query和Criteria类来表达你的queries.They有反映本地MongoDB的运营商名称方法的名称，如lt，lte，is，和others.TheQuery和Criteria类遵循流畅API的风格，让你可以连续使用多个方法标准和查询同时具有易于理解的代码。为了提高可读性，静态导入让您避免使用“new”关键字来创建Query和Criteria实例。您还可以使用从纯 JSON 字符串BasicQuery创建Query实例，如下例所示：

示例 71.从纯 JSON 字符串创建 Query 实例

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

Spring MongoDB 还支持 GeoSpatial 查询（参见GeoSpatial Queries部分）和 Map-Reduce 操作（参见Map-Reduce部分）。

11.6.1.查询集合中的文档

早些时候，我们看到了如何使用findOne和findById方法检索单个文档MongoTemplate。这些方法返回单个域对象。我们还可以查询要作为域对象列表返回的文档集合。假设我们有许多Person带有名称和年龄的对象作为文档存储在一个集合中，并且每个人都有一个带有余额的嵌入式帐户文档，我们现在可以使用以下代码运行查询：

示例 72. 使用 MongoTemplate 查询文档

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();

所有的 find 方法都以一个Query对象作为参数。此对象定义用于执行查询的条件和选项。这些标准是通过使用一个Criteria对象来指定的，该对象具有一个静态工厂方法，where用于实例化一个新Criteria对象。我们建议使用静态进口
org.springframework.data.mongodb.core.query.Criteria.where和Query.query使查询更具可读性。

查询应返回Person满足指定条件的对象列表。本节的其余部分列出了Criteria与QueryMongoDB 中提供的运算符对应的和类的方法。大多数方法返回Criteria对象，为 API 提供流畅的样式。

Criteria 类的方法

的Criteria类提供了以下的方法，所有这些都对应于运营商在MongoDB中：

• Criteria all (Object o)使用$all运算符创建条件

• Criteria 并将 指定(String key)的链添加到当前并返回新创建的CriteriakeyCriteria

• Criteria andOperator (Criteria… criteria)使用$and运算符为所有提供的条件创建和查询（需要 MongoDB 2.0 或更高版本）

• Criteria andOperator (Collection<Criteria> criteria)使用$and运算符为所有提供的条件创建和查询（需要 MongoDB 2.0 或更高版本）

• Criteria elemMatch (Criteria c)使用$elemMatch运算符创建标准

• Criteria 存在 (boolean b)使用$exists运算符创建条件

• Criteria gt (Object o)使用$gt运算符创建标准

• Criteria gte (Object o)使用$gte运算符创建条件

• Criteria in (Object… o)使用$invarargs 参数的运算符创建条件。

• Criteria in (Collection<?> collection)使用$in使用集合的运算符创建条件

• Criteria is (Object o)使用字段匹配 ( { key:value })创建标准。如果指定的值是文档，则文档中的字段顺序和完全相等很重要。

• Criteria lt (Object o)使用$lt运算符创建一个条件

• Criteria lte (Object o)使用$lte运算符创建条件

• Criteria mod (Number value, Number remainder)使用$mod运算符创建一个标准

• Criteria ne (Object o)使用$ne运算符创建标准

• Criteria nin (Object… o)使用$nin运算符创建一个标准

• Criteria norOperator (Criteria… criteria)使用$nor运算符为所有提供的条件创建一个 nor 查询

• Criteria norOperator (Collection<Criteria> criteria)使用$nor运算符为所有提供的条件创建一个 nor 查询

• Criteria not ()使用$not影响紧随其后的子句的元运算符创建一个条件

• Criteria orOperator (Criteria… criteria)使用$or运算符为所有提供的条件创建 or 查询

• Criteria orOperator (Collection<Criteria> criteria)使用$or运算符为所有提供的条件创建 or 查询

• Criteria regex (String re)使用$regex

• Criteria sampleRate (double sampleRate)使用$sampleRate运算符创建标准

• Criteria size (int s)使用$size运算符创建标准

• Criteria type (int t)使用$type运算符创建条件

• Criteria matchingDocumentStructure (MongoJsonSchema schema)创建使用的标准$jsonSchema操作员JSON模式标准。$jsonSchema只能应用于查询的顶层，而不是特定于属性的。使用properties架构的属性来匹配嵌套字段。

• Criteria bits()是MongoDB 按位查询运算符（如$bitsAllClear.

Criteria 类还为地理空间查询提供了以下方法（请参阅GeoSpatial Queries部分以查看它们的实际效果）：

• Criteria 内 (Circle circle)创建使用地理空间标准$geoWithin $center运算符。

• Criteria 内 (Box box)创建使用地理空间标准$geoWithin $box操作。

• Criteria insideSphere (Circle circle)使用$geoWithin $center运算符创建地理空间标准。

• Criteria Near (Point point)使用$near操作创建地理空间标准

• Criteria NearSphere (Point point)使用$nearSphere$center操作创建地理空间标准。这仅适用于 MongoDB 1.7 及更高版本。

• Criteria minDistance (double minDistance)使用$minDistance操作创建地理空间标准，与 $near 一起使用。

• Criteria maxDistance (double maxDistance)使用$maxDistance操作创建地理空间标准，与 $near 一起使用。

Query 类的方法

本Query类有提供查询选项的一些额外的方法：

• Query addCriteria (Criteria criteria)用于向查询添加附加条件

• Field fields ()用于定义要包含在查询结果中的字段

• Query limit (int limit)用于将返回结果的大小限制为提供的限制（用于分页）

• Query skip (int skip)用于跳过结果中提供的文档数（用于分页）

• Query with (Sort sort)用于为结果提供排序定义

选择字段

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

示例 73. 选择结果字段

public class Person {    @Id String id;    String firstname;

    @Field("last_name")    String lastname;    Address address;
}query.fields().include("lastname");              

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

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

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

结果将同时包含_id和last_namevia { "last_name" : 1 }。

结果将仅包含last_namevia { "_id" : 0, "last_name" : 1 }。

结果将通过 包含_id整个address对象{ "address" : 1 }。

结果将包含仅包含字段 via的_idand 和address对象。city{ "address.city" : 1 }

从 MongoDB 4.4 开始，您可以使用聚合表达式进行字段投影，如下所示：

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

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

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

使用本机表达式。使用的字段名称必须引用数据库文档中的字段名称。

分配表达式结果投影到的字段名称。结果字段名称未映射到域模型。

使用AggregationExpression. 除了 native MongoExpression，字段名称映射到域模型中使用的名称。

使用 SpEL 和 anAggregationExpression来调用表达式函数。字段名称映射到域模型中使用的名称。

@Query(fields="…")允许在Repository级别使用表达式字段投影，如MongoDB JSON-based Query Methods and Field Restriction 中所述。

11.6.2.查询文档的方法

查询方法需要指定T返回的目标类型，并且它们使用显式集合名称重载，以便查询应该对返回类型指示的集合以外的集合进行操作。以下查询方法可让您查找一个或多个文档：

• findAll：T从集合中查询类型对象的列表。

• findOne：将集合上的即席查询的结果映射到指定类型的对象的单个实例。

• findById：返回给定 ID 和目标类的对象。

• find：将集合上的即席查询的结果映射到List指定类型的 a 。

• findAndRemove：将集合上的即席查询的结果映射到指定类型的对象的单个实例。与查询匹配的第一个文档被返回并从数据库中的集合中删除。

11.6.3.查询不同的值

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

示例 75. 检索不同的值

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

查询Person集合。

选择该lastname字段的不同值。字段名称根据域类型属性声明进行映射，同时考虑了潜在的@Field注释。

将所有不同的值作为Listof检索Object（由于未指定明确的结果类型）。

将不同的值检索到CollectionofObject是最灵活的方式，因为它尝试确定域类型的属性值并将结果转换为所需的类型或映射Document结构。

有时，当所需字段的所有值都固定为某种类型时，直接获取正确类型的 更方便，Collection如下例所示：

示例 76. 检索强类型的不同值

template.query(Person.class)  
  .distinct("lastname")       
  .as(String.class)           
  .all();

查询 的集合Person。

选择该lastname字段的不同值。字段名根据域类型属性声明进行映射，同时考虑了潜在的@Field注释。

检索到的值将转换为所需的目标类型 - 在本例中为String. 如果存储的字段包含文档，还可以将值映射到更复杂的类型。

检索所有不同的值作为 a Listof String。如果类型无法转换为所需的目标类型，则此方法将抛出DataAccessException.

11.6.4.地理空间查询

MongoDB的支持通过使用等运营商的地理空间查询$near，$within，geoWithin，和$nearSphere。Criteria类中提供了特定于地理空间查询的方法。还有一些形状类（Box、Circle和Point）与地理空间相关Criteria方法结合使用。

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

要了解如何执行 GeoSpatial 查询，请考虑以下Venue类（取自集成测试并依赖于 rich MappingMongoConverter）：

@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) + "]";
  }
}

要在 中查找位置Circle，您可以使用以下查询：

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

要在Circle使用球坐标中查找场地，您可以使用以下查询：

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

要在 中查找场所Box，您可以使用以下查询：

//lower-left then upper-rightBox 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);

要查找 a 附近的场地Point，您可以使用以下查询：

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);

要Point使用球坐标查找附近的场地，您可以使用以下查询：

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);

近地查询

在 2.2 中改变了！

MongoDB 4.2删除了对 geoNear之前用于运行NearQuery.

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

dis先前在包装器类型中返回的计算距离（使用 geoNear 命令时）现在嵌入到生成的文档中。如果给定的域类型已经包含具有该名称的属性，则计算出的距离将calculated-distance使用一个潜在的随机后缀命名。

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

GeoResults<VenueWithDisField> = template.query(Venue.class)

.as(VenueWithDisField.class)

.near(NearQuery.near(new GeoJsonPoint(-73.99, 40.73), KILOMETERS))

.all();

用于标识目标集合和潜在查询映射的域类型。

包含distype 字段的目标类型Number。

MongoDB 支持在数据库中查询地理位置并同时计算距给定原点的距离。使用 geo-near 查询，您可以表达诸如“查找周围 10 英里内的所有餐馆”之类的查询。为了让您这样做，MongoOperations提供geoNear(…)了将 aNearQuery作为参数的方法（以及已经熟悉的实体类型和集合），如以下示例所示：

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);

我们使用NearQuery构建器 API 设置查询以返回Restaurant给定范围Point内 10 英里范围内的所有实例。Metrics这里使用的枚举实际上实现了一个接口，以便其他度量也可以插入到一定距离。AMetric由乘数支持，以将给定度量的距离值转换为原生距离。此处显示的示例将 10 视为英里。使用内置指标之一（英里和公里）会自动触发要在查询上设置的球形标志。如果您想避免这种情况，请将普通double值传递到maxDistance(…). 欲了解更多信息，请参阅的JavaDoc的NearQuery和Distance。

geo-near 操作返回一个GeoResults封装GeoResult实例的包装器对象。WrappingGeoResults允许访问所有结果的平均距离。单个GeoResult对象携带找到的实体加上它与原点的距离。