NodeJs基础知识梳理

846 阅读23分钟

Node.js简介

什么是Node.js

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。

通俗的理解:Node.js 为 JavaScript 代码的正常运行,提供的必要的环境。

Node.js 的官网: nodejs.org/zh-cn/

Node.js 中文文档:nodejs.cn/api/

NodeJs运行环境.png

nodejs与浏览器的区别

① 浏览器是 JavaScript 的前端运行环境。

② Node.js 是 JavaScript 的后端运行环境。

③ Node.js 中无法调用 DOM 和 BOM 等 浏览器内置 API。

Node.js可以做什么

Node.js 作为一个 JavaScript 的运行环境,仅仅提供了基础的功能和API。然而,基于Node.js 提供的这些基础能,很多强大 的工具和框架如雨后春笋,层出不穷,所以学会了Node.js ,可以让前端程序员胜任更多的工作和岗位:

① 基于 Express 框架(www.expressjs.com.cn/),可以快速构建Web 应用

② 基于 Electron框架(electronjs.org/),可以构建跨平台的桌…

③ 基于 restify 框架(restify.com/),可以快速构建API 接口项目

④ 读写和操作数据库、创建实用的命令行工具辅助前端开发、etc…

Node.js环境的安装

如果希望通过Node.js 来运行 Javascript 代码,则必须在计算机上安装Node.js 环境才行。

终端的使用

终端(英文:Terminal)是专门为开发人员设计的,用 于实现人机交互的一种方式。

nodejs和普通的程序运行不一样,需要在终端中使用node命令来使用。

使用任意终端都可以(如vscode中快捷键 ctrl + ~)

安装nodejs

在终端输入node –v ,如果能返回Node.js 的版本号,即为安装成功

终端常见命令

  • cd改变目录
  • cd..回退到上一级目录,直接cd进入默认目录
  • pwd显示当前所在目录路径
  • ls(ll)都是列出当前目录中的所有文件,只不过ll列出的更详细
  • touch在当前目录下新建一个文件(powershell中为new-item)
  • rm删除一个文件
  • md在当前目录下新建一个文件夹
  • rm -r删除一个文件夹(多加f会清空整个电脑!!!)
  • mv移动文件(mv 1.html num 移动文件1到num文件夹,前提是它们在同一级)
  • reset重新初始化终端/清屏(powershell不可用)
  • clear清屏
  • history查看命令历史
  • help帮助
  • exit退出
  • #表示注释

nodejs基本使用

在 Node.js 中需要通过终端才能执行 JavaScript 代码

① 打开终端

② 输入 node 要执行的js文件的路径,即可通过Node.js,来执行存放于.js 文件中的代码

创建js文件 helloworld.js

写nodejs的内容:console.log('hello nodejs')

打开终端

执行命令:node helloworld.js

常用快捷键

在 Windows 的命令行中,我们可以通过如下快捷键,来提高命令行的操作效率: ① 键,定位到上一次执行的命令 ② tab 键,快速补全路径 ③ esc 键,清空当前已输入的命令

Node内置模块

global模块(node的全局模块)

注意:global不需要引入,直接使用

  1. console.log() 打印
  2. setTimeout 和setInterval ,延时器和定时器
  3. __dirname 当前文件夹的绝对路径

fs模块

在nodejs中,提供了fs模块,这是node的核心模块

nodejs.cn/api/fs.html

注意:

  1. 除了global模块中的内容可以直接使用,其他模块都是需要加载的。
  2. fs模块不是全局的,不能直接使用。因此需要导入才能使用。
// 先引入fs模块,才能使用
const fs = require('fs')

读取文件

语法:fs.readFile(path[, options], callback)

//参数1: 文件的路径
//参数2(可选): 编码,如果设置了,返回一个字符串,如果没有设置,会返回一个buffer对象
//参数3: 回调函数
fs.readFile('data.txt', 'utf8',(err, data)=>{
  if(err) return console.log('读取文件失败',err) 
  console.log('读取文件成功',data)
})

关于Buffer对象

1. Buffer对象是Nodejs用于处理二进制数据的。
2. 其实任意的数据在计算机底层都是二进制数据,因为计算机只认识二进制。
3. 所以读取任意的文件,返回的结果都是二进制数据,即Buffer对象
4. Buffer对象可以调用toString()方法转换成字符串。

