node项目实战二

4. 文章分类管理

4.1 新建 ev_article_cate 表

4.1.1 创建表结构

4.1.2 新增两条初始数据

4.2 获取文章分类列表

4.2.0 实现步骤

1. 初始化路由模块
2. 初始化路由处理函数模块
3. 获取文章分类列表数据

4.2.1 初始化路由模块

1. 创建 /router/artcate.js 路由模块，并初始化如下的代码结构：

// 导入 express
const express = require('express')
// 创建路由对象
const router = express.Router()
​
// 获取文章分类的列表数据
router.get('/cates', (req, res) => {
  res.send('ok')
})
​
// 向外共享路由对象
module.exports = router

2. 在 app.js 中导入并使用文章分类的路由模块：

// 导入并使用文章分类路由模块
const artCateRouter = require('./router/artcate')
// 为文章分类的路由挂载统一的访问前缀 /my/article
app.use('/my/article', artCateRouter)

4.2.2 初始化路由处理函数模块

1. 创建 /router_handler/artcate.js 路由处理函数模块，并初始化如下的代码结构：

// 获取文章分类列表数据的处理函数
exports.getArticleCates = (req, res) => {
  res.send('ok')
}

2. 修改 /router/artcate.js 中的代码如下：

const express = require('express')
const router = express.Router()
​
// 导入文章分类的路由处理函数模块
const artcate_handler = require('../router_handler/artcate')
​
// 获取文章分类的列表数据
router.get('/cates', artcate_handler.getArticleCates)
​
module.exports = router

4.2.3 获取文章分类列表数据

1. 在 /router_handler/artcate.js 头部导入数据库操作模块：

// 导入数据库操作模块
const db = require('../db/index')

2. 定义 SQL 语句：

// 根据分类的状态，获取所有未被删除的分类列表数据
// is_delete 为 0 表示没有被 标记为删除 的数据
const sql = 'select * from ev_article_cate where is_delete=0 order by id asc'

3. 调用 db.query() 执行 SQL 语句：

db.query(sql, (err, results) => {
  // 1. 执行 SQL 语句失败
  if (err) return res.cc(err)
​
  // 2. 执行 SQL 语句成功
  res.send({
    status: 0,
    message: '获取文章分类列表成功！',
    data: results,
  })
})

4.3 新增文章分类

4.3.0 实现步骤

1. 定义路由和处理函数
2. 验证表单数据
3. 查询 分类名称 与 分类别名 是否被占用
4. 实现新增文章分类的功能

4.3.1 定义路由和处理函数

1. 在 /router/artcate.js 模块中，添加 新增文章分类 的路由：

// 新增文章分类的路由
router.post('/addcates', artcate_handler.addArticleCates)

2. 在 /router_handler/artcate.js 模块中，定义并向外共享 新增文章分类 的路由处理函数：

// 新增文章分类的处理函数
exports.addArticleCates = (req, res) => {
  res.send('ok')
}

4.3.2 验证表单数据

1. 创建 /schema/artcate.js 文章分类数据验证模块，并定义如下的验证规则：

// 导入定义验证规则的模块
const joi = require('@hapi/joi')
​
// 定义 分类名称 和 分类别名 的校验规则
const name = joi.string().required()
const alias = joi.string().alphanum().required()
​
// 校验规则对象 - 添加分类
exports.add_cate_schema = {
  body: {
    name,
    alias,
  },
}

2. 在 /router/artcate.js 模块中，使用 add_cate_schema 对数据进行验证：

// 导入验证数据的中间件
const expressJoi = require('@escook/express-joi')
// 导入文章分类的验证模块
const { add_cate_schema } = require('../schema/artcate')
​
// 新增文章分类的路由
router.post('/addcates', expressJoi(add_cate_schema), artcate_handler.addArticleCates)

4.3.3 查询分类名称与别名是否被占用

1. 定义查重的 SQL 语句：

// 定义查询 分类名称 与 分类别名 是否被占用的 SQL 语句
const sql = `select * from ev_article_cate where name=? or alias=?`

2. 调用 db.query() 执行查重的操作：

// 执行查重操作
db.query(sql, [req.body.name, req.body.alias], (err, results) => {
  // 执行 SQL 语句失败
  if (err) return res.cc(err)
​
  // 判断 分类名称 和 分类别名 是否被占用
  if (results.length === 2) return res.cc('分类名称与别名被占用，请更换后重试！')
  // 分别判断 分类名称 和 分类别名 是否被占用
  if (results.length === 1 && results[0].name === req.body.name) return res.cc('分类名称被占用，请更换后重试！')
  if (results.length === 1 && results[0].alias === req.body.alias) return res.cc('分类别名被占用，请更换后重试！')
​
  // TODO：新增文章分类
})

4.3.4 实现新增文章分类的功能

1. 定义新增文章分类的 SQL 语句：

const sql = `insert into ev_article_cate set ?`

2. 调用 db.query() 执行新增文章分类的 SQL 语句：

