认识 Express 并创建基本的 Web 服务器

文章目录

• 认识 Express 并创建基本的 Web 服务器 🚀
• • 1. 什么是 Express？ 🤔
  • • 1.1 Express 的特点
  • 2. 安装 Express 💻
  • • 2.1 初始化 Node.js 项目
    • 2.2 安装 Express
  • 3. 创建一个基本的 Web 服务器 🖥️
  • • 3.1 创建 `app.js`
    • 3.2 代码解析
    • 3.3 运行 Web 服务器
  • 4. Express 路由系统 🚪
  • • 4.1 使用不同的 HTTP 请求方法
    • • 示例：处理不同 HTTP 方法的路由
    • 4.2 路由参数
    • • 示例：使用路由参数
    • 4.3 处理查询参数
    • • 示例：处理查询参数
  • 5. 中间件的使用 🛠️
  • • 5.1 使用内置中间件
    • 5.2 自定义中间件
    • 5.3 使用中间件处理错误
  • 6. 总结 🏁
  • • 你已经学到了：

认识 Express 并创建基本的 Web 服务器 🚀

在 Node.js 中，Express 是一个非常流行的 Web 应用框架，它简化了构建 Web 服务器和处理请求的过程。Express 提供了许多强大的功能，如路由、中间件、模板引擎支持等，使得开发 Web 应用变得更加简单和高效。

本文将带你认识 Express，并展示如何使用它来创建一个基本的 Web 服务器。

1. 什么是 Express？ 🤔

Express 是一个基于 Node.js 平台构建的 Web 应用框架，它简化了 Node.js 中原生 HTTP 模块的使用，让你可以更轻松地创建 Web 服务器和 RESTful API。Express 提供了许多用于处理 HTTP 请求、路由、中间件等常见操作的工具，使得开发人员能够专注于业务逻辑，而不必重复实现基础功能。

1.1 Express 的特点

• 简洁的 API：Express 提供了简洁、灵活的 API，帮助开发者高效构建 Web 应用。
• 中间件支持：Express 支持中间件，允许开发者在请求和响应之间进行处理。
• 路由系统：提供了灵活的路由功能，能够根据 HTTP 请求方法（GET、POST、PUT、DELETE）和 URL 路径定义路由。
• 模板引擎支持：支持多种模板引擎（如 EJS、Pug）来渲染动态网页。
• 扩展性：Express 具有良好的扩展性，允许开发者通过插件和中间件扩展其功能。

2. 安装 Express 💻

首先，我们需要安装 Express。你需要确保已安装了 Node.js 和 npm（Node 包管理器）。如果你还没有安装，可以访问 Node.js 官网 进行安装。

2.1 初始化 Node.js 项目

在终端中，首先进入你的项目文件夹，使用以下命令初始化一个 Node.js 项目：

npm init -y

这会创建一个 package.json 文件，用于管理项目的依赖和配置。

2.2 安装 Express

通过 npm 安装 Express：

npm install express

安装完成后，你会在 node_modules 目录下看到 express 包。

3. 创建一个基本的 Web 服务器 🖥️

安装完 Express 后，我们就可以开始创建一个简单的 Web 服务器了。我们将创建一个基本的 HTTP 服务器，响应客户端的请求。

3.1 创建 app.js

在项目根目录下创建一个文件 app.js，并添加以下代码：

// 引入 Express 模块
const express = require('express');

// 创建一个 Express 应用
const app = express();

// 定义一个路由，响应 GET 请求
app.get('/', (req, res) => {
res.send('Hello, World!');
});

// 设置服务器监听的端口
const PORT = 3000;
app.listen(PORT, () => {
console.log(`Server is running at http://localhost:${PORT}`);
});

3.2 代码解析