写入文件

语法:fs.writeFile(file, data[, options], callback)

//参数1:文件的路径(如果文件不存在,会自动创建)
//参数2:写入的文件内容(注意:写入的内容会覆盖以前的内容)
//参数3:写文件后的回调函数
fs.writeFile('2.txt', 'hello world', err=>{
  if(err) return console.log('写入文件失败', err)
  console.log('写入文件成功')
})

追加文件

语法:fs.appendFile(path, data[, options], callback)

//参数1:文件的路径(如果文件不存在,会自动创建)
//参数2:追加的文件内容(注意:写入的内容会覆盖以前的内容)
//参数3:追加文件后的回调函数
fs.appendFile('2.txt', '我是追加的内容', err=>{
  if(err) return console.log('追加文件内容失败',err)
  console.log('追加文件内容成功')
})

fs 模块-路径动态拼接的问题

在使用 fs 模块操作文件时,如果提供的操作路径是以./ 或 ../ 开头的相对路径时,很容易出现路径动态拼接错误的问题。 原因:代码在运行的时候,会以执行node 命令时所处的目录,动态拼接出被操作文件的完整路径。 解决方案:在使用fs 模块操作文件时,直接提供绝对路径,不要提供./ 或 ../ 开头的相对路径,从而防止路径动态拼接的问题。

注意:使用__dirname 获取当前文件所在文件夹的绝对路径

const fs = require('fs');
// 拼接要读取文件的绝对路径
const filepath = __dirname +'/hello.txt'
fs.readFile(filepath, 'utf-8', (err, data) => {
	if(err) return console.log('读取文件失败',err) 
	console.log('读取文件成功',data)
})

path路径模块

path 模块是 Node.js 官方提供的、用来处理路径的模块。它提供了一系列的方法和属性,用来满足用户对路径的处理需求。

// 先引入fs模块,才能使用
const path = require('path')

路径拼接

path.join()的语法格式

使用 path.join() 方法,可以把多个路径片段拼接为完整的路径字符串,语法格式如下:

path.join(pathA,pathB,pathC...) // 返回字符串

path.join()的代码示例

const path = require('path');

console.log( path.join('a', 'b', 'c') ) 	// a/b/c
console.log( path.join('a', '/b/', 'c') )	// a/b/c
console.log( path.join('a', '/b/', 'c', 'index.html') )	// a/b/c/index.html
console.log( path.join('a', 'b', '../c', 'index.html') )	// a/c/index.html
console.log(__dirname)	// node自带的全局变量,表示当前js文件所在的绝对路径

// 拼接文件的绝对路径(最常用)
console.log( path.join(__dirname, '成绩.txt') )

获取路径中的文件名

path.basename()的语法格式

使用 path.basename() 方法,获取到文件的名称(有无扩展名,与路径本身有无扩展名一致)

path.basename(pathA)

path.basename()的代码示例

console.log( path.basename('index.html') ) // index.html
console.log( path.basename('a/b/c/index.html') ) // index.html
console.log(path.basename('/a.jpg')) // a.jpg

获取路径中的文件扩展名

path.extname()的语法格式

使用 path.extname() 方法,可以获取路径中的扩展名部分,语法格式如下:

path.extname(pathA)

path.extname()的代码示例

使用 path.extname() 方法,可以获取路径中的扩展名部分

// 找字符串中,最后一个点及之后的字符
console.log( path.extname('index.html') ); // .html
console.log( path.extname('a.b.c.d.html') ); // .html
console.log( path.extname('asdfas/asdfa/a.b.c.d.html') ); // .html
console.log( path.extname('adf.adsf') ); // .adsf

http模块

http 模块是 Node.js 官方提供的、用来创建web 服务器的模块。

创建最基本的web服务器

创建web服务器的基本步骤

① 导入 http 模块 ② 创建 web 服务器实例 ③ 为服务器实例绑定request 事件,监听客户端的请求 ④ 启动服务器

创建web实现

