node-express学习总结

项目搭建

1. 使用express提供的框架构建（不需要）
2. 从零开始（推荐）

安装

初始化项目

npm  init -y

安装express

npm install express

1.express的基本使用

创建js文件

const express = require('express')
// 1，创建服务器,express本质是一个函数
const app = express()
// login的post请求，home的get请求
app.post('/login',(req,res)=>{
    res.end("hello login")
})
app.get('/home',()=>{
    res.end("hello home")
})
// 2,开启监听
app.listen(9000,()=>{
    console.log("服务启动成功~");
})

node启动文件
此时我们可以使用postman或者浏览器测试接口 http://localhost:9000/home

2.认识中间件

const express = require('express')
const app = express()
// 什么是中间件？在下面的get请求的回调函数就是一个中间件
app.get('/home',(req,res,next)=>{
    res.end("hello home")
    // 1，我们可以在中间件执行任何代码
    // 2，我们可以修改 req,res对象
    req.aaa = 'aaa'
    // 3，可以结束响应，或挂起响应（当没有res.end或者res.json时）
    // 4，调取下一个中间件
    next()
})
// 普通的中间件
app.use(()=>{
    console.log('second middle exec');
})
app.listen(9000,()=>{
    console.log("服务启动成功~");
})

3.普通中间件

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

// 普通的中间件
// 无论什么请求都会匹配上use注册普通中间件
// 当存在多个中间件时，只会执行第一个，后面的会不会执行取决于第一个有没有调用next()
app.use((req,res,next)=>{
    console.log('middle exec 01');
    // res.end('请求结束')
    // next()
})
app.use((req,res,next)=>{
    console.log('middle exec 02');
})
app.listen(9000,()=>{
    console.log("服务启动成功~");
})

4.路径限制中间件

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

// 匹配路径的中间件
// 只有home路径才能匹配，但是不区分请求方法，任何方法都能匹配上
app.use('/home',(req,res,next)=>{
    console.log('home middle exec ');
    res.end('----')
})

app.listen(9000,()=>{
    console.log("服务启动成功~");
})

5.路径及方法限制中间件

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

// 对methods,path都有限制
// app.methods(path,()=>{})
app.get('/home',(req,res,next)=>{
    console.log('home middle exec ');
    res.end('----')
})

app.listen(9000,()=>{
    console.log("服务启动成功~");
})

6.注册多个中间件

const express = require('express')
const app = express()
// 应用场景：当这个请求特别复杂时，我们可以把业务拆分到不同中间件
// app.methods(path,中间件1,中间件2,中间件3,中间件...)
app.get('/home',(req,res,next)=>{
    console.log('01 ');
    // 调取下一个中间件需要next()
    next()
},(req,res,next)=>{
    console.log('02 ');
},(req,res,next)=>{
    console.log('03 ');
},(req,res,next)=>{
    console.log('04 ');
})

app.listen(9000,()=>{
    console.log("服务启动成功~");
})

7.中间件匹配规则

当你书写了很多中间件，你发送一个请求，他会按照代码书写顺序依次匹配(普通中间件与路径及方法中间件一视同仁)，先执行代码最上面的中间件，后续匹配上的中间件有没有执行取决于上一个匹配中间件有没有调next()

8.应用中间件-处理请求参数（express内置）

const express = require('express')
const app = express()
// 应用中间件
// 处理json数据
app.use(express.json())
// 处理urlencode数据
// 默认使用是querystring模块有过期提示，配置extended: true使用qs模块
app.use(express.urlencoded({extended: true}))
app.post('/home',(req,res,next) => {
    // 直接在req.body获取处理好的数据
    console.log(req.body);
})
app.listen(9000,()=>{
    console.log("服务启动成功");
})

9.应用中间件-打印日志

const fs = require('fs')
const express = require('express')
// 安装导入morgan
const morgan = require('morgan')
const app = express()
const writeStream = fs.createWriteStream('./log/access.log')
// 应用中间件
app.use(morgan('combined',{stream:writeStream}))
app.post('/home',(req,res,next) => {
    
    res.end('请求成功')
})
app.listen(9000,()=>{
    console.log("服务启动成功");
})

10.应用中间件-文件上传

const express = require('express')
// 安装导入multer
const multer = require('multer')
const app = express()

// 应用中间件
const upload = multer({
    storage: multer.diskStorage({
        // 存储位置
        destination(req,file,callback) {
            callback(null, './uploads')
        },
        // 存储名称
        filename(req,file,callback) {
            callback(null,file.originalname)
        }
    })
})

app.post('/home',upload.array('home') ,(req,res,next) => {
    console.log(req.files);
    res.end('请求成功')
})
app.listen(9000,()=>{
    console.log("服务启动成功");
})

11.响应数据

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


app.post('/home',(req,res,next) => {
    //方式一：使用最少
    // res.end('请求成功')
    //方式二：推荐使用
    // res.json({
    //     message: 'ok',
    //     statusCode: 0,
    //     data: [
    //         {
    //             name:'zhao'
    //         }
    //     ]
    // })
    // status方法，用于设置状态码
    res.status(201)
    res.end('请求成功')
})
app.listen(9000,()=>{
    console.log("服务启动成功");
})

12.express中路由的使用

我们在开发中，业务逻辑是非常大的，不能全部写在app中

1. router/userRouter.js

const express = require('express')
// 创建路由对象
const userRouter = express.Router()

// 定义路由对象中的映射接口
userRouter.get('/',(req,res,next)=>{
    res.json('获取数据成功')
})
userRouter.delete('/:id',(req,res,next)=>{
    res.json('删除某个数据成功'+req.params.id)
})
// 导出
module.exports = userRouter

2. app

const express = require('express')
const userRouter = require('./router/userRouter')
const app = express()

// 应用路由对象
app.use('/user',userRouter)
app.listen(9000,()=>{
    console.log("服务启动成功");
})

13.express部署静态资源服务器

对于一些图片啥的，用户不能直接在浏览器查看，使用express内置中间件，可以域名加文件名查看

const express = require('express')
const app = express()
// 内置的中间件，直接将一个文件夹作为静态资源
app.use(express.static('./uploads'))

app.listen(9000,()=>{
    console.log("服务启动成功");
})

http://localhost:9000/avatar2.png 访问图片
也可以部署我们之前做过的项目，把打包好的dist文件夹放到express.static()中，可以直接访问

14.express错误处理

在常规的服务器开发中，后端处理错误信息主要是两种方式

1. 修改res.status，比如没有权限把status修改完401
2. 还有一种是不修改status，依旧返回200.在返回体中加一个code进行判断，比如正确是code = 0 其他错误code = -1001
   在express中我们也要处理错误

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

app.use(express.json())
app.post('/login',(req,res,next)=>{
    const {username, password} = req.body
    if (!username || !password) {
    // 错误处理代码写在这里太臃肿了
        next(-1001)
    } else if(username !== 'zhao' || password !== '123456') {
        next(-1002)
    } else {
        res.json({
            code: 0,
            message: '登录成功'
        })
    }
})
// 处理错误，四个参数
app.use((err,req,res,next)=>{
    const code = err
    let message = '未知错误'
    switch (code) {
        case -1001:
            message = '请输入账号密码'
            break;
        case -1002:
            message = '账号密码错误'
            break;
        default:
            break;
    }
    res.json({code,message})
})
app.listen(9000,()=>{
    console.log("服务启动成功");
})