moonshot 8 - Node.js 3

207 阅读4分钟

Express

  • 什么是 Express Express是基于Node.js平台的一个Web服务器开发框架。

Express的作用与http模块类似,是专门用来创建Web服务器的。实际上Express就是用原生的http模块封装出来的。

Express也是npm上的一个第三方包,因此我们可以通过npm下载。

  • Express 的作用 使用Express可以方便、快捷地创建Web网站服务器API接口服务器

  • Express 的基本使用

// 导入 express 模块
const express = require('express')

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

// 监听客户端的 GET 请求
app.get('/user', (req, res) => {
    // req.query 是一个对象,存放着GET请求里的查询字符的内容,默认为空
    console.log(req.query); // { name: 'lee', age: '20' }
    
    // 调用 express 提供的 send 方法向客户端响应一个 JSON 对象
    res.send({ name: 'lee', id: 7 });
})

// 监听客户端的 POST 请求
app.post('/user', (req, res) => {
    // 调用 express 提供的 send 方法向客户端响应一个文本字符串
    res.send('POST 请求成功')
})

// 启动服务器
app.listen(8080, () => {
    console.log('express server running at http://127.0.0.1:8080');
})

  • nodemon 在编写和调试Node.js代码的时候,如果修改了项目的代码,就需要频繁重启服务器,非常繁琐。

因此我们需要下载一个第三方包——nodemon,它可以监听项目文件的变动,当代码被修改后会自动帮助我们重启服务器。

我们只需要用nodemon xxx来启动项目来替代之前用node xxx启动项目就行了。

路由

路由就是一种映射关系,在express中,路由的存在就保证了一个请求可以对应一个响应。

const express = require('express')

// 创建服务器 
const app = express()
//创建路由
const router = express.Router()

// 挂载GET路由
router.get('/', (req, res) => {
    res.send('GET')
})
// 挂载POST路由
router.post('/', (res, req) => {
    res.send('POST')
})

// 注册路由
app.use(router)

// 启动服务器
app.listen(8081, () => {
    console.log('express server running at http://127.0.0.1:8081')
})

中间件

中间件就是中间处理环节

express的中间件本质上就是一个函数,它与路由函数的区别是必须含有next函数。

image.png

next函数是实现多个中间件连续调用的关键,它表示把流转关系转交给下一个中间件路由

image.png

一个请求所经过的所有中间件都共享同一份reqres,我们可以利用这一点完成许多事。

  • 全局中间件 全局中间件是所有的请求都会触发的中间件。
const express = require('express')
const app = express()

// 注册全局中间件函数
app.use((req, res, next) => {
    console.log('这是第一个中间件');
    let nowDate = new Date();
    req.date = nowDate;
    next();
})
app.use((req, res, next) => {
    console.log('这是第二个中间件');
    let addSomething = 'something';
    req.something = addSomething;
    next();
})

app.get('/', (req, res) => {
    console.log(req.date);
    console.log(req.something);
    res.send(req.date + '-----' + req.something);
})

app.listen(80, () => {
    console.log('http://127.0.0.1');
})
  • 局部中间件 局部中间件函数只会在某一个请求上被执行。
const express = require('express')
const app = express()

// 定义局部中间件
const mw1 = function (req, res, next) {
    console.log('这是第一个局部中间件');
    req.something1 = 'Citizen7'
    next();
}
const mw2 = function (req, res, next) {
    console.log('这是第二个局部中间件');
    req.something2 = 'Lee'
    next();
}

// 某个请求
app.get('/', mw1, mw2, (req, res) => {
    console.log('GET请求');
    res.send(req.something1 + '---' + req.something2);
})

// 启动服务器
app.listen(8080, () => {
    console.log('http://127.0.0.1:8080');
}) 
  • 错误级别中间件 错误级别的中间件必须有四个参数,且第一个必须是err,并且这个中间件必须写到所有路由的最后(其他的中间件都必须写在路由之前)。
const express = require('express')
const app = express()

// 在某个请求中出现了一个错误
app.get('/', (req, res) => {
    throw new Error('错误!');
})

// 错误级别中间件
app.use((err, req, res, next) => {
    console.log(err.message);
    res.send('出现错误:' + err.message)
})

// 启动服务器
app.listen(8080, () => {
    console.log('http://127.0.0.1:8080');
})
  • Express 内置中间件 在Express中内置了3个常用的中间件:
  1. express.static——快速托管静态资源的内置中间件。
  2. express.json——解析JSON格式的请求体数据。
  3. express.urlencoded——解析URL-encoded格式的请求体数据。

CORS

CORS(Cross-Origin Resource Sharing)即跨域资源共享,由一系列HTTP响应头组成,这些HTTP响应头决定浏览器是否阻止前端JS代码跨域获取资源。

浏览器的同源安全策略会默认阻止网页跨域获取资源。但如果接口服务器配置了CORS相关的HTTP响应头,就可以解除浏览器端的跨域访问限制。

注意,只有支持XMLHttpRequest Level 2的浏览器才能支持CORS。

此外,CORS其实还是Express的一个第三方中间件。

  • 安装 npm install cors

  • 使用

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

// 配置解析表单数据的中间件(内置中间件)
app.use(express.urlencoded({ extended: false }))

// 配置 cors 中间件(一定要在所有路由之前)
const cors = require('cors')
// 注册 cors 中间件
app.use(cors())

// 导入路由模块
const router = require('./apiRouter.js')
// 把路由模块注册到 app 上,并限定路径前缀是 /api
app.use('/api', router)

// 启动服务器
app.listen(8080, () => {
    console.log('express server running at http://127.0.0.1:8080.');
})
// apiRouter.js 路由模块
const express = require('express')
const router = express.Router()

router.get('/get', (req, res) => {
    // 通过 req.query 获取客户端的查询字符串
    const query = req.query
    res.send({
        msg: 'GET请求成功',
        data: query
    })
})

router.post('/post', (req, res) => {
    // 通过 req.body 获取客户端发送到服务器的请求体内容
    const body = req.body
    res.send({
        msg: 'POST请求成功!',
        data: body
    })
})

module.exports = router