// 1.引入http模块
const http = require('http');
// 2.创建服务器
const server=http.createServer()
// 3.启动服务并监听
server.listen(3000,()=>{
    console.log('你来辣');
})
// 4.监听用户的请求
server.on('request',(req,res)=>{
    // 设置字符集为utf-8(让中文能被解析),写在第一行
    res.setHeader('content-type','text/html;charset=utf-8')

    console.log('莫西莫西');
    // console.log(req.headers);
    console.log(req.method);    // 请求的方式
    console.log(req.url);    // 请求的地址

    // res.statusCode=404  // 设置状态码
    // res.statusMessage='not find'  // 设置状态信息
	// res.write('abc')
    // res.end写在最后
    res.end('<h1>牛</h1>')
})

端口号

计算机中的端口号,就好像是现实生活中的门牌号一样。通过门牌号,外卖小哥可以在整栋大楼众多的房间中,准确把外卖 送到你的手中。 同样的道理,在一台服务器中,可以运行成百上千个web 服务。此时,通过端口号,客户端发送过来的网络请求,可以被准 确地交给端口号对应的web 服务进行处理。

端口号.png

request对象详解

文档地址:nodejs.cn/api/http.ht…

常见属性:

headers: 所有的请求头信息
method: 请求的方式
url: 请求的地址

注意:在发送请求的时候,可能会出现两次请求的情况,这是因为谷歌浏览器会自动增加一个favicon.ico的请求。

response对象详解

文档地址:nodejs.cn/api/http.ht…

常见的属性和方法:

res.setHeader(name, value)	设置响应头信息, 比如content-type
res.writeHead(statusCode, statusMessage, options)	设置响应头,同时可以设置状态码和状态信息。
res.statusCode: 响应的的状态码 200 404 500
res.statusMessage: 响应的状态信息, OK Not Found ,会根据statusCode自动设置。
res.write(data): 给浏览器发送响应体,可以调用多次,从而提供连续的请求体
res.end()	通知浏览器,所有响应头和响应主体都已被发送,即服务器将其视为已完成。
res.end(data)	结束请求,并且响应一段内容,相当于res.write(data) + res.end()

解决中文乱码问题

当调用 res.end() 方法,向客户端发送中文内容的时候,会出现乱码问题,此时,需要手动设置内容的编码格式:

res.setHeader('Content-Type', 'text/html; charset=utf-8');

根据不同的url响应不同的html内容

const http = require('http')

const server = http.createServer()

server.listen(3000, () => console.log('my server running'))

server.on('request', (req, res) => {
    res.setHeader('Content-Type', 'text/html; charset=utf-8')
    const url = req.url // 获取请求的url地址
    if (url === '/' || url === 'index.html') {
        res.end('<h1>首页</h1>')
    } else if (url === '/about.html') {
        res.end('<h1>关于我们</h1>')
    } else {
        res.end('<h1>404</h1>')
    } 
})

实现静态WEB服务器

服务器响应首页

  • 注意:浏览器中输入的URL地址,仅仅是一个标识,不与服务器中的目录一致。也就是说:返回什么内容是由服务端的逻辑决定
server.on('request', function(req, res) {
  var url = req.url
  if(url === '/') {
    fs.readFile('./index.html', function(err, data) {
      if(err) {
        return res.end('您访问的资源不存在~')
      }

      res.end(data)
    })
  }
})

根据根据不同url,响应不同文件

content-type设置-MIME类型

  • MIME(Multipurpose Internet Mail Extensions)多用途Internet邮件扩展类型 是一种表示文档性质和格式的标准化方式
  • 浏览器通常使用MIME类型(而不是文件扩展名)来确定如何处理文档;因此服务器将正确的MIME类型附加到响应对象的头部是非常重要的
  • MIME 类型

静态资源的通用处理

MIME类型的通用处理-mime模块

  • 作用:获取文件的MIME类型
  • 安装:npm i mime
const mime = require('mime')

// 获取路径对应的MIME类型
mime.getType('txt')                    // ⇨ 'text/plain'
// 根据MIME获取到文件后缀名
mime.getExtension('text/plain')        // ⇨ 'txt'

npm初步使用

介绍

npm(node package manager)node包管理器。

包是什么?包就是模块。

npm这个工具,在安装node的时候,就已经安装到你的计算机中了。

命令行中执行: npm -v ,如果看到版本号,说明安装成功了。