db.query(sql, req.body, (err, results) => {
  // SQL 语句执行失败
  if (err) return res.cc(err)
​
  // SQL 语句执行成功，但是影响行数不等于 1
  if (results.affectedRows !== 1) return res.cc('新增文章分类失败！')
​
  // 新增文章分类成功
  res.cc('新增文章分类成功！', 0)
})

4.4 根据 Id 删除文章分类

4.4.0 实现步骤

1. 定义路由和处理函数
2. 验证表单数据
3. 实现删除文章分类的功能

4.4.1 定义路由和处理函数

1. 在 /router/artcate.js 模块中，添加 删除文章分类 的路由：

// 删除文章分类的路由
router.get('/deletecate/:id', artcate_handler.deleteCateById)

2. 在 /router_handler/artcate.js 模块中，定义并向外共享 删除文章分类 的路由处理函数：

// 删除文章分类的处理函数
exports.deleteCateById = (req, res) => {
  res.send('ok')
}

4.4.2 验证表单数据

1. 在 /schema/artcate.js 验证规则模块中，定义 id 的验证规则如下：

// 定义 分类Id 的校验规则
const id = joi.number().integer().min(1).required()

2. 并使用 exports 向外共享如下的 验证规则对象：

// 校验规则对象 - 删除分类
exports.delete_cate_schema = {
  params: {
    id,
  },
}

3. 在 /router/artcate.js 模块中，导入需要的验证规则对象，并在路由中使用：

// 导入删除分类的验证规则对象
const { delete_cate_schema } = require('../schema/artcate')
​
// 删除文章分类的路由
router.get('/deletecate/:id', expressJoi(delete_cate_schema), artcate_handler.deleteCateById)

4.4.3 实现删除文章分类的功能

1. 定义删除文章分类的 SQL 语句：

const sql = `update ev_article_cate set is_delete=1 where id=?`

2. 调用 db.query() 执行删除文章分类的 SQL 语句：

db.query(sql, req.params.id, (err, results) => {
  // 执行 SQL 语句失败
  if (err) return res.cc(err)
​
  // SQL 语句执行成功，但是影响行数不等于 1
  if (results.affectedRows !== 1) return res.cc('删除文章分类失败！')
​
  // 删除文章分类成功
  res.cc('删除文章分类成功！', 0)
})

4.5 根据 Id 获取文章分类数据

4.5.0 实现步骤

1. 定义路由和处理函数
2. 验证表单数据
3. 实现获取文章分类的功能

4.5.1 定义路由和处理函数

1. 在 /router/artcate.js 模块中，添加 根据 Id 获取文章分类 的路由：

router.get('/cates/:id', artcate_handler.getArticleById)

2. 在 /router_handler/artcate.js 模块中，定义并向外共享 根据 Id 获取文章分类 的路由处理函数：

// 根据 Id 获取文章分类的处理函数
exports.getArticleById = (req, res) => {
  res.send('ok')
}

4.5.2 验证表单数据

1. 在 /schema/artcate.js 验证规则模块中，使用 exports 向外共享如下的 验证规则对象：

// 校验规则对象 - 根据 Id 获取分类
exports.get_cate_schema = {
  params: {
    id,
  },
}

2. 在 /router/artcate.js 模块中，导入需要的验证规则对象，并在路由中使用：

// 导入根据 Id 获取分类的验证规则对象
const { get_cate_schema } = require('../schema/artcate')
​
// 根据 Id 获取文章分类的路由
router.get('/cates/:id', expressJoi(get_cate_schema), artcate_handler.getArticleById)

4.5.3 实现获取文章分类的功能

1. 定义根据 Id 获取文章分类的 SQL 语句：

const sql = `select * from ev_article_cate where id=?`

2. 调用 db.query() 执行 SQL 语句：

db.query(sql, req.params.id, (err, results) => {
  // 执行 SQL 语句失败
  if (err) return res.cc(err)
​
  // SQL 语句执行成功，但是没有查询到任何数据
  if (results.length !== 1) return res.cc('获取文章分类数据失败！')
​
  // 把数据响应给客户端
  res.send({
    status: 0,
    message: '获取文章分类数据成功！',
    data: results[0],
  })
})

4.6 根据 Id 更新文章分类数据

4.6.0 实现步骤

1. 定义路由和处理函数
2. 验证表单数据
3. 查询 分类名称 与 分类别名 是否被占用
4. 实现更新文章分类的功能

4.6.1 定义路由和处理函数

1. 在 /router/artcate.js 模块中，添加 更新文章分类 的路由：

// 更新文章分类的路由
router.post('/updatecate', artcate_handler.updateCateById)

2. 在 /router_handler/artcate.js 模块中，定义并向外共享 更新文章分类 的路由处理函数：

// 更新文章分类的处理函数
exports.updateCateById = (req, res) => {
  res.send('ok')
}

4.6.2 验证表单数据

1. 在 /schema/artcate.js 验证规则模块中，使用 exports 向外共享如下的 验证规则对象：

// 校验规则对象 - 更新分类
exports.update_cate_schema = {
  body: {
    Id: id,
    name,
    alias,
  },
}

2. 在 /router/artcate.js 模块中，导入需要的验证规则对象，并在路由中使用：