• 引入 Express：const express = require('express'); 通过 require() 引入 Express 模块。
• 创建 Express 应用：const app = express(); 使用 express() 创建一个 Express 应用实例。
• 定义路由：app.get('/', (req, res) => {…}) 定义一个 GET 路由，响应根路径 / 的请求。req 是请求对象，res 是响应对象，我们通过 res.send() 返回响应内容。
• 启动服务器：app.listen(PORT, () => {…}) 启动服务器并监听指定端口（本例为 3000）。当服务器启动时，打印服务器运行的地址。

3.3 运行 Web 服务器

在终端中运行以下命令启动服务器：

node app.js

此时，服务器会启动并监听在 http://localhost:3000。打开浏览器并访问该地址，你应该能够看到 Hello, World! 的响应。

4. Express 路由系统 🚪

Express 提供了丰富的路由功能，支持处理不同的 HTTP 请求方法（如 GET、POST、PUT、DELETE）以及路由参数。

4.1 使用不同的 HTTP 请求方法

Express 允许我们为不同的 HTTP 请求方法定义路由。常见的方法有：

• GET：用于请求获取资源（常用于读取数据）。
• POST：用于提交数据（常用于提交表单、创建资源）。
• PUT：用于更新资源。
• DELETE：用于删除资源。

示例：处理不同 HTTP 方法的路由

app.get('/', (req, res) => {
res.send('This is a GET request');
});

app.post('/', (req, res) => {
res.send('This is a POST request');
});

app.put('/', (req, res) => {
res.send('This is a PUT request');
});

app.delete('/', (req, res) => {
res.send('This is a DELETE request');
});

你可以通过不同的 HTTP 请求方法来访问这些路由，表达不同的操作。

4.2 路由参数

Express 支持在路由中定义动态参数，这对于构建 RESTful API 非常有用。例如，你可以通过 URL 路径参数来获取请求的特定资源。

示例：使用路由参数

app.get('/user/:id', (req, res) => {
const userId = req.params.id; // 获取路径参数
res.send(`User ID: ${userId}`);
});

如果你访问 http://localhost:3000/user/123，服务器会返回 User ID: 123。

4.3 处理查询参数

查询参数通常用于传递额外的查询信息，格式为 ?key=value。你可以通过 req.query 访问查询参数。

示例：处理查询参数

app.get('/search', (req, res) => {
const query = req.query.q; // 获取查询参数 q
res.send(`Search query: ${query}`);
});

访问 http://localhost:3000/search?q=Node.js 时，服务器会返回 Search query: Node.js。

5. 中间件的使用 🛠️

Express 的强大之处在于其支持中间件（middleware）。中间件是用于处理请求、响应的函数，位于请求和响应之间。你可以使用中间件来进行日志记录、认证、解析请求体等操作。

5.1 使用内置中间件

Express 提供了多个内置中间件，比如 express.json()、express.urlencoded()，用于解析请求体。

// 解析 JSON 请求体
app.use(express.json());

// 解析 URL 编码的请求体
app.use(express.urlencoded({ extended: true }));

5.2 自定义中间件

你还可以定义自己的中间件函数。例如，记录请求日志：

app.use((req, res, next) => {
console.log(`${req.method} ${req.url}`);
next(); // 调用下一个中间件或路由
});

next() 用于将请求传递给下一个中间件或路由。如果没有调用 next()，请求将不会继续处理。

5.3 使用中间件处理错误

错误处理中间件需要有四个参数：err, req, res, next。Express 会在遇到错误时自动调用它。

app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).send('Something went wrong!');
});

6. 总结 🏁

Express 是一个强大且灵活的 Web 应用框架，它让开发 Web 服务器和 API 变得简单。通过路由、中间件、模板引擎等功能，Express 提供了构建现代 Web 应用所需的所有基础设施。

你已经学到了：

• 如何安装和使用 Express。
• 如何创建一个基本的 Web 服务器并处理 HTTP 请求。
• 如何使用路由来处理不同的 HTTP 请求方法和路径。
• 如何使用中间件来扩展应用的功能。

希望你通过本文对 Express 有了更深入的了解，并能在自己的项目中应用这些技术，构建更强大、更灵活的 Web 应用！