1 Express 简介
1.1 什么是 Express
官方给出的概念:
Express 是基于 Node.js 平台,快速、开放、极简的 Web 开发框架。
通俗的理解:
Express 的作用和 Node.js 内置的 http 模块类似,是专门用来创建 Web 服务器的。
Express 的本质:
就是一个 npm 上的第三方包,提供了快速创建 Web 服务器的便捷方法。
使用 Express,我们可以方便、快速的创建 Web 网站的服务器或 API 接口的服务器。
2 Express 的基本使用
2.1 安装
在项目所处的目录中,运行如下的终端命令,即可将 express 安装到项目中使用:
npm i express
2.2 使用 express 创建基本的 Web 服务器
// 1. 导入 express const express = require('express') // 2. 创建 web 服务器 const app = express() // 3. 启动 web 服务器 // 参数:端口号,启动成功后的回调函数 app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.3 监听 GET 请求
通过 app.get() 方法,可以监听客户端的 GET 请求,具体的语法格式如下:
// 1. 导入 express const express = require('express') // 2. 创建 web 服务器 const app = express() // 4. 监听客户端的 GET 请求 // 参数1:客户端请求的 url 地址 // 参数2:请求对应的处理函数, // req 请求对象(包含了与请求有关的属性和方法), // res 响应对象(包含了与响应有关的属性和方法) app.get('/user', (req, res) => {}) // 3. 启动 web 服务器 // 参数:端口号,启动成功后的回调函数 app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.4 监听 POST 请求
通过 app.post() 方法,可以监听客户端的 POST 请求,具体的语法格式如下:
// 1. 导入 express const express = require('express') // 2. 创建 web 服务器 const app = express() // 4. 监听客户端的 GET 和 POST 请求 app.get('/user', (req, res) => {}) app.post('/user', (req, res) => {}) // 3. 启动 web 服务器 // 参数:端口号,启动成功后的回调函数 app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.5 把内容响应给客户端
通过 res.send() 方法,可以把处理好的内容,发送给客户端:
// 1. 导入 express const express = require('express') // 2. 创建 web 服务器 const app = express() // 4. 监听客户端的 GET 和 POST 请求,并向客户端响应具体的内容 app.get('/user', (req, res) => { // 调用 express 提供的 res.send() 方法,向客户端响应一个 JSON 对象 res.send({ name: 'zs', age: 20, gender: '男' }) }) app.post('/user', (req, res) => { // 调用 express 提供的 res.send() 方法,向客户端响应一个 文本字符串 res.send('请求成功') }) // 3. 启动 web 服务器 // 参数:端口号,启动成功后的回调函数 app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.6 获取 URL 中携带的查询参数
通过 req.query 对象,可以访问到客户端通过查询字符串的形式,发送到服务器的参数:
req.query默认是一个空对象
客户端使用 ?name=zs&age=20 这种查询字符串形式,发送到服务器的参数,可以通过req.query对象访问到,例如:
req.query.name
req.query.age
// 1. 导入 express const express = require('express') // 2. 创建 web 服务器 const app = express() // 4. 监听客户端的 GET 和 POST 请求,并向客户端响应具体的内容 app.get('/user', (req, res) => { // 调用 express 提供的 res.send() 方法,向客户端响应一个 JSON 对象 res.send({ name: 'zs', age: 20, gender: '男' }) }) app.post('/user', (req, res) => { // 调用 express 提供的 res.send() 方法,向客户端响应一个 文本字符串 res.send('请求成功') }) app.get('/', (req, res) => { // 通过 req.query 可以获取到客户端发送过来的 查询参数 // 注意:默认情况下,req.query 是一个空对象 console.log(req.query) res.send(req.query) }) // 3. 启动 web 服务器 app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.7 获取 URL 中的动态参数
通过 req.params 对象,可以访问到 URL 中,通过:
匹配到的动态参数:
URL 地址中,可以通过:
参数名的形式,匹配动态参数值。
req.params默认是一个空对象,里面存放着通过:
动态匹配到的参数值。
// 1. 导入 express const express = require('express') // 2. 创建 web 服务器 const app = express() // 4. 监听客户端的 GET 和 POST 请求,并向客户端响应具体的内容 app.get('/user', (req, res) => { // 调用 express 提供的 res.send() 方法,向客户端响应一个 JSON 对象 res.send({ name: 'zs', age: 20, gender: '男' }) }) app.post('/user', (req, res) => { // 调用 express 提供的 res.send() 方法,向客户端响应一个 文本字符串 res.send('请求成功') }) app.get('/', (req, res) => { // 通过 req.query 可以获取到客户端发送过来的 查询参数 // 注意:默认情况下,req.query 是一个空对象 console.log(req.query) res.send(req.query) }) // 注意:这里的 :id 是一个动态的参数 app.get('/user/:id/:username', (req, res) => { // req.params 是动态匹配到的 URL 参数,默认也是一个空对象 console.log(req.params) res.send(req.params) }) // 3. 启动 web 服务器 app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.8 托管静态资源
express 提供了一个非常好用的函数,叫做 express.static(),通过它,我们可以非常方便地创建一个静态资源服务器,例如,通过如下代码就可以将 clock 目录下的图片、CSS 文件、JavaScript 文件对外开放访问了:
const express = require('express') const app = express() // 在这里,调用 express.static() 方法,快速的对外提供静态资源! app.use(express.static('./clock')) app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
注意:Express 在指定的静态目录中查找文件,并对外提供资源的访问路径。因此,存放静态文件的目录名不会出现在 URL 中。
http://localhost:80/index.css
http://localhost:80/index.html
http://localhost:80/index.js
2.8.1 托管多个静态资源目录
如果要托管多个静态资源目录,请多次调用 express.static() 函数。访问静态资源文件时,express.static() 函数会根据目录的添加顺序查找所需的文件。
const express = require('express') const app = express() // 在这里,调用 express.static() 方法,快速的对外提供静态资源 app.use(express.static('./files')) app.use(express.static('./clock')) app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
2.8.2 挂载路径前缀
如果希望在托管的静态资源访问路径之前,挂载路径前缀,则可以使用如下的方式:
const express = require('express') const app = express() // 在这里,调用 express.static() 方法,快速的对外提供静态资源 app.use('./clock',express.static('./clock')) app.listen(80, () => { console.log('express server running at http://127.0.0.1') })
现在,你就可以通过带有 /clock 前缀地址来访问 clock 目录中的文件了:
http://localhost:80/clock/index.css
http://localhost:80/clock/index.html
http://localhost:80/clock/index.js