SpringBoot 集成 MongoDB 实现增删改查功能

在现代应用开发中，SpringBoot 与 MongoDB 的结合可以大大提高开发效率。本文将详细介绍如何在 SpringBoot 中集成 MongoDB，实现对数据的增删改查功能。😊

一、环境准备

在开始之前，请确保已具备以下环境：

• JDK 1.8 或以上版本
• Maven 构建工具
• MongoDB 数据库
• IDE 开发工具（如 IntelliJ IDEA）

二、创建 SpringBoot 项目

1. 使用 Maven 创建项目

   在命令行中执行：

   mvn archetype:generate -DgroupId=com.example -DartifactId=springboot-mongodb -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

   解释：

   • mvn archetype:generate：使用 Maven 的原型生成项目。
   • -DgroupId：指定项目的组 ID。
   • -DartifactId：指定项目的 Artifact ID。
   • -DarchetypeArtifactId：指定使用的原型。
   • -DinteractiveMode=false：非交互模式，自动生成项目。

2. 添加依赖

   在 pom.xml 中添加 MongoDB 依赖：

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

   解释：

   • 引入 spring-boot-starter-data-mongodb，提供与 MongoDB 交互的必要依赖。

三、配置 MongoDB 连接

在 application.properties 中添加 MongoDB 配置：

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

解释：

• spring.data.mongodb.host：MongoDB 的主机地址。
• spring.data.mongodb.port：MongoDB 的端口号，默认 27017。
• spring.data.mongodb.database：要连接的数据库名称。

四、创建实体类

package com.example.springbootmongodb.model;

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 name;
    private int age;

    // Getter 和 Setter 方法
}

解释：

• @Document(collection = "users")：指定对应的 MongoDB 集合名称为 users。
• @Id：标识主键字段 id。
• 定义了用户的基本属性 name 和 age。

五、创建 Repository 接口

package com.example.springbootmongodb.repository;

import com.example.springbootmongodb.model.User;
import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface UserRepository extends MongoRepository<User, String> {
}

解释：

• MongoRepository<User, String>：继承 MongoRepository，指定实体为 User，主键类型为 String。
• @Repository：标识这是一个仓库接口，用于数据持久化操作。

六、编写 Service 层

package com.example.springbootmongodb.service;

import com.example.springbootmongodb.model.User;
import com.example.springbootmongodb.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    // 新增用户
    public User createUser(User user) {
        return userRepository.save(user);
    }

    // 查询所有用户
    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    // 更新用户
    public User updateUser(String id, User user) {
        user.setId(id);
        return userRepository.save(user);
    }

    // 删除用户
    public void deleteUser(String id) {
        userRepository.deleteById(id);
    }
}

解释：

• @Service：标识业务层组件。
• 使用 userRepository 实现对用户的增删改查操作。
• 每个方法对应一个具体的数据库操作。

七、创建 Controller 控制器

package com.example.springbootmongodb.controller;

import com.example.springbootmongodb.model.User;
import com.example.springbootmongodb.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserService userService;

    // 新增用户
    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }

    // 获取所有用户
    @GetMapping
    public List<User> getAllUsers() {
        return userService.getAllUsers();
    }

    // 更新用户
    @PutMapping("/{id}")
    public User updateUser(@PathVariable String id, @RequestBody User user) {
        return userService.updateUser(id, user);
    }

    // 删除用户
    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable String id) {
        userService.deleteUser(id);
    }
}

解释：

• @RestController：组合了 @Controller 和 @ResponseBody，用于构建 RESTful API。
• @RequestMapping("/users")：定义了基础请求路径为 /users。
• @PostMapping、@GetMapping 等注解对应不同的 HTTP 方法。

八、测试应用

启动应用程序，使用工具（如 Postman）发送请求测试：

• 新增用户

  POST http://localhost:8080/users
  Content-Type: application/json
  
  {
      "name": "张三",
      "age": 25
  }

• 获取所有用户

  GET http://localhost:8080/users

• 更新用户

  PUT http://localhost:8080/users/{id}
  Content-Type: application/json
  
  {
      "name": "李四",
      "age": 30
  }

• 删除用户

  DELETE http://localhost:8080/users/{id}

解释：

• 通过不同的 HTTP 方法和 URL，调用相应的增删改查接口。
• {id} 需要替换为实际的用户 ID。

九、工作流程图

graph LR
A[客户端请求] --> B[Controller 接收请求]
B --> C[Service 处理业务逻辑]
C --> D[Repository 访问数据库]
D --> E[MongoDB 存储数据]
E --> D
D --> C
C --> B
B --> A

十、总结

通过以上步骤，我们成功地在 SpringBoot 中集成了 MongoDB，并实现了基本的增删改查功能。MongoDB 的灵活性与 SpringBoot 的简洁性相结合，可以让开发者更加高效地构建应用程序。🚀

提示：在实际应用中，可以根据需求扩展更多功能，如添加分页查询、字段校验等。