索引和集合管理

MongoTemplateReactiveMongoTemplate 提供了用于管理索引和集合的方法。这些方法被收集到一个名为 IndexOperationsReactiveIndexOperations 的帮助器接口中。您可以通过调用 indexOps 方法并传入集合名称或实体的 java.lang.Class 来访问这些操作(集合名称从 .class 中派生,通过名称或注释元数据)。

以下列表显示了 IndexOperations 接口

  • 命令式

  • 响应式

public interface IndexOperations {

    String ensureIndex(IndexDefinition indexDefinition);

    void alterIndex(String name, IndexOptions options);

    void dropIndex(String name);

    void dropAllIndexes();

    List<IndexInfo> getIndexInfo();
}
public interface ReactiveIndexOperations {

    Mono<String> ensureIndex(IndexDefinition indexDefinition);

    Mono<Void> alterIndex(String name, IndexOptions options);

    Mono<Void> dropIndex(String name);

    Mono<Void> dropAllIndexes();

    Flux<IndexInfo> getIndexInfo();

创建索引的方法

您可以使用 MongoTemplate 类在集合上创建索引以提高查询性能,如下例所示

  • 命令式

  • 响应式

template.indexOps(Person.class)
    .ensureIndex(new Index().on("name",Order.ASCENDING));
Mono<String> createIndex = template.indexOps(Person.class)
    .ensureIndex(new Index().on("name",Order.ASCENDING));

ensureIndex 确保集合存在一个针对提供的 IndexDefinition 的索引。

您可以使用 IndexDefinitionGeoSpatialIndexTextIndexDefinition 类创建标准、地理空间和文本索引。例如,给定前面部分中定义的 Venue 类,您可以声明一个地理空间查询,如下例所示

template.indexOps(Venue.class)
    .ensureIndex(new GeospatialIndex("location"));
IndexGeospatialIndex 支持配置 校对

访问索引信息

IndexOperations 接口具有 getIndexInfo 方法,该方法返回 IndexInfo 对象的列表。此列表包含在集合上定义的所有索引。以下示例在具有 age 属性的 Person 类上定义一个索引

  • 命令式

  • 响应式

template.indexOps(Person.class)
    .ensureIndex(new Index().on("age", Order.DESCENDING).unique());

List<IndexInfo> indexInfoList = template.indexOps(Person.class)
   .getIndexInfo();
Mono<String> ageIndex = template.indexOps(Person.class)
    .ensureIndex(new Index().on("age", Order.DESCENDING).unique());

Flux<IndexInfo> indexInfo = ageIndex.then(template.indexOps(Person.class)
   .getIndexInfo());

用于处理集合的方法

以下示例显示如何创建集合

  • 命令式

  • 响应式

MongoCollection<Document> collection = null;
if (!template.getCollectionNames().contains("MyNewCollection")) {
    collection = mongoTemplate.createCollection("MyNewCollection");
}
MongoCollection<Document> collection = template.getCollectionNames().collectList()
    .flatMap(collectionNames -> {
        if(!collectionNames.contains("MyNewCollection")) {
            return template.createCollection("MyNewCollection");
        }
        return template.getMongoDatabase().map(db -> db.getCollection("MyNewCollection"));
    });
集合创建允许使用 CollectionOptions 进行自定义,并支持 校对
与 MongoCollections 交互的方法
  • getCollectionNames:返回一组集合名称。

  • collectionExists:检查是否存在具有给定名称的集合。

  • createCollection:创建无上限集合。

  • dropCollection:删除集合。

  • getCollection:按名称获取集合,如果不存在则创建它。

时间序列

MongoDB 5.0 引入了 时间序列 集合,这些集合经过优化,可以高效地存储随时间推移而变化的文档,例如测量值或事件。在插入任何数据之前,需要将这些集合创建为这种类型。可以通过运行 createCollection 命令、定义时间序列集合选项或从 @TimeSeries 注释中提取选项来创建集合,如下面的示例所示。

示例 1. 创建时间序列集合
通过 MongoDB 驱动程序创建时间序列
template.execute(db -> {

    com.mongodb.client.model.CreateCollectionOptions options = new CreateCollectionOptions();
    options.timeSeriesOptions(new TimeSeriesOptions("timestamp"));

    db.createCollection("weather", options);
    return "OK";
});
使用 CollectionOptions 创建时间序列集合
template.createCollection("weather", CollectionOptions.timeSeries("timestamp"));
从注释派生的时间序列集合
@TimeSeries(collection="weather", timeField = "timestamp")
public class Measurement {

    String id;
    Instant timestamp;
    // ...
}

template.createCollection(Measurement.class);

上面的代码段可以轻松地转移到提供相同方法的响应式 API。确保正确订阅返回的发布者。