百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 热门文章 > 正文

花 15 分钟把 Express.js 搞明白,全栈没有那么难

bigegpt 2025-02-19 11:03 8 浏览

大家好,我是杨成功。

Express 是老牌的 Node.js 框架,以简单和轻量著称,几行代码就可以启动一个 HTTP 服务器。市面上主流的 Node.js 框架,如 Egg.js、Nest.js 等都与 Express 息息相关。

Express 框架使用标准 Node.js 语法,主要由以下 3 个核心部分组成:

  • 路由。
  • 中间件。
  • 错误处理。

认识基本结构

Express 的基本结构很简单,只需要三行代码,应用就可以运行起来。

const express = require('express')
const app = express()

app.listen(9000, () => console.log('启动成功'))


假设上述代码写在 index.js 中,我们启动该应用使用命令 node ./index.js,控制台会输出“启动成功”。

为了方便,我们也可以在 package.json 中创建快捷命令,如下:

// package.json
{
  "scripts": {
    "start": "node ./index.js"
  }
}


那么现在启动应用就可以用 npm run start 命令。

不过这种方式在本地运行项目时会有一个弊端,就是修改文件后不会立即生效,需要重新启动。为了提高效率,一般会使用一个名为 PM2 的模块启动 Node.js 应用。

首先全局安装 pm2:

$ npm install -g pm2


安装后在项目目录下创建启动配置文件 ecosystem.config.js,代码如下:

module.exports = {
  apps: [
    {
      name: 'first-api',
      script: './index.js',
    },
  ],
}


然后在项目目录下执行以下命令就可以启动项目了:

$ pm2 start --watch


上图中的 0 就是启动应用的 ID,下面会用到。

PM2 常用大命令如下:

  • pm2 start:启动应用,--watch 表示监听文件修改自动重启。
  • pm2 list:查看已启动的应用列表。
  • pm2 logs :查看日志输出。
  • pm2 delete :查看日志输出。

应用启动成功后会监听 9000 端口,但我们访问 “http://localhost:9000” 会发现没有反应,这是因为没有设置如何处理请求。

Express 中通过定义路由来处理请求。

使用路由创建 API 接口

路由用于定义如何处理请求,定义方式采用以下结构:

app.METHOD(PATH, HANDLER)


其中 app 表示 Express 的实例,其余的三个部分都属于路由配置,表示的含义如下:

  • METHOD:路由方法。
  • PATH:路由地址。
  • HANDLER:路由处理函数。

比如示例代码中的路由是这样子:

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


使用app.get()定义了一个 GET 请求的路由,第一个参数 “/” 为路由地址,第二个参数为路由处理函数,是一个回调函数,该函数接受两个参数分别表示请求和响应。

当路由方法和路由地址匹配到用户请求时,路由处理函数就会执行。

路由方法根据基本 API 规则支持五种,分别如下:

  • app.get():GET 请求。
  • app.post():POST 请求。
  • app.put():PUT 请求。
  • app.delete():DELETE 请求。
  • app.all():匹配所有请求。

以上五个方法的参数都与示例路由一致。定义好路由后,我们的主要任务是在路由处理函数中编写业务代码,一般会包括接收请求参数、返回接口响应,这里要用到路由处理函数的两个参数。

请求对象

路由处理函数的第一个参数表示请求对象,包含客户端请求携带的相关数据,常用的属性如下:

  • req.query:URL 附加参数。
  • req.body:请求体参数。
  • req.method:请求方法。
  • req.headers:请求头对象。
  • req.params:URL 地址参数。

现在我们定义一个路由,将请求对象的这几个属性返回,看一下它们的值是什么:

app.post('/first/:id', (req, res) => {
  let { method, query, body, params, headers } = req
  res.send({ method, query, body, params, headers })
})


在 Postman 中请求地址 “
http://localhost:9000/first/8?tag=test” 并传入请求体参数
{data: "xxx"},请求结果如下:

对照请求参数和返回结果,可以发现路由地址中的 :id 占位符解析后被放到 “req.params” 对象下。地址参数 ?tag=test 解析后被放到 “req.query” 对象下。

但是有一个问题:请求体没有被解析出来。

这是因为请求体是按照流处理的,无法直接获取到,我们需要一个第三方工具包协助。首先安装如下:

$ yarn add body-parser


然后在 index.js 中引入并加载:

const bodyParser = require('body-parser')
app.use(bodyParser.json())


现在重新请求,接可以看到 req.body 的返回结果了:

响应对象

路由处理函数的第二个参数表示响应对象,用于向客户端返回结果,也就是定义接口的返回值。路由处理函数中必须设置响应,否则客户端请求会一直处于挂起状态,无返回值。

