【Java系列】SpringBoot 集成MongoDB 详细介绍

写在前面

在Spring Boot中集成MongoDB的过程相对简单，以下是一个基本的步骤指南。确保项目已经使用了Spring Boot，并且你已经在项目中添加了MongoDB的依赖。

一、步骤介绍

步骤 1: 添加 MongoDB 依赖

在

pom.xml

文件中，添加 MongoDB 的依赖。可以在 Maven 或 Gradle 中选择一种方式。

<dependencies>
    <!-- 其他依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-mongodb</artifactId>
    </dependency>
</dependencies>

dependencies {
    // 其他依赖
    implementation 'org.springframework.boot:spring-boot-starter-data-mongodb'
}

步骤 2: 配置 MongoDB 连接信息

在

application.properties

或

application.yml

中添加 MongoDB 连接信息：

spring.data.mongodb.host=localhost
spring.data.mongodb.port=27017
spring.data.mongodb.database=mydatabase

yml格式：

spring:
  data:
    mongodb:
      host: localhost
      port: 27017
      database: mydatabase

步骤 3: 创建实体类

创建一个简单的实体类，用于映射到 MongoDB 中的文档。例如：

import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;

@Document(collection = "users")
public class User {
    
    @Id
    private String id;
    private String username;
    private String email;

    // 省略构造函数、getter和setter等
}

步骤 4: 创建 Repository 接口

创建一个继承自

MongoRepository

的接口，用于对 MongoDB 中的文档进行操作。例如：

import org.springframework.data.mongodb.repository.MongoRepository;

public interface UserRepository extends MongoRepository<User, String> {
    // 可以在这里定义一些自定义的查询方法
}

步骤 5: 使用 Repository 进行操作

在服务层或控制器中注入

UserRepository

，然后可以使用该接口提供的方法来进行数据库操作。例如：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    private final UserRepository userRepository;

    @Autowired
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public void saveUser(User user) {
        userRepository.save(user);
    }

    public User getUserById(String id) {
        return userRepository.findById(id).orElse(null);
    }

    // 其他操作...
}

以上步骤涵盖了基本的集成。可以根据项目的需要进行更复杂的配置和操作，例如定义索引、复杂查询等。

二、特殊处理

在使用

spring-boot-starter-data-mongodb

时，不需要显式指定

spring-data-mongodb

的版本，Spring Boot会确保它们兼容并自动管理版本冲突。

如果你正在使用一个不是最新的Spring Boot版本，你可能需要查看相应版本的文档或POM文件，以确保你使用的

spring-boot-starter-data-mongodb

版本与

spring-data-mongodb

版本兼容。

但是，有时候需要单独指定MongoDB的版本，你可以在

pom.xml

文件中添加相应的依赖项，并指定版本号。以下是一个示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb</artifactId>
    <version>2.7.0</version> <!-- 请根据你需要的版本进行替换 -->
</dependency>

<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-mongodb</artifactId>
    <version>3.4.1</version> <!-- 请根据你需要的版本进行替换 -->
</dependency>