|
此版本仍在开发中，尚未被视为稳定版。如需最新稳定版本，请使用 Spring Data MongoDB 5.0.4！ |
快速开始
一种快速搭建工作环境的简便方法是通过 start.spring.io 创建一个基于 Spring 的项目，或在 Spring Tools 中创建一个 Spring 项目。
示例仓库
GitHub 上的 spring-data-examples 仓库 提供了多个示例，您可以下载并试用这些示例，以了解该库的工作方式。
你好，世界
首先，你需要设置一个正在运行的 MongoDB 服务器。请参阅MongoDB 快速入门指南，了解如何启动 MongoDB 实例。
安装完成后，通常只需运行以下命令即可启动 MongoDB：/bin/mongod
然后你可以创建一个 Person 类来进行持久化：
public class Person {
private String id;
private String name;
private int age;
public Person(String name, int age) {
this.name = name;
this.age = age;
}
public String getId() {
return id;
}
public String getName() {
return name;
}
public int getAge() {
return age;
}
@Override
public String toString() {
return "Person [id=" + id + ", name=" + name + ", age=" + age + "]";
}
}你还需要一个主应用程序来运行：
-
Imperative
-
Reactive
import static org.springframework.data.mongodb.core.query.Criteria.*;
import org.springframework.data.mongodb.core.MongoOperations;
import org.springframework.data.mongodb.core.MongoTemplate;
import com.mongodb.client.MongoClients;
public class MongoApplication {
public static void main(String[] args) throws Exception {
MongoOperations mongoOps = new MongoTemplate(MongoClients.create(), "database");
mongoOps.insert(new Person("Joe", 34));
System.out.println(mongoOps.query(Person.class).matching(where("name").is("Joe")).firstValue());
mongoOps.dropCollection("person");
}
}import static org.springframework.data.mongodb.core.query.Criteria.*;
import org.springframework.data.mongodb.core.ReactiveMongoOperations;
import org.springframework.data.mongodb.core.ReactiveMongoTemplate;
import com.mongodb.reactivestreams.client.MongoClients;
public class ReactiveMongoApplication {
public static void main(String[] args) throws Exception {
ReactiveMongoOperations mongoOps = new ReactiveMongoTemplate(MongoClients.create(), "database");
mongoOps.insert(new Person("Joe", 34))
.then(mongoOps.query(Person.class).matching(where("name").is("Joe")).first())
.doOnNext(System.out::println)
.block();
mongoOps.dropCollection("person").block();
}
}当你运行主程序时，上述示例将产生以下输出：
10:01:32,265 DEBUG o.s.data.mongodb.core.MongoTemplate - insert Document containing fields: [_class, age, name] in collection: Person
10:01:32,765 DEBUG o.s.data.mongodb.core.MongoTemplate - findOne using query: { "name" : "Joe"} in db.collection: database.Person
Person [id=4ddbba3c0be56b7e1b210166, name=Joe, age=34]
10:01:32,984 DEBUG o.s.data.mongodb.core.MongoTemplate - Dropped collection [database.person]即使在这个简单的示例中，也有几点需要注意：
-
您可以使用标准或响应式的
MongoClient对象以及要使用的数据库名称，来实例化 Spring Mongo 的核心辅助类MongoTemplate。 -
该映射器可直接用于标准的 POJO 对象，无需任何额外的元数据（尽管您可以选择性地提供这些信息。请参见此处）。
-
约定用于处理
id字段，在存储到数据库时将其转换为ObjectId。 -
映射约定可以使用字段访问。请注意，
Person类只有 getter 方法。 -
如果构造函数参数名称与存储文档的字段名称相匹配，则使用这些参数来实例化对象。