作用

npm的作用是:管理node模块的工具。

第三方模块:

  • 非内置模块,安装完node,还不能使用的模块,需要从网上下载安装,才能使用的模块
  • 第三方模块是个人、公司、组织编写的模块,发布到网上,供我们使用

初始化

使用npm工具之前,必须先初始化。

npm init -y	// (或 npm init) 高版本省略此步

初始化之后,会在项目目录中生成 package.json 的文件。

第三方模块

非node自带的模块。

是别人写的模块,然后发布到npm网站,我们可以使用npm工具来下载安装别人写的模块。

第三方模块,都是在node核心模块的基础之上,封装了一下,实现了很多非常方便快速简洁的方法。

目前,npm网站收录了超过 60万个第三方模块。

安装卸载项目模块

下载安装第三方模块

npm i 模块名	// (npm install 模块名)

卸载模块

npm un 模块名	// (npm uninstall 模块名)

关于项目模块的说明

  • 下载安装的模块,存放在当前文件夹的 node_modules 文件夹中,同时还会生成一个记录下载的文件 package-lock.json
  • 下载的模块,在哪里可以使用
    • 在当前文件夹
    • 在当前文件夹的子文件夹
    • 在当前文件夹的子文件夹的子文件夹
    • ......
  • 怎样使用第三方模块
    • 和使用内置模块一样,需要使用 require 加载模块
    • 调用模块提供的方法完成工作(一般好的模块都会用使用文档的)

演示下载安装第三方模块

这里演示一个处理时间日期的模块 -- moment

momentjs.cn/

下载安装moment模块

npm init -y
npm i moment

演示使用moment模块处理时间

// 加载模块
const moment = require('moment');

console.log(moment().format('YYYY-MM-DD hh:mm:ss'));
// 官网:http://momentjs.cn

