【学习资料】玩转 Nest.js 和 MongoDB：从入门到实践

引言

MongoDB 是一种广泛使用的 NoSQL 数据库，以其灵活性和可扩展性而闻名。而 Nest.js 则是一个现代化的 Node.js 框架，能够帮助我们构建高效的服务。今天，我们就来聊聊如何在 Nest.js 中使用 MongoDB，轻松搞定数据管理！

1. 准备工作：安装 MongoDB 和依赖包

首先，确保您在本地或服务器上安装了 MongoDB（可以使用 Docker 快速启动）。接着，在 Nest.js 项目中安装 Mongoose，这是与 MongoDB 交互的 ODM（对象数据建模）库。

bash复制代码npm install @nestjs/mongoose mongoose

2. 配置 Mongoose 模块

在 Nest.js 中，我们需要在 AppModule 中引入并配置 Mongoose 模块，连接到 MongoDB 数据库。

代码示例：

在 app.module.ts 中进行配置：

import { Module } from '@nestjs/common';
import { MongooseModule } from '@nestjs/mongoose';

@Module({
  imports: [
    MongooseModule.forRoot('mongodb://localhost/nest'),
  ],
})
export class AppModule {}

解释：这段代码将连接到本地 MongoDB 数据库 nest。连接成功后，Nest.js 就可以与 MongoDB 进行数据交互了。

3. 创建模型和架构

在使用 MongoDB 之前，我们需要定义数据模型和架构。比如，创建一个简单的用户模型。

代码示例：

在 user.schema.ts 中定义用户模型：

import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
import { Document } from 'mongoose';

export type UserDocument = User & Document;

@Schema()
export class User {
  @Prop({ required: true })
  name: string;

  @Prop({ required: true })
  email: string;

  @Prop({ default: Date.now })
  createdAt: Date;
}

export const UserSchema = SchemaFactory.createForClass(User);

解释：我们使用 @Schema 装饰器定义模型，使用 @Prop 来指定属性及其规则（如必填或默认值）。

4. 创建用户服务

接下来，我们需要创建一个用户服务来处理与 MongoDB 的交互。

代码示例：

在 user.service.ts 中实现用户服务：

import { Injectable } from '@nestjs/common';
import { InjectModel } from '@nestjs/mongoose';
import { Model } from 'mongoose';
import { User, UserDocument } from './user.schema';

@Injectable()
export class UserService {
  constructor(@InjectModel(User.name) private userModel: Model<UserDocument>) {}

  async createUser(name: string, email: string): Promise<User> {
    const newUser = new this.userModel({ name, email });
    return newUser.save();
  }

  async findAllUsers(): Promise<User[]> {
    return this.userModel.find().exec();
  }
}

解释：在 UserService 中，我们使用 @InjectModel 注入模型，通过 createUser 方法保存新用户，通过 findAllUsers 方法获取所有用户。

5. 创建用户控制器

最后，创建一个控制器来处理 HTTP 请求并返回响应。

代码示例：

在 user.controller.ts 中实现用户控制器：

import { Controller, Post, Body, Get } from '@nestjs/common';
import { UserService } from './user.service';
import { User } from './user.schema';

@Controller('users')
export class UserController {
  constructor(private readonly userService: UserService) {}

  @Post()
  async create(@Body() body: { name: string; email: string }): Promise<User> {
    return this.userService.createUser(body.name, body.email);
  }

  @Get()
  async findAll(): Promise<User[]> {
    return this.userService.findAllUsers();
  }
}

解释：UserController 提供了两个端点，一个用于创建用户，另一个用于获取所有用户。

6. 总结

通过以上步骤，我们成功在 Nest.js 项目中集成了 MongoDB，创建了用户模型、服务和控制器，实现了基本的数据增删改查功能。MongoDB 和 Nest.js 的结合能够极大提高开发效率，灵活应对各种业务需求。希望大家能在项目中灵活运用，让数据管理变得轻松愉快！