image:https://spring.io/badges/spring-data-mongodb/ga.svg[Spring Data MongoDB,link=https://spring.io/projects/spring-data-mongodb#quick-start] image:https://spring.io/badges/spring-data-mongodb/snapshot.svg[Spring Data MongoDB,link=https://spring.io/projects/spring-data-mongodb#quick-start]
= Spring Data MongoDB image:https://jenkins.spring.io/buildStatus/icon?job=spring-data-mongodb%2Fmain&subject=Build[link=https://jenkins.spring.io/view/SpringData/job/spring-data-mongodb/] https://gitter.im/spring-projects/spring-data[image:https://badges.gitter.im/spring-projects/spring-data.svg[Gitter]] image:https://img.shields.io/badge/Revved%20up%20by-Develocity-06A0CE?logo=Gradle&labelColor=02303A["由Develocity提供支持", link="https://ge.spring.io/scans?search.rootProjectNames=Spring Data MongoDB"]
https://spring.io/projects/spring-data[Spring Data]项目的主要目标是使构建使用新数据访问技术(如非关系型数据库、map-reduce框架和基于云的数据服务)的Spring应用程序变得更加容易。
Spring Data MongoDB项目旨在为新的数据存储提供熟悉且一致的基于Spring的编程模型,同时保留特定存储的特性和功能。Spring Data MongoDB项目提供了与MongoDB文档数据库的集成。Spring Data MongoDB的主要功能领域包括一个以POJO为中心的模型,用于与MongoDB的+Document+进行交互,以及轻松编写仓库风格的数据访问层。
[[code-of-conduct]] == 行为准则
[[getting-started]] == 入门指南
以下是一个使用Java编写的Spring Data Repositories的应用程序示例:
public interface PersonRepository extends CrudRepository<Person, Long> {
List<Person> findByLastname(String lastname);
List<Person> findByFirstnameLike(String firstname); }
@Service public class MyService {
private final PersonRepository repository;
public MyService(PersonRepository repository) { this.repository = repository; }
public void doWork() {
repository.deleteAll();
Person person = new Person();
person.setFirstname("Oliver");
person.setLastname("Gierke");
repository.save(person);
List<Person> lastNameResults = repository.findByLastname("Gierke");
List<Person> firstNameResults = repository.findByFirstnameLike("Oli*");
} }
@Configuration @EnableMongoRepositories class ApplicationConfig extends AbstractMongoClientConfiguration {
[[maven-configuration]] === Maven配置
添加Maven依赖:
如果您更喜欢使用即将发布的主要版本的最新快照,请使用我们的Maven快照仓库并声明适当的依赖版本。
[[upgrading]] == 升级
有关如何从Spring Data早期版本升级的说明,请参阅项目https://github.com/spring-projects/spring-data-commons/wiki[wiki]。请点击https://github.com/spring-projects/spring-data-commons/wiki#release-notes[发布说明]部分的链接,找到您想要升级到的版本。
[[getting-help]] == 获取帮助
在使用Spring Data时遇到问题?我们很乐意为您提供帮助!
[[reporting-issues]] == 报告问题
Spring Data使用Github作为问题跟踪系统来记录bug和功能请求。如果您想提出问题,请遵循以下建议:
[[guides]] == 指南
https://spring.io/[spring.io]网站包含几 个逐步展示如何使用Spring Data的指南:
https://spring.io/guides/gs/accessing-mongodb-data-rest/[通过REST访问MongoDB数据]是一个指南,介绍如何创建一个REST Web服务,通过仓库公开存储在MongoDB中的数据。 [[examples]] == 示例
https://github.com/spring-projects/spring-data-examples/[Spring Data 示例] 包含详细解释特定功能的示例项目。
[[building-from-source]] == 从源代码构建
使用 Spring Data 无需从源代码构建。二进制文件可在 https://repo.spring.io[repo.spring.io] 获取,并可通过上述 <<maven-configuration,Maven 配置>> 访问。
注意:Gradle 的配置与 Maven 类似。
最好的入门方式是在 https://start.spring.io[start.spring.io] 上创建一个使用 MongoDB 的 Spring Boot 项目。 点击此 https://start.spring.io/#type=maven-project&language=java&platformVersion=3.0.0&packaging=jar&jvmVersion=17&groupId=com.example&artifactId=demo&name=demo&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.demo&dependencies=data-mongodb[链接] 构建一个命令式应用程序,或点击此 https://start.spring.io/#type=maven-project&language=java&platformVersion=3.0.0&packaging=jar&jvmVersion=17&groupId=com.example&artifactId=demo&name=demo&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.demo&dependencies=data-mongodb-reactive[链接] 构建一个响应式应用程序。
但是,如果你想尝试最新最好的版本,Spring Data MongoDB 可以使用 https://github.com/takari/maven-wrapper[Maven wrapper] 轻松构建, 最低要求是 JDK 17 (https://www.oracle.com/java/technologies/downloads/[JDK 下载])。
要构建 Spring Data MongoDB,你需要 https://www.mongodb.com/try/download/community[下载] 并 https://docs.mongodb.com/manual/installation/[安装 MongoDB 发行版]。
安装 MongoDB 后,你需要启动 MongoDB 服务器。最好将 MongoDB 安装目录设置为环境变量(例如 MONGODB_HOME)。
要运行完整的测试套件,需要一个 https://docs.mongodb.com/manual/tutorial/deploy-replica-set/[MongoDB 副本集]。
要运行 MongoDB 服务器,在命令行中输入以下命令:
MongoDB 服务器启动后,你应该会看到消息(msg)"Successfully connected to host"。
注意 mongod 命令中的 --dbpath 选项。你可以将其设置为任何你喜欢的路径,但在这个例子中,我们将其设置为 MongoDB 安装目录($MONGODB_HOME)下的子目录(runtime/data/)的绝对路径。
你只需在第一次启动 MongoDB 服务器时初始化一次 MongoDB 副本集。 要初始化副本集,启动一个 mongo 客户端:
然后输入以下命令:
最后,在基于 UNIX 的系统(例如 Linux 或 Mac OS X)上,你可能需要调整 ulimit。
如果需要,你可以使用以下命令调整 ulimit(32768 只是一个建议值):
你可以再次使用 ulimit -a 来验证"打开文件"的 ulimit 是否设置正确。
现在你已经准备好构建 Spring Data MongoDB 了。只需输入以下 mvnw(Maven Wrapper)命令:
如果你想使用常规的 mvn 命令构建,你需要 https://maven.apache.org/run-maven/index.html[Maven v3.8.0 或更高版本]。
如果你希望提交拉取请求,请同时查看 link:CONTRIBUTING.adoc[CONTRIBUTING.adoc],特别是在进行第一次非微小更改之前,请签署 https://cla.pivotal.io/sign/spring[贡献者协议]。
=== 构建参考文档
构建文档的同时也会构建项目,但不运行测试。
生成的文档可在 target/antora/site/index.html 中找到。
[[license]] == 许可证
Spring Data MongoDB 是根据 https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 许可证] 发布的开源软件。