常用的响应方法有以下三种,用于返回不同类型的数据:

  • res.json():发送 JSON 响应。
  • res.render():发送视图响应(HTML)。
  • res.send():发送各种类型的响应。

我们统一使用 res.send() 方法响应数据。一般在响应前还可以通过 res.status() 方法设置 HTTP 状态码,示例如下:

res.send('哈哈') // 状态码:200,返回值:"哈哈"
res.status(201).send({
  msg: 'created',
}) // 状态码:201,返回值:{msg:"created"}
res.status(401).send('请登录') // 状态码:401,返回值:"请登录"


发送响应时也常常会遇到问题,以下两条原则请牢记,避免踩坑:

  • 一个路由处理函数中只能响应一次,不能重复响应。
  • res.send() 不能直接返回数字。

分组路由

使用 app 实例注册路由固然方便,但是如果定义的路由很多,都注册在 app 实例下很可能会带来全局污染,这与全局变量一个道理。为了应用的健壮性,我们应该将路由分组。

Express 提供了 Router 类来创建模块化的路由程序,它像一个微应用,可以随时被 app 实例挂载。这样就可以把一组路由保存在一个单独的文件中,需要时加载,从而实现路由分组。

创建一个 router 文件夹用于保存路由文件,然后创建 router/test.js 文件,在文件中呢写入路由代码,如下:

// router/test.js
var express = require('express')
var router = express.Router()

router.post('/info', (req, res) => {
  res.send('TEST 路由组')
})

module.exports = router


这样一个基本的路由模块就写好了,如果让其生效,需要在主程序中加载该模块:

const testRouter = require('./router/test.js')
app.use('/test', testRouter)


上述代码表示请求 “/test” 时加载路由模块,访问某个路由时使用该路径拼接路由地址,像下面这样:

http://localhost:9000/test/info
# 返回 "TEST 路由组"


为了开发规范,我们统一把路由定义为路由模块,而不直接在 app 下注册。

理解中间件,搞懂框架原理

Express 应用是由一系列中间件构成的。中间件同样是一个听着很玄乎的词儿,但它的本质就是一个函数。我们看一个中间件函数的代码示例:

var myLogger = function (req, res, next) {
  console.log('LOGGED')
  next()
}


中间件与普通函数的区别就是它有三个参数,分别表示请求对象(req),响应对象(res)和一个 next() 函数 ——— 也许你发现了,路由处理函数也是这个结构。

没错,路由处理函数本身就是一个中间件。

将中间件挂载到应用上,使用 app.use() 方法:

app.use(myLogger)


看到这里你又会发现,请求体解析包 body-parser 也是这么挂载的,因为该包也是一个中间件。

直接用 app.use() 挂载的中间件在收到任意请求时都会执行。如果要限定执行条件,可以添加一个路径匹配,如下:

app.use('/test/*', myLogger)


这样,只有以 /test 开头的请求才会执行 myLogger 中间件,这看起来与路由注册很相似。其实注册路由正是这种中间件挂载方式的快捷写法,只不过多了一个请求方法的限制。

Express 应用中一切皆中间件,如果匹配到多个中间件会按照顺序依次调用。此时 next() 函数就能派上用场了,他的作用是进入下一个中间件。

比如代码中的 myLogger 中间件,将它挂载到路由之前,那么每次请求首先会打印出 “LOGGED”,然后再进入路由处理函数。

如果 myLogger 中间件中没有调用 next() 函数,请求就会被堵在这里,无法进入路由处理函数,此时请求会被挂起。

统一错误处理,提升健壮性

既然一切皆中间件,那么错误处理也是一个中间件。错误处理函数与其他的中间件函数稍有不同,它多了一个 err 参数,如下:

app.use((err, req, res, next) => {
  console.error(err.stack)
  res.status(500).send('服务器出错了!')
})


err 参数表示错误信息,当发生错误时进入该中间件,此时要设置 HTTP 状态码为 500,并根据错误信息为客户端返回错误响应。

错误处理中间件是一个兜底中间件,请确保它定义在所有中间件之后,是应用中的最后一个中间件。

请求进入错误中间件,说明前面的所有中间件都没有匹配到。但是如果客户端请求地址写错而进入错误处理中间件,此时返回 500 错误显然不合理,应该是 404 资源未找到。

所以在错误处理中间件前,还应该定义一个 404 中间件。该中间件要在所有路由之后,错误处理之前,是应用的倒数第二个中间件,代码如下:

app.use((req, res, next) => {
  res.status(404).send('Not Found')
})


好了,现在我们的应用就健壮多了。

总结

本文列举了 Express 框架的核心,并举例如何应用,整体并没有那么难。掌握这部分知识,可以快速拥 API 开发的思维。