全局模块

  • 全局安装的模块,不能通过 require() 加载使用。

  • 全局安装的模块,一般都是命令或者工具。

  • 安装方法,在安装模块的命令后面,加 -g

    npm i 模块名 -g	// (npm i -g 模块名)
    
  • 查看全局安装的模块

    npm list -g --depth 0
    
  • 卸载方法(也是多一个 -g

    npm un 模块名 -g
    
  • 全局安装的模块,在系统盘(C盘)

    • 通过命令 npm root -g 可以查看全局安装路径
  • mac安装过程可能出现权限问题,可以使用 sudo npm i xxx -g

全局安装nodemon模块

npm i nodemon -g  

nodemon的作用:代替node命令来启动服务,当更改代码之后,nodemon会自动帮我们重启服务

运行nodemon,可能报错:

nodemon报错.png

解决办法是:

  • 管理员方式,打开Windows PowerShell
  • 执行 set-ExecutionPolicy RemoteSigned 命令,更改执行策略
  • 在出现的选项中,回复 A,全是

powershell报错.png

如果继续报策略覆盖错误,输入下面代码:

Set-ExecutionPolicy "RemoteSigned" -Scope Process -Confirm:$false
Set-ExecutionPolicy "RemoteSigned" -Scope CurrentUser -Confirm:$false

参考docs.microsoft.com/zh-cn/archi…

本地安装和全局安装区别

有两种方式用来安装 npm 包:本地安装和全局安装。选用哪种方式来安装,取决于你如何使用这个包。

  1. 本地安装
  • 说明 : 想把我们用的包,安装到当前本地项目中使用
  • 比如 : npm i jquery , npm i moment
  • 要求 : 执行的安装命令(npm i moment) 位置,必须在当前项目下执行
  • 包位置 : 本地安装的包 => 当前项目下的 node_modules
  • 使用包 : const moment = require('moment') , const $ = require('jquery')
  1. 全局安装
  • 说明 : 想把一个包/库,当成一个工具来使用, 就采用全局安装

  • 比如 : npm i -g nodemon

  • 要求 : 可以在任意地方, 都可以执行命令

  • 包位置 : C:\Users\用户名\AppData\Roaming\npm

  • 使用包 : 在终端命令行里使用, 不能在代码里

dependencies说明

1、作用:保存依赖包的记录。

2、以后如果看到我们项目中 没有node_modules目录, 但是有 package.json。说明我们项目是完整的。执行 npm i 会找 package.json 里面的 dependencies, 并且安装里面的所有依赖包

3、执行 npm i 命令 要在 package.json 同级目录。

dependencies说明.png

更改镜像源

镜像源,就是下载安装第三方模块的网站。

我们下载的第三方模块都是从国外的npm主站下载的,速度比较慢。

淘宝在国内对npm上的第三方模块做了一个备份,也就是说,我们可以从国内下载第三方模块。

除了淘宝之外,还有很多其他镜像源。

简单的更改镜像源方法:

  • 全局安装 nrm 的模块
    • nrm 用于管理镜像源
    • npm i nrm -g
  • 使用nrm
    • nrm ls 通过这个命令,可以查看可用的镜像源
    • nrm use taobao ,切换下载模块的网站为淘宝

安装nrm可能报错:

安装nrm报错.png

解决方法:

打开C:\Users\Administrator\AppData\Roaming\npm\node_modules\nrm\cli.js:17:20(让隐藏文件夹可见)

按如下更改代码(32位windows使用USERPROFILE代替HOME):

nrm报错解决.png

模块化

模块化是指解决一个复杂问题时,自顶向下逐层把系统划分成若干模块的过程。 对于整个系统来说,模块是可组合、分解和更换的单元。

一个模块其实指的就是一个独立的js文件

编程中的模块化

编程领域中的模块化,就是遵守固定的规则,把一个大文件拆成独立并互相依赖的多个小模块。

把代码进行模块化拆分的好处:

  • 提高了代码的复用性
  • 提高了代码的可维护性
  • 可以实现按需加载
  • etc...

模块化规范

模块化规范就是对代码进行模块化的拆分与组合时,需要遵守的那些规则。

例如:

  • 使用什么样的语法格式来引用模块 (require('fs'))
  • 在模块中使用什么样的语法格式向外暴露成员 (目前没有学习,马上学习)

模块化规范的好处:大家都遵守同样的模块化规范写代码,降低了沟通的成本,极大方便了各个模块之间的相互调用, 利人利己。

我们自己写模块,也要遵守模块化的标准

CommonJS规范

早期,js没有模块化规范, js越来越火,想要用js开发大型项目,必须要有模块化的规范,民间出现了大量的js的模块化规范。

浏览器端的模块化规范:

  • AMD规范 seajs
  • CMD规范 require.js

服务器端的模块化规范:

  • CommonJS规范 (Node.js 遵循CommonJS)

在2015年的时候,ES6中推出了一种官方的模块化规范,目的:统一浏览器端和服务器端的模块化规范。ES6的模块化

以后在vue或者react中,都会使用ES6的模块化规范。 ES6的模块化规范 webpack

Node.js 遵循了 CommonJS 模块化规范,CommonJS 规定了模块的特性和各模块之间如何相互依赖。

CommonJS 规定:

  1. 每个模块内部,module 变量代表当前模块
  2. module 变量是一个对象,它的 exports 属性(即 module.exports)是对外的接口
  3. 加载某个模块,其实是加载该模块的 module.exports 属性。require() 方法用于加载模块。

Node.js 中模块的分类(★)

Node.js 中根据模块来源的不同,将模块分为了 3 大类,分别是:

  • 内置模块 // 内置模块是由 Node.js 官方提供的,例如 fs、path、http 等
  • 自定义模块 // 用户创建的每个 .js 文件,都是自定义模块
  • 第三方模块 // 由第三方开发出来的模块,并非官方提供的内置模块,也不是用户创建的自定义模块,使用前需要先下载

加载模块

// 加载核心模块
const fs = require('fs');

// 加载第三方模块
const express = require('express');

// 加载自定义模块
const custom = require('./custom');

注意事项

  • 除了global无论是什么模块,我们都要使用 require() 去加载,然后才能使用。
  • 加载自定义的模块,需要加 ./ ,而且可以省略后缀 .js

自定义模块的实现

Node.js中的模块作用域

在 Node.js 中,用户创建的每个 .js 文件都是自定义模块。 在自定义模块中定义的变量、方法等成员,只能在当前模块内被访问,这种模块级别的访问限制,叫做模块作用域

模块作用域的好处是避免了全局变量污染

由于模块具有一个模块级别的作用域,则另一个JS文件就无法使用当前模块定义的内容,如下图所示。

初识模块作用域.png

导出导入模块

为了能正常使用加载的模块中的成员,CommonJS给出了标准,即

  • 一个模块需要使用 module.exports 导出需要共享的内容
  • 使用模块的JS文件需要使用 require() 导入模块
  • 模块导出的是什么,另一个使用模块的JS文件得到的就是什么

模块导出导入.png

require()加载模块的机制

加载自定义模块和其他模块的机制有相同之处,也有不同之处,所以这里分开来看。

加载自定义模块

  1. 首次加载成功,会缓存模块 require('./a')
  2. 下次从缓存中加载,速度更快
  3. 加载自定义模块必须加 ./ ,如果是其他路径,对应变化,否则会把它当做核心模块或者第三方模块
  4. 加载自定义模块的时候,如果是 require('./abc')
    1. 优先加载相同名字的文件,加载一个叫做 abc 的文件
    2. 自动补 .js 后缀,然后加载 abc.js 文件
    3. 自动补 .json 后缀,然后加载 abc.json 文件
    4. 自动补 .node 后缀,然后加载 abc.node 文件
    5. 以上文件都没有,则报错 Cannot find module './abc'

加载核心模块和第三方模块

  1. 首次加载成功,会缓存模块

  2. 下次从缓存中加载,速度更快

  3. 加载模块一定不能./ ,否则会把它当做自定义模块

  4. 加载模块的时候,如果是 require('haha')

    1. 优先加载核心模块

    2. 去查找并加载第三方模块,查找第三方模块的路径可以通过 module.paths 查看

      [ 'E:\tq\我的项目\项目\shjy73\node\day03\02-代码\01-npm\node_modules', 'E:\tq\我的项目\项目\shjy73\node\day03\02-代码\node_modules', 'E:\tq\我的项目\项目\shjy73\node\day03\node_modules', 'E:\tq\我的项目\项目\shjy73\node\node_modules', 'E:\tq\我的项目\项目\shjy73\node_modules', 'E:\tq\我的项目\项目\node_modules', 'E:\tq\我的项目\node_modules', 'E:\tq\node_modules', 'E:\node_modules' ]

    3. 加载第三方模块会从当前目录开始寻找node_modules文件夹, 如果找到进入node_modules文件夹寻找对应的模块。如果没找到,进入上一级目录继续寻找node_modules,一直到根目录。如果一直没有找到,提示未找到模块。

Express基本使用

express是nodejs的一个第三方模块

为什么需要express

  • 内置的http模块创建服务器比较复杂,开发效率低
  • express在http模块的基础上进行了封装,能够极大的提高开发效率,类似于jquery与DOM
  • 使用express,我们可以方便快速的开发一个web服务器以及API接口服务器。

nodejs的框架也很多: node-http模块 ====》 express框架 ====》 koa2 ====》egg.js

Express基本使用步骤

项目文件夹中,执行 npm i express,即可下载安装express

注意:express不能安装在名为express的文件夹中,否则将安装失败

使用Express构建Web服务器步骤:

  1. 加载 express 模块

  2. 创建 express 服务器

  3. 开启服务器

  4. 监听浏览器请求并进行处理

// 使用express 搭建web服务器
// 1) 加载 express 模块
const express = require('express');

// 2) 创建 express 服务器
const app = express();

// 3) 开启服务器
app.listen(3000, () => console.log('express服务器开始工作了'));

// 4) 监听浏览器请求并进行处理

app.get('GET请求的地址', 处理函数);

app.post('POST请求的地址', 处理函数);

res.send()可以给浏览器返回数据,而且不用担心中文会乱码

express接口开发(★)

GET接口

// app.get('请求的URL', callback);
app.get('/api/getbooks', (req, res) => {
    // 处理GET方式的/api/getbooks接口
});

app.get('/', (req, res) => {
    // 客户端没有指定请求的url,在这里处理。
});

app.get('/v1/get', (req, res) => {
  res.setHeader('Access-Control-Allow-Origin', '*')
  res.send('你好啊')
})

app.get('*', (req, res) => {}) 他能够匹配到所有的GET请求,所以把它放到所有接口的最后。

获取查询字符串

获取url?参数=值&参数=值

// 写接口
app.get('/test', (req, res) => {
    console.log(req.query); // { id: '3', bookname: 'zxx', age: '20' }
});

获取动态参数

获取 url/:id/:name/:age

  • 这种方式的参数,叫做动态参数
  • 请求地址的写法:http://localhost:3006/test/3/zs/30
  • 要求请求的url参数必填,否则不能和定义的接口匹配
// 1个参数
// 浏览器的请求  http://localhost/test/3
// 测试接口,获取动态参数
app.get('/test/:id', (req, res) => {
	console.log(req.params); // 可以获取所有的动态参数 { id: 3 }
    res.send('收到参数');
});

// 多个参数
// 浏览器的请求  http://localhost/test2/3/zhangsan/20
// 测试接口,获取多个动态参数
app.get('/test2/:id/:name/:age', (req, res) => {
    console.log(req.params); // 可以获取所有的动态参数  
    // { id: '4', name: 'zhangsan', age: '20' }
    res.send('全部收到');
});

POST接口

// app.post('请求的URL', callback);
app.post('/api/addbook', (req, res) => {
    // 处理POST方式的/api/addbook接口
});

app.post('*', (req, res) => {
    // 处理所有的POST请求
})

获取POST请求体

  • GET方式没有请求体,POST方式才有请求体。
  • 请求体,即客户端提交的数据。

请求体是查询字符串


app.use(express.urlencoded({extended: false}));

// 后续,任何一个POST接口,都可以通过req.body获取到请求体的内容
app.post('/test', (req, res) => {
    // 获取请求体
    console.log(req.body);
    res.send('你的请求体收到了');
});

Express中间件

基本介绍

中间件介绍

  • 中间件(Middleware ),特指业务流程的中间处理环节。

  • 中间件,是express最大的特色,也是最重要的一个设计

  • 很多第三方模块,都可以当做express的中间件,配合express,开发更简单。

  • 一个express应用,是由各种各样的中间件组合完成的

  • 中间件,本质上就是一个函数

中间件原理

express中间件原理.png

中间件语法

  • 中间件就是一个函数
  • 中间件函数中有三个基本参数, req、res、next
    • req就是请求相关的对象
    • res就是响应相关的对象
    • next:它是一个函数,必须调用了next,中间件才会往下传递
  • 语法:
app.use(function (req, res, next) {
  // ....
  next()
})

中间件的特点

  • 每个中间件函数,共享req对象、共享res对象
    • js代码中,所有的req对象是一个对象;所有的res是一个对象
  • 不调用next(),则程序执行到当前中间件函数后,不再向后执行
    • 注意中间件的顺序,因为有可能因为顺序原因,你的中间件函数不会执行
    • 为了防止代码逻辑混乱,调用 next() 函数后不要再写额外的代码
  • 客户端发送过来的请求,可能连续调用多个中间件进行处理
  • 使用app.use()注册的中间件,GET和POST请求都可以触发

express内置的中间件

static

  • 什么叫做静态资源
    • css文件
    • 图片文件
    • js文件
    • 等等
  • 什么叫做开放静态资源
    • 开放,即允许客户端来访问
  • 具体做法
    • 比如,允许客户端访问public文件夹里面的文件
    • app.use(express.static('public'))

urlencoded

用于处理application/x-www-form-urlencoded请求的数据

app.use(express.urlencoded())

json

用于处理content-typeapplication/json的中间件

app.use(express.json())

第三方中间件

cors(允许跨域)

使用方法:

  • 下载安装cors npm i cors
  • const cors = require('cors'); --- 加载模块
  • app.use(cors()); -- 注册中间件即可

multer

  • 下载安装multer

  • 加载模块 const multer = require('multer')

  • 配置上传文件的存放目录 const upload = multer({ dest: '路径' }), 使用绝对路径。

  • 路由(接口)使用

    const multer = require('multer')
    // const upload = multer({ dest: '路径' })
    const upload = multer({
        dest: path.join(__dirname, '../uploads')
    });
    
    router.post('/add', upload.single('接口文档规定的图片名字'), (req, res) => {
        req.body  获取文本类型的数据
        req.file  获取文件的信息
    });