springboot集成mongodb 小白

### Spring Boot 集成 MongoDB 教程

#### 1. 准备工作
为了创建一个基于 Spring Boot 和 MongoDB 的应用程序，需要先设置开发环境。这包括安装 Java Development Kit (JDK)，配置好 IDE 如 Eclipse 或 IntelliJ IDEA，并确保已安装 Maven 构建工具。

#### 2. 使用 Spring Initializr 初始化项目
访问 [Spring Initializr](https://start.spring.io/) 并按照如下选项来初始化一个新的 Spring Boot 应用程序[^4]:
- **Group**: com.example
- **Artifact Id**: spring-boot-mongodb-demo
- 添加依赖项 `Spring Web` 和 `Spring Data MongoDB`

点击 "Generate Project" 下载 ZIP 文件解压到本地文件夹并将此工程导入至所选的IDE中。

#### 3. 修改 application.properties 文件
编辑 src/main/resources/application.properties 文件以连接到 MongoDB 数据库实例：

spring.data.mongodb.uri=mongodb://localhost:27017/testdb

这里假设 MongoDB 正在 localhost 上运行，默认端口为 27017；testdb 是要使用的数据库名称。

#### 4. 定义实体类
定义代表集合中的文档的数据模型。例如，在包下新建名为 User.java 的 POJO 类:

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;

    // Getters and Setters...
}

#### 5. 编写 Repository 接口
创建接口继承自 MongoRepository<T, ID> ，其中 T 表示实体类型而 ID 则表示主键字段类型。比如下面的例子展示了如何编写针对用户的仓库接口：

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

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

#### 6. 实现服务层逻辑
实现业务处理功能的服务组件可以调用上述存储库方法完成 CRUD 操作。Service 层通常负责协调多个领域对象之间的交互并执行验证等操作。

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    public List<User> findAll() {return userRepository.findAll();}
    
    public Optional<User> findById(String id){return userRepository.findById(id);}
   
    public void save(User user){
        userRepository.save(user);
    }
    
    public boolean deleteById(String id){
       return userRepository.deleteById(id).wasAcknowledged();
    }

}

#### 7. 控制器暴露 API 终结点
最后一步是在控制器里公开 HTTP 请求映射以便外部客户端能够与应用通信。以下是简单的 RESTful web service 示例：

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

    @Autowired
    private UserService userService;

    @GetMapping("")
    public ResponseEntity<List<User>> getAllUsers(){
        return new ResponseEntity<>(userService.findAll(), HttpStatus.OK);
    }

    @PostMapping("")
    public ResponseEntity<String> createUser(@RequestBody User newUser){
        userService.save(newUser);
        return new ResponseEntity<>("User created successfully",HttpStatus.CREATED);
    }

    @PutMapping("/{id}")
    public ResponseEntity<String> updateUser(@PathVariable("id")String userId,@RequestBody User updatedUserDetails){
         if(!userService.existsById(userId)){
             throw new ResourceNotFoundException("Not found User with id "+userId);
         }else{
            updatedUserDetails.setId(userId);
            userService.save(updatedUserDetails);
            return new ResponseEntity<>("User Updated Successfully",HttpStatus.NO_CONTENT);
         }
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable("id")String userId){
          if (!userService.existsById(userId)) {
              throw new ResourceNotFoundException("Not found User with id " + userId);
           } else {
               userService.deleteById(userId);
               return new ResponseEntity<>(HttpStatus.ACCEPTED);
           }
     }
}

以上即完成了基本的 Spring Boot 集成 MongoDB 的入门级教程介绍。通过这些步骤，开发者可以获得有关如何利用 Spring Boot 连接 NoSQL 数据库的知识基础。