Spring Data MongoDB

The primary goal of the Spring Data project is to make it easier to build Spring-powered applications that use new data access technologies such as non-relational databases, map-reduce frameworks, and cloud based data services.

The Spring Data MongoDB project aims to provide a familiar and consistent Spring-based programming model for new datastores while retaining store-specific features and capabilities. The Spring Data MongoDB project provides integration with the MongoDB document database. Key functional areas of Spring Data MongoDB are a POJO centric model for interacting with a MongoDB Document and easily writing a repository style data access layer.

Code of Conduct

This project is governed by the Spring Code of Conduct. By participating, you are expected to uphold this code of conduct. Please report unacceptable behavior to [email protected].

Getting Started

Here is a quick teaser of an application using Spring Data Repositories in Java:

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 {

  @Override
  protected String getDatabaseName() {
    return "springdata";
  }
}

Maven configuration

Add the Maven dependency:

<dependency>
  <groupId>org.springframework.data</groupId>
  <artifactId>spring-data-mongodb</artifactId>
  <version>${version}</version>
</dependency>

If you’d rather like the latest snapshots of the upcoming major version, use our Maven snapshot repository and declare the appropriate dependency version.

<dependency>
  <groupId>org.springframework.data</groupId>
  <artifactId>spring-data-mongodb</artifactId>
  <version>${version}-SNAPSHOT</version>
</dependency>

<repository>
  <id>spring-snapshot</id>
  <name>Spring Snapshot Repository</name>
  <url>https://repo.spring.io/snapshot</url>
</repository>

Upgrading

Instructions for how to upgrade from earlier versions of Spring Data are provided on the project wiki. Follow the links in the release notes section to find the version that you want to upgrade to.

Getting Help

Having trouble with Spring Data? Wed love to help!

Check the reference documentation, and Javadocs
Learn the Spring basics Spring Data builds on Spring Framework, check the spring.io web-site for a wealth of reference documentation. If you are just starting out with Spring, try one of the guides.
If you are upgrading, check out the changelog for “new and noteworthy” features.
Ask a question - we monitor stackoverflow.com for questions tagged with spring-data-mongodb. You can also chat with the community on Gitter.
Report bugs with Spring Data MongoDB at github.com/spring-projects/spring-data-mongodb/issues.

Reporting Issues

Spring Data uses Github as issue tracking system to record bugs and feature requests. If you want to raise an issue, please follow the recommendations below:

Before you log a bug, please search the issue tracker to see if someone has already reported the problem.
If the issue does not already exist, create a new issue.
Please provide as much information as possible with the issue report, we like to know the version of Spring Data that you are using, the JVM version, Stacktrace, etc.
If you need to paste code, or include a stack trace use Markdown code fences ```.

Guides

The spring.io site contains several guides that show how to use Spring Data step-by-step:

Accessing Data with MongoDB is a very basic guide that shows you how to create a simple application and how to access data using repositories.
Accessing MongoDB Data with REST is a guide to creating a REST web service exposing data stored in MongoDB through repositories.

Examples

Spring Data Examples contains example projects that explain specific features in more detail.

Building from Source

You do not need to build from source to use Spring Data. Binaries are available in repo.spring.io and accessible from Maven using the Maven configuration noted above.

Note	Configuration for Gradle is similar to Maven.

The best way to get started is by creating a Spring Boot project using MongoDB on start.spring.io. Follow this link to build an imperative application and this link to build a reactive one.

However, if you want to try out the latest and greatest, Spring Data MongoDB can be easily built with the Maven wrapper and minimally, JDK 17 (JDK downloads).

In order to build Spring Data MongoDB, you will need to download and install a MongoDB distribution.

Once you have installed MongoDB, you need to start a MongoDB server. It is convenient to set an environment variable to your MongoDB installation directory (e.g. MONGODB_HOME).

To run the full test suite, a MongoDB Replica Set is required.

To run the MongoDB server enter the following command from a command-line:

$ $MONGODB_HOME/bin/mongod --dbpath $MONGODB_HOME/runtime/data --ipv6 --port 27017 --replSet rs0
...
"msg":"Successfully connected to host"

Once the MongoDB server starts up, you should see the message (msg), "Successfully connected to host".

Notice the --dbpath option to the mongod command. You can set this to anything you like, but in this case, we set the absolute path to a sub-directory (runtime/data/) under the MongoDB installation directory (in $MONGODB_HOME).

You need to initialize the MongoDB replica set only once on the first time the MongoDB server is started. To initialize the replica set, start a mongo client:

$ $MONGODB_HOME/bin/mongo
MongoDB server version: 6.0.0
...

Then enter the following command:

mongo> rs.initiate({ _id: 'rs0', members: [ { _id: 0, host: '127.0.0.1:27017' } ] })

Finally, on UNIX-based system (for example, Linux or Mac OS X) you may need to adjust the ulimit. In case you need to, you can adjust the ulimit with the following command (32768 is just a recommendation):

$ ulimit -n 32768

You can use ulimit -a again to verify the ulimit for "open files" was set appropriately.

Now you are ready to build Spring Data MongoDB. Simply enter the following mvnw (Maven Wrapper) command:

 $ ./mvnw clean install

If you want to build with the regular mvn command, you will need Maven v3.8.0 or above.

Also see CONTRIBUTING.adoc if you wish to submit pull requests, and in particular, please sign the Contributors Agreement before your first non-trivial change.

Building reference documentation

Building the documentation builds also the project without running tests.

 $ ./mvnw clean install -Pantora

The generated documentation is available from target/antora/site/index.html.

License

Spring Data MongoDB is Open Source software released under the Apache 2.0 license.

Project Name	Stars	Most Recent Commit	Open Issues	License	Language
Mall	71,773	6 days ago	40	apache-2.0	Java
mall项目是一套电商系统，包括前台商城系统及后台管理系统，基于SpringBoot+MyBatis实现，采用Docker容器化部署。前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。
Interview_internal_reference	34,839	6 months ago	30		Python
2023年最新总结，阿里，腾讯，百度，美团，头条等技术面试题目，以及答案，专家出题人分析汇总。
Spring Boot Examples	29,523	10 days ago	9		Java
about learning Spring Boot via examples. Spring Boot 教程、技术栈示例代码，快速简单上手教程。
Springboot Learning Example	15,343	8 months ago	52	apache-2.0	Java
spring boot 实践学习案例，是 spring boot 初学者及核心技术巩固的最佳实践。
Mall Learning	12,417	15 days ago	27	apache-2.0	Java
mall学习教程，架构、业务、技术要点全方位解析。mall项目（50k+star）是一套电商系统，使用现阶段主流技术实现。涵盖了SpringBoot 2.3.0、MyBatis 3.4.6、Elasticsearch 7.6.2、RabbitMQ 3.7.15、Redis 5.0、MongoDB 4.2.5、Mysql5.7等技术，采用Docker容器化部署。
Mall Swarm	10,846	19 days ago	25	apache-2.0	Java
mall-swarm是一套微服务商城系统，采用了 Spring Cloud 2021 & Alibaba、Spring Boot 2.7、Oauth2、MyBatis、Docker、Elasticsearch、Kubernetes等核心技术，同时提供了基于Vue的管理后台方便快速搭建系统。mall-swarm在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。文档齐全，附带全套Spring Cloud教程。
Spring Data Examples	4,913	21 days ago	18	apache-2.0	Java
Spring Data Example Projects
Passjava Platform	2,099	5 months ago	24	gpl-3.0	Java
一款面试刷题的 Spring Cloud 开源系统。零碎时间利用小程序查看常见面试题，夯实Java基础。该项目可以教会你如何搭建SpringBoot项目，Spring Cloud项目。采用流行的技术，如 SpringBoot、MyBatis、Redis、 MySql、 MongoDB、 RabbitMQ、Elasticsearch，采用Docker容器化部署。
Spring Boot Leaning	2,068	a year ago	1		Java
Spring Boot 2.X 最全课程代码
Springbootlearning	2,003	2 years ago	14		Java
《Spring Boot教程》源码

Spring Data Mongodb