从零开始搭建实战级Nodejs服务项目 —— 2. 洋葱模型

从零开始搭建实战级Nodejs服务项目 —— 2. 洋葱模型

前言

ExpressKoa 基本上是我们最熟悉的开发框架。

我们在这里选用 Koa2 ,不仅仅是因为它是由 Express 原班人马打造的下一代Web开发框架, 更是因为它遵循的“洋葱模型”。且在 koa2 中使用 Promise, 因此可以结合 async/await 编写出更易于理解与维护的代码,更符合 Node.js 的开发习惯。

那么,到底什么是“洋葱模型”呢?我们从AOP讲起。

AOP 面向切面编程

AOP(Aspect Oriented Programming)通过预编译方式和运行期间动态代理实现程序功能的 统一维护 的一种技术。

简单来说,AOP利用一种称为"横切"的技术,将那些与业务无关,却为业务模块所共同调用的逻辑或责任,例如事务处理、日志管理、权限控制等,封装起来,便于减少系统的重复代码,降低模块之间的耦合度,并有利于未来的可操作性和可维护性。

特点:低耦合,高聚合。

洋葱模型

如果我们想要穿透一个洋葱,就需要先穿过一层一层的洋葱皮,到达洋葱核心,再从核心穿过洋葱皮到达另一边。

洋葱的每一层皮,对应的就是一个中间件,其生命周期大致有:

  • 进入中间件
  • 前期处理
  • 等待下游中间件处理完成
  • 后期处理
  • 离开中间件

多个中间件组合就形成了一个洋葱,由 requestresponse 就形成了一次穿透,这就形成了洋葱模型

从零开始搭建实战级Nodejs服务项目 —— 2. 洋葱模型

宏观上来说,Koa本身只是一个遵循洋葱模型的中间件管理器,不与任何的中间件绑定。再利用 koa-static koa-bodyparser koa-router 等插件以中间件形式加载。形成最基本的http框架。

对于Web应用而言,一次Http请求通常包含很多工作,如Cookie处理、ip过滤、权限验证、异常处理、记录日志等,这些基础方法都可以以中间件形式加载在Koa框架上。隔离与业务逻辑之间的细节,提升开发效率。

这也是 AOP 面向切面编程的一种应用。

安装依赖

npm install koa koa-body koa-logger koa-router --save

修改 src/app.js 项目入口文件

import Koa2 from 'koa'
import koaLogger from 'koa-logger'
import koaBody from 'koa-body'
import router from './router'

const env = process.env.NODE_ENV || 'development'

const app = new Koa2()

// Console
app.use(koaLogger())
// Body Format
app.use(koaBody())
// Routes
app.use(router.routes())
app.use(router.allowedMethods())

if (env === 'development') {
  app.use(async (ctx, next) => {
    const start = new Date()
    await next()
    const ms = new Date() - start
    console.log(`${ctx.method} ${ctx.url} - ${ms}ms`)
  })
}

app.listen(9000)

console.log('Now start API server on port 9000 ...')

创建 src/router.js 路由文件

import KoaRouter from 'koa-router'

const router = new KoaRouter()

router.get('/', (ctx, next) => {
  ctx.body = 'hello focus'
})

router.get('/error', (ctx, next) => {
  throw new Error('Ops...')
})

export default router

启动项目

npm run dev

现在我们就可以在浏览器访问 http://localhost:9000/

从零开始搭建实战级Nodejs服务项目 —— 2. 洋葱模型

但是,如果我们访问 http://localhost:9000/error 会发现显示的是服务错误信息,并且返回的状态码为500

从零开始搭建实战级Nodejs服务项目 —— 2. 洋葱模型

作为一个API服务器,我们希望即使程序出错了,返回的状态码依然是200,错误信息放在响应数据里,且依然为JSON格式。

异常处理中间件

src/app.js 入口中添加一个中间件

// code ...
const app = new Koa2()

// 异常处理
app.use(async (ctx, next) => {
  try {
    await next()
  } catch (error) {
    ctx.body = { status: ctx.status, message: error.message }
    ctx.status = 200
  }
})
// Console
app.use(koaLogger())
// code ...

此时再访问 http://localhost:9000/error 会发现状态码已变成200,且错误信息放在JSON格式的响应数据中。

从零开始搭建实战级Nodejs服务项目 —— 2. 洋葱模型

小结

至此,我们已经了解了Koa2框架以及中间件的基本工作原理。

下一章将会给大家讲解项目的目录结构,以及 MVC 模式的变形及应用。

上一篇:全栈项目|小书架|服务器开发-Koa2中间件机制洋葱模型了解一下


下一篇:koa里面cookies的使用