作者:杨成功
链接:
https://juejin.cn/post/7324224387463348263

相关推荐

Linux 系统启动完整流程

一、启动系统流程简介如上图,简述系统启动的大概流程:1:硬件引导UEFi或BIOS初始化,运行POST开机自检2:grub2引导阶段系统固件会从MBR中读取启动加载器,然后将控制权交给启动加载器GRU...

超专业解析!10分钟带你搞懂Linux中直接I/O原理

我们先看一张图:这张图大体上描述了Linux系统上,应用程序对磁盘上的文件进行读写时,从上到下经历了哪些事情。这篇文章就以这张图为基础,介绍Linux在I/O上做了哪些事情。文件系统什么是...

linux入门系列12--磁盘管理之分区、格式化与挂载

前面系列文章讲解了VI编辑器、常用命令、防火墙及网络服务管理,本篇将讲解磁盘管理相关知识。本文将会介绍大量的Linux命令,其中有一部分在“linux入门系列5--新手必会的linux命令”一文中已经...

Linux环境下如何设置多个交叉编译工具链?

常见的Linux操作系统都可以通过包管理器安装交叉编译工具链,比如Ubuntu环境下使用如下命令安装gcc交叉编译器:sudoapt-getinstallgcc-arm-linux-gnueab...

可算是有文章,把Linux零拷贝技术讲透彻了

阅读本文大概需要6.0分钟。作者:卡巴拉的树链接:https://dwz.cn/BaQWWtmh本文探讨Linux中主要的几种零拷贝技术以及零拷贝技术适用的场景。为了迅速建立起零拷贝的概念...

linux软链接的创建、删除和更新

大家都知道,有的时候,我们为了省下空间,都会使用链接的方式来进行引用操作。同样的,在系统级别也有。在Windows系列中,我们称其为快捷方式,在Linux中我们称其为链接(基本上都差不多了,其中可能...

Linux 中最容易被黑客动手脚的关键目录

在Linux系统中,黑客攻击后常会针对关键目录和文件进行修改以实现持久化、提权或隐藏恶意活动。本文介绍下黑客最常修改的目录及其手法。一、/etc目录关键文件有:/etc/passwd和/et...

linux之间传文件命令之Rsync傻瓜式教程

1.前言linux之间传文件命令用什么命令?本文介绍一种最常用,也是功能强大的文件同步和传输工具Rsync,本文提供详细傻瓜式教程。在本教程中,我们将通过实际使用案例和最常见的rsync选项的详细说...

Linux下删除目录符号链接的方法

技术背景在Linux系统中,符号链接(symlink)是一种特殊的文件,它指向另一个文件或目录。有时候,我们可能需要删除符号链接,但保留其指向的目标目录。然而,在删除符号链接时可能会遇到一些问题,例如...

阿里云国际站注册教程:aa云服务器怎么远程链接?

在全球化的今天,互联网带给我们无以计数的便利,而云服务器则是其中的重要基础设施之一。这篇文章将围绕阿里云国际站注册、aa云服务器如何远程链接,以及服务器安全防护如Ddos防火墙、网站应用防护waf防火...

Linux 5.16 网络子系统大范围升级 多个新适配器驱动加入

Linux在数据中心中占主导地位,因此每个内核升级周期的网络子系统变化仍然相当活跃。Linux5.16也不例外,周一最新与网络相关的更新加入了大量的驱动和新规范的支持。一个较新硬件的驱动是Realt...

搭建局域网文件共享服务(Samba),手机电脑都能看喜欢的影视剧

作为一名影视爱好者,为了方便地观看自己喜欢的影视作品,在家里搞一个专门用来存放电影的服务器是有必要的。蚁哥选则用一台Ubuntu系统的电脑做为服务器,共享影音文件,其他同一个局域网内的电脑或手机可以...

分享一个实用脚本—centos7系统巡检

概述这周闲得慌,就根据需求写了差不多20个脚本(部分是之前分享过的做了一些改进),今天主要分享一个给平时运维人员用的centos7系统巡检的脚本,或者排查问题检查系统情况也可以用..实用脚本#!/bi...

Linux 中创建符号链接的方法

技术背景在Linux系统里,符号链接(SymbolicLink),也被叫做软链接(SoftLink),是一种特殊的文件,它指向另一个文件或者目录。符号链接为文件和目录的管理带来了极大的便利,比...

一文掌握 Linux 符号链接

符号链接(SymbolicLink),通常被称为“软链接”,是Linux文件系统中一种强大而灵活的工具。它允许用户创建指向文件或目录的“快捷方式”,不仅简化了文件管理,还在系统配置、软件开发和日...