Node.js 与 MongoDB 快速入门

你好，未来的数据库大师们！今天，我们将踏上一段激动人心的旅程，探索 Node.js 和 MongoDB 的世界。作为你友好邻里的计算机老师，我将引导你完成这次冒险，一步一步。别担心你编程新手——我们将从最基础的知识开始，逐步学习。那么，戴上你的虚拟安全帽，让我们一起潜入水中吧！

MongoDB 是什么？

在开始编码之前，让我们了解一下 MongoDB 是怎么回事。想象你正在整理你的漫画书收藏。你可能会有不同的盒子来装 Marvel、DC 和独立漫画。MongoDB 就像是一个巨大的数字漫画书整理器，用于你的数据。它是一个 NoSQL 数据库，这意味着它非常灵活，可以处理各种类型的数据，而不需要一个严格的结构。

安装

第一步：安装 Node.js

首先，我们需要安装 Node.js。这就像在开始一个项目之前设置你的工作台。

1. 访问 Node.js 官方网站（https://nodejs.org/）。
2. 下载适合你操作系统的版本。
3. 按照安装向导进行安装。

为了检查 Node.js 是否正确安装，打开你的终端或命令提示符并输入：

node --version

如果你看到了版本号，那么你就准备好了！

第二步：安装 MongoDB

现在，让我们安装 MongoDB —— 我们的数字漫画书整理器。

1. 访问 MongoDB 下载页面（https://www.mongodb.com/try/download/community）。
2. 选择你的操作系统并下载安装程序。
3. 运行安装程序并按照提示操作。

安装完成后，你可能需要将 MongoDB 添加到系统的环境变量中。别担心；这听起来比实际操作要可怕。这就像告诉你的计算机在你想使用 MongoDB 时去哪里找它。

MongoDB 驱动

现在我们有了工具，我们需要一种方法让 Node.js 与 MongoDB 通信。这就是 MongoDB 驱动的作用。把它想象成 Node.js 和 MongoDB 之间的翻译。

安装 MongoDB 驱动

打开你的终端，导航到你的项目文件夹，并运行：

npm init -y
npm install mongodb

第一个命令设置你的项目，第二个命令安装 MongoDB 驱动。这就像打开你的工具箱，确保你有所有正确的工具。

连接到 MongoDB

好吧，现在到了激动人心的部分 —— 连接到我们的数据库！让我们编写一些代码来实现这一点。

在你的项目文件夹中创建一个名为 app.js 的新文件，并添加以下代码：

const { MongoClient } = require('mongodb');

// 连接 URL
const url = 'mongodb://localhost:27017';

// 数据库名
const dbName = 'myProject';

// 创建一个新的 MongoClient
const client = new MongoClient(url);

// 使用 connect 方法连接到服务器
async function connect() {
try {
await client.connect();
console.log("成功连接到服务器");

const db = client.db(dbName);

// 在这里执行数据库操作

} catch (err) {
console.error("连接数据库时发生错误", err);
} finally {
await client.close();
}
}

connect();

让我们分解一下：

1. 我们从 MongoDB 驱动中导入 MongoClient。
2. 我们指定了我们的 MongoDB 服务器正在运行的 URL。localhost:27017 是本地安装的默认值。
3. 我们给我们的数据库起了一个名字，myProject。
4. 我们使用我们的 URL 创建了一个新的 MongoClient。
5. 我们定义了一个名为 connect() 的 async 函数。异步函数就像耐心的朋友，他们会等待任务完成后再继续。
6. 在 connect() 中，我们使用 try/catch/finally 来优雅地处理可能的错误。
7. 我们使用 await client.connect() 连接到服务器。await 关键字就像说，“等等，让我们等这个完成再继续”。
8. 如果连接成功，我们记录一条消息并获得对我们数据库的引用。
9. 最后，我们在 finally 块中关闭连接。

要运行这个代码，保存文件并在终端中输入 node app.js。如果一切设置正确，你应该会在控制台中看到“成功连接到服务器”的打印信息。

恭喜你！你已经使用 Node.js 成功连接到了 MongoDB。这就像打出了你的第一个电话——激动人心，对吧？

执行数据库操作

现在我们连接上了，让我们做一些事情。我们将添加一个简单的操作来插入一个文档到集合中。

更新你的 app.js 文件：

// ... (之前的代码保持不变)

async function connect() {
try {
await client.connect();
console.log("成功连接到服务器");

const db = client.db(dbName);
const collection = db.collection('superheroes');

// 插入一个文档
const result = await collection.insertOne({
name: '蜘蛛侠',
realName: '彼得·帕克',
powers: ['射蛛丝', '蜘蛛感应', '超人的力量']
});

console.log(`插入文档的 _id: ${result.insertedId}`);

} catch (err) {
console.error("执行数据库操作时发生错误", err);
} finally {
await client.close();
}
}

connect();

这里新增了什么：

1. 我们创建了一个名为 'superheroes' 的集合的引用。
2. 我们使用 insertOne() 方法将一个新文档添加到我们的集合中。
3. 我们记录插入文档的 _id。

再次运行脚本，使用 node app.js。你应该看到一条消息，确认一个文档被插入，以及它的 _id。

检索数据

让我们再添加一个操作来检索我们刚刚插入的文档：

// ... (之前的代码保持不变)

async function connect() {
try {
await client.connect();
console.log("成功连接到服务器");

const db = client.db(dbName);
const collection = db.collection('superheroes');

// 插入一个文档
const insertResult = await collection.insertOne({
name: '蜘蛛侠',
realName: '彼得·帕克',
powers: ['射蛛丝', '蜘蛛感应', '超人的力量']
});

console.log(`插入文档的 _id: ${insertResult.insertedId}`);

// 查找刚刚插入的文档
const findResult = await collection.findOne({ name: '蜘蛛侠' });
console.log("找到的文档:", findResult);

} catch (err) {
console.error("执行数据库操作时发生错误", err);
} finally {
await client.close();
}
}

connect();

现在我们使用 findOne() 来检索我们刚刚插入的文档。就像问我们的数据库，“嘿，你能帮我找到蜘蛛侠吗？”

最后一次运行脚本。你应该在控制台中看到文档插入消息和找到的文档。

结论

恭喜你！你已经进入了 Node.js 和 MongoDB 的世界。我们涵盖了安装、连接和基本操作。记住，学习与数据库工作就像学习一种新的超能力——需要练习，但很快你将能够像专业人士一样操作数据！

以下是我们使用过的方法的快速总结：

方法	描述
MongoClient.connect()	连接到 MongoDB 服务器
client.db()	获取数据库的引用
db.collection()	获取集合的引用
collection.insertOne()	将单个文档插入集合
collection.findOne()	在集合中查找单个文档

继续练习，保持好奇心，很快你将能够使用 Node.js 和 MongoDB 构建惊人的应用程序。快乐编码，未来的数据库超级英雄！

Credits: Image by storyset