全球首个AI音乐社区
音述AI是全球首个AI音乐社区,致力让每个人都能用音乐表达自我。音述AI提供零门槛AI创作工具,独创GETI法则帮助用户精准定义音乐风格,AI润色功能支持自动优化作品质感。音述AI支持交流讨论、二次创作与价值变现。针对中文用户的语言习惯与文化背景进行专门优化,支持国风融合、C-pop等本土音乐标签,让技术更好地承载人文表达。


阿里Qoder团队推出的桌面端AI智能体
QoderWork 是阿里推出的本地优先桌面 AI 智能体,适配 macOS14+/Windows10+,以自然语言交互实现文件管理、数据分析、AI 视觉生成、浏览器自动化等办公任务,自主拆解执行复杂工作流,数据本地运行零上传,技能市场可无限扩展,是高效的 Agentic 生产力办公助手。


一站式搞定所有学习需求
不再被海量信息淹没,开始真正理解知识。Lynote 可摘要 YouTube 视频、PDF、文章等内容。即时创建笔记,检测 AI 内容并下载资料,将您的学习效率提升 10 倍。


为AI短剧协作而生
专为AI短剧协作而生的AniShort正式发布,深度重构AI短剧全流程生产模式,整合创意策划、制作执行、实时协作、在线审片、资产复用等全链路功能,独创无限画布、双轨并行工业化工作流与Ani智能体助手,集成多款主流AI大模型,破解素材零散、版本混乱、沟通低效等行业痛点,助力3人团队效率提升800%,打造标准化、可追溯的AI短剧量产体系,是AI短剧团队协同创作、提升制作效率的核心工具。


能听懂你表达的视频模型
Seedance two是基于seedance2.0的中国大模型,支持图像、视频、音频、文本四种模态输入,表达方式更丰富,生成也更可控。


国内直接访问,限时3折
输入简单文字,生成想要的图片,纳米香蕉中文站基于 Google 模型的 AI 图片生成网站,支持文字生图、图生图。官网价格限时3折活动


职场AI,就用扣子
AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!


多风格AI绘画神器
堆友平台由阿里巴巴设计团队创建,作为一款AI驱动的设计工具,专为设计师提供一站式增长服务。功能覆盖海量3D素材、AI绘画、实时渲染以及专业抠图,显著提升设计品质和效率。平台不仅提供工具,还是一个促进创意交流和个人发展的空间,界面友好,适合所有级别的设计师和创意工作者。


零代码AI应用开发平台
零代码AI应用开发平台,用户只需一句话简单描述需求,AI能自动生成小程序、APP或H5网页应用,无需编写代码。


免费创建高清无水印Sora视频
Vora是一个免费创建高清无水印Sora视频的AI工具
最新AI工具、AI资讯
独家AI资源、AI项目落地

微信扫一扫关注公众号