文档内容来源于 spring.io，由 springdoc.tech 翻译，版权归属于 SPRING.IO (VMware, Inc.)。可供个人学习、研究，未经许可，不得进行转载或用于商业行为。

MongoDB 支持

DeepSeek V3 中英对照 MongoDB Support

Spring Data 对 MongoDB 的支持包含了广泛的功能：

Spring 配置支持，支持基于 Java 的 @Configuration 类或 XML 命名空间，用于 Mongo 驱动实例和副本集。
MongoTemplate 辅助类，在执行常见的 Mongo 操作时提高生产力。包括文档和 POJO 之间的集成对象映射。
异常转换为 Spring 的可移植数据访问异常层次结构。
功能丰富的对象映射，与 Spring 的转换服务集成。
基于注解的映射元数据，可扩展以支持其他元数据格式。
持久化和映射生命周期事件。
基于 Java 的查询、条件和更新 DSL。
自动实现 Repository 接口，包括对自定义查询方法的支持。
QueryDSL 集成，支持类型安全的查询。
多文档事务。
地理空间集成。

对于大多数任务，你应该使用 MongoTemplate 或 Repository 支持，这两者都利用了丰富的映射功能。MongoTemplate 是查找诸如递增计数器或临时 CRUD 操作等访问功能的地方。MongoTemplate 还提供了回调方法，使你能够轻松获取底层 API 构件，例如 com.mongodb.client.MongoDatabase，以便直接与 MongoDB 进行通信。各种 API 构件的命名约定旨在复制基础 MongoDB Java 驱动程序中的命名约定，因此你可以轻松将现有知识映射到 Spring API 上。

章节摘要

📄️ 需求

Spring Data MongoDB 4.x 二进制文件需要 JDK 17 及以上版本以及 Spring Framework 6.2.3 及以上版本。

📄️ 入门指南

一个简单的引导设置工作环境的方法是通过 start.spring.io 创建一个基于 Spring 的项目，或者在 Spring Tools 中创建一个 Spring 项目。

📄️ 连接到 MongoDB

在使用 MongoDB 和 Spring 时，首要任务之一是通过 IoC 容器创建一个 MongoClient 对象。主要有两种方式可以实现这一点，一种是通过基于 Java 的 bean 元数据，另一种是通过基于 XML 的 bean 元数据。

🗃️ 模板 API

6 个项目

📄️ GridFS 支持

MongoDB 支持在其文件系统 GridFS 中存储二进制文件。Spring Data MongoDB 提供了 GridFsOperations 和 ReactiveGridFsOperations 接口，以及相应的实现类 GridFsTemplate 和 ReactiveGridFsTemplate，以便你与文件系统进行交互。你可以通过传递 MongoDatabaseFactory / ReactiveMongoDatabaseFactory 以及 MongoConverter 来设置一个模板实例，如下例所示：

🗃️ 对象映射

6 个项目

📄️ 值表达式基础

值表达式（Value Expressions）是 Spring 表达式语言（SpEL）和属性占位符解析的结合体。它们将程序化表达式的强大评估能力与属性占位符解析的简单性相结合，从而能够从环境（如配置属性）中获取值。

📄️ 生命周期事件

MongoDB 映射框架包含了多个 org.springframework.context.ApplicationEvent 事件，你的应用程序可以通过在 ApplicationContext 中注册特定的 bean 来响应这些事件。由于这些事件基于 Spring 的 ApplicationContext 事件基础设施，因此其他产品（如 Spring Integration）可以轻松接收这些事件，因为它们是基于 Spring 的应用程序中广为人知的事件机制。