Node.js 编程实战:Express 基础

在 Node.js 后端开发中,Express 是使用最广泛的 Web 框架之一。它在 Node.js 原生 HTTP 模块之上进行了封装,提供了更加简洁、灵活的接口,用于构建 Web 应用和 API 服务。Express 并不追求功能的"全家桶",而是强调轻量和可扩展,这也正是它长期流行的重要原因。

本文将从 Express 的基本概念出发,介绍其核心用法和常见开发模式。


一、为什么选择 Express

Node.js 自带的 HTTP 模块虽然功能完整,但在实际开发中,处理路由、参数解析、错误处理等内容时会显得较为繁琐。Express 对这些常见需求进行了抽象,让开发者可以更加专注于业务逻辑本身。

Express 的优势主要体现在结构清晰、学习成本低以及生态成熟。大量中间件和社区实践,使得 Express 适合从小型项目到中大型服务的不同场景。


二、创建第一个 Express 应用

在已有 Node.js 环境的前提下,首先需要安装 Express。

bash 复制代码
npm install express

创建一个最简单的服务示例:

js 复制代码
const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello Express');
});

app.listen(3000, () => {
  console.log('server running on port 3000');
});

运行后访问浏览器,即可看到返回结果。这也是大多数 Express 应用的起点。


三、路由的基本使用

路由是 Express 中最核心的概念之一,用于定义请求路径与处理逻辑之间的映射关系。

js 复制代码
app.get('/users', (req, res) => {
  res.json({ list: [] });
});

app.post('/users', (req, res) => {
  res.send('create user');
});

Express 根据请求方法和路径匹配对应的路由处理函数,顺序匹配非常重要。


四、请求对象与响应对象

在路由处理中,最常用的是 reqres 对象。

req 用于获取请求信息,例如参数、请求头、请求体等; res 用于向客户端返回响应。

js 复制代码
app.get('/detail', (req, res) => {
  const id = req.query.id;
  res.send(`id is ${id}`);
});

理解这两个对象的常用属性,是编写 Express 接口的基础。


五、中间件的概念

中间件是 Express 的核心机制,用于在请求和响应之间执行通用逻辑。

js 复制代码
app.use((req, res, next) => {
  console.log(req.method, req.url);
  next();
});

中间件可以用于日志记录、权限校验、参数处理等场景。只有调用 next,请求才会继续向下传递。


六、解析请求体数据

在实际开发中,经常需要处理 POST 请求的请求体数据。

js 复制代码
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

配置完成后,可以通过 req.body 直接访问提交的数据。


七、静态资源服务

Express 也可以用于提供静态资源服务,例如图片、前端构建产物等。

js 复制代码
app.use(express.static('public'));

这样可以直接通过 URL 访问指定目录下的文件。


八、错误处理基础

Express 提供了统一的错误处理中间件机制。

js 复制代码
app.use((err, req, res, next) => {
  res.status(500).send('server error');
});

集中处理错误,有助于保持业务代码的简洁性和一致性。


九、Express 项目结构建议

一个常见的 Express 项目结构包括:

  • 路由层,负责接口定义
  • 控制层,处理业务逻辑
  • 服务层,封装数据访问
  • 中间件层,处理通用功能

合理的结构可以显著提升项目的可维护性。


十、总结

Express 是 Node.js 生态中最成熟、最稳定的 Web 框架之一。它在保持灵活性的同时,为开发者提供了足够的约束和规范,非常适合作为后端开发的入门与实战框架。

掌握 Express 的基础用法,是深入学习 Node.js Web 开发的关键一步。

相关推荐
大鸡腿同学1 小时前
【成长类】《只有偏执狂才能生存》读书笔记:程序员的偏执型成长地图
后端
0xDevNull2 小时前
MySQL数据冷热分离详解
后端·mysql
研究点啥好呢2 小时前
Github热门项目推荐 | 创建你的像素风格!
c++·python·node.js·github·开源软件
xiaotao1312 小时前
第九章:Vite API 参考手册
前端·vite·前端打包
AI袋鼠帝2 小时前
OpenClaw(龙虾)最强开源对手!Github 40K Star了,又一个爆火的Agent..
后端
午安~婉2 小时前
Electron桌面应用聊天(续)
前端·javascript·electron
彧翎Pro2 小时前
基于 RO1 noetic 配置 robosense Helios 32(速腾) & xsense mti 300
前端·jvm
小码哥_常3 小时前
解锁系统设置新姿势:Activity嵌入全解析
前端
之歆3 小时前
前端存储方案对比:Cookie-Session-LocalStorage-IndexedDB
前端
哟哟耶耶3 小时前
vue3-单文件组件css功能(:deep,:slotted,:global,useCssModule,v-bind)
前端·javascript·css