// 导入更新文章分类的验证规则对象
const { update_cate_schema } = require('../schema/artcate')
​
// 更新文章分类的路由
router.post('/updatecate', expressJoi(update_cate_schema), artcate_handler.updateCateById)

4.5.4 查询分类名称与别名是否被占用

1. 定义查重的 SQL 语句：

// 定义查询 分类名称 与 分类别名 是否被占用的 SQL 语句
const sql = `select * from ev_article_cate where Id<>? and (name=? or alias=?)`

2. 调用 db.query() 执行查重的操作：

// 执行查重操作
db.query(sql, [req.body.Id, req.body.name, req.body.alias], (err, results) => {
  // 执行 SQL 语句失败
  if (err) return res.cc(err)
​
  // 判断 分类名称 和 分类别名 是否被占用
  if (results.length === 2) return res.cc('分类名称与别名被占用，请更换后重试！')
  if (results.length === 1 && results[0].name === req.body.name) return res.cc('分类名称被占用，请更换后重试！')
  if (results.length === 1 && results[0].alias === req.body.alias) return res.cc('分类别名被占用，请更换后重试！')
​
  // TODO：更新文章分类
})

4.5.5 实现更新文章分类的功能

1. 定义更新文章分类的 SQL 语句：

const sql = `update ev_article_cate set ? where Id=?`

2. 调用 db.query() 执行 SQL 语句：

db.query(sql, [req.body, req.body.Id], (err, results) => {
  // 执行 SQL 语句失败
  if (err) return res.cc(err)
​
  // SQL 语句执行成功，但是影响行数不等于 1
  if (results.affectedRows !== 1) return res.cc('更新文章分类失败！')
​
  // 更新文章分类成功
  res.cc('更新文章分类成功！')
})

5. 文章管理

5.1 新建 ev_articles 表

5.2 发布新文章

5.2.0 实现步骤

1. 初始化路由模块
2. 初始化路由处理函数模块
3. 验证表单数据
4. 实现发布文章的功能

5.2.1 初始化路由模块

1. 创建 /router/article.js 路由模块，并初始化如下的代码结构：

// 导入 express
const express = require('express')
// 创建路由对象
const router = express.Router()
​
// 发布新文章
router.post('/add', (req, res) => {
  res.send('ok')
})
​
// 向外共享路由对象
module.exports = router

2. 在 app.js 中导入并使用文章的路由模块：

// 导入并使用文章路由模块
const articleRouter = require('./router/article')
// 为文章的路由挂载统一的访问前缀 /my/article
app.use('/my/article', articleRouter)

5.2.2 初始化路由处理函数模块

1. 创建 /router_handler/article.js 路由处理函数模块，并初始化如下的代码结构：

// 发布新文章的处理函数
exports.addArticle = (req, res) => {
  res.send('ok')
}

2. 修改 /router/artcate.js 中的代码如下：

const express = require('express')
const router = express.Router()
​
// 导入文章的路由处理函数模块
const article_handler = require('../router_handler/article')
​
// 发布新文章
router.post('/add', article_handler.addArticle)
​
module.exports = router

5.2.3 验证表单数据

实现思路：通过 express-joi 自动验证 req.body 中的文本数据

1. 创建 /schema/article.js 验证规则模块，并初始化如下的代码结构：

// 导入定义验证规则的模块
const joi = require('@hapi/joi')
​
// 定义 标题、分类Id、内容、发布状态 的验证规则
const title = joi.string().required()
const cate_id = joi.number().integer().min(1).required()
const content = joi.string().required().allow('')
const state = joi.string().valid('已发布', '草稿').required()
​
// 验证规则对象 - 发布文章
exports.add_article_schema = {
  body: {
    title,
    cate_id,
    content,
    state,
  },
}

2. 在 /router/article.js 模块中，导入需要的验证规则对象，并在路由中使用：

// 导入验证数据的中间件
const expressJoi = require('@escook/express-joi')
// 导入文章的验证模块
const { add_article_schema } = require('../schema/article')
​
// 发布新文章的路由
// 注意：在当前的路由中，先后使用了两个中间件：
//       先使用 multer 解析表单数据
//       再使用 expressJoi 对解析的表单数据进行验证
router.post('/add', upload.single('cover_img'), expressJoi(add_article_schema), article_handler.addArticle)

5.2.4 实现发布文章的功能

1. 整理要插入数据库的文章信息对象：

exports.addArticle = (req,res)=>{
    // 定义发布文章的 SQL 语句：
    const sql = `insert into ev_articles set ?`;
    let data = {
        ...req.body,
        pub_date: new Date(),
    }
    db.query(sql,data,(err,results)=>{
        if(err) return res.cc(err)
        // 执行 SQL 语句成功，但是影响行数不等于 1
        if(results.affectedRows != 1) return res.cc('新增文章失败')
​
        res.cc('新增文章成功！',0)
    })
}

5.3 获取文章列表

当你看到这句话的时候，我相信你已经可以自己写这个获取文章的列表了。

最后祝大家：事业越来越辉煌，生活越来越精彩