node.js+postman+mongodb搭建测试注册接口的实现

首先，我们需要明确注册接口需要实现哪些功能，一般来说，注册接口需要接收用户提交的信息（例如用户名和密码），对这些信息进行验证，如果验证通过，则将用户的信息保存到数据库中并返回成功信息，否则返回验证失败信息。

下面是搭建测试注册接口的完整攻略：

1. 环境准备

在开始之前，我们需要安装和配置以下几个工具：

• Node.js：用于运行后端服务
• Postman：用于测试接口
• MongoDB：用于存储数据

建议先安装好 Node.js 和 MongoDB，然后再从 Chrome 应用商店安装 Postman 插件。

2. 创建项目

打开命令行工具（例如 Windows 的 cmd 或者 Mac 的 Terminal），输入以下命令：

mkdir register-api-demo && cd register-api-demo
npm init -y

这会创建一个名为 register-api-demo 的目录，并在该目录下创建一个 package.json 文件，用于管理项目的依赖和配置。

接着，我们安装 Express.js 和一些相关的库：

npm install express body-parser mongoose --save

express 是 Node.js 的 Web 框架，body-parser 用于解析请求体中的数据，mongoose 用于操作 MongoDB 数据库。

3. 创建数据模型

在 register-api-demo 目录下，创建一个名为 models 的目录，并在该目录下创建一个名为 User.js 的文件，用于定义用户数据模型。

const mongoose = require('mongoose');
const Schema = mongoose.Schema;

const UserSchema = new Schema({
  username: {
    type: String,
    required: [true, 'Username is required.'],
    unique: true
  },
  password: {
    type: String,
    required: [true, 'Password is required.']
  },
  email: {
    type: String,
    required: [true, 'Email is required.'],
    unique: true
  }
});

module.exports = mongoose.model('User', UserSchema);

上面的代码定义了一个名为 User 的数据模型，并规定 username、password、email 这三个字段都是必填项，并且 username 和 email 不能重复。

4. 创建路由

在 register-api-demo 目录下，创建一个名为 routes 的目录，并在该目录下创建一个名为 users.js 的文件，用于定义用户相关的路由。

const express = require('express');
const router = express.Router();
const User = require('../models/User');

router.post('/register', (req, res) => {
  const { username, password, email } = req.body;
  const user = new User({ username, password, email });
  user.save()
    .then(() => res.status(201).json({ message: 'User created successfully.' }))
    .catch(err => res.status(400).json({ error: err.message }));
});

module.exports = router;

上面的代码定义了一个名为 users 的路由，其中定义了一个名为 /register 的 POST 请求，当接收到此请求时将会调用一个回调函数，该函数负责创建一个新用户并将其保存到数据库中。如果保存成功，则返回状态码 201 和成功信息，如果保存失败，则返回状态码 400 和错误信息。

5. 创建服务器

在 register-api-demo 目录下，创建一个名为 index.js 的文件，用于创建服务器并启动应用。

const express = require('express');
const bodyParser = require('body-parser');
const mongoose = require('mongoose');
const usersRouter = require('./routes/users');

const app = express();
const port = process.env.PORT || 3000;

mongoose.connect('mongodb://localhost:27017/register-api', { useNewUrlParser: true });

app.use(bodyParser.json());
app.use('/api/users', usersRouter);

app.listen(port, () => console.log(`Server started on port ${port}.`));

上面的代码创建了一个 Express.js 实例，指定了监听的端口号，并连接了 MongoDB 数据库。另外，还注册了一个名为 /api/users 的路由，用于处理用户相关的请求。

6. 测试接口

在命令行工具中输入以下命令，启动应用：

node index.js

启动成功后，在 Postman 中测试接口。

示例 1：测试成功创建用户

• 请求方法：POST
• 请求 URL：http://localhost:3000/api/users/register
• 请求头：Content-Type: application/json
• 请求体：

{
  "username": "hello",
  "password": "world",
  "email": "[e-mail]"
}

• 响应：

{
  "message": "User created successfully."
}

示例 2：测试创建用户失败（用户名已存在）

• 请求方法：POST
• 请求 URL：http://localhost:3000/api/users/register
• 请求头：Content-Type: application/json
• 请求体：

{
  "username": "hello",
  "password": "world",
  "email": "[e-mail]"
}

• 响应：

{
  "error": "User validation failed: username: Error, expected `username` to be unique. Value: `hello`"
}

到此为止，我们完成了一个完整的注册接口，并且可以通过 Postman 进行测试。当然，在实际开发中，可能还需要增加一些额外的功能，例如密码加密、邮箱格式验证等。