Uma 与 Koa

使用客户端与服务端通用开发语言的问题是一直是开发者需要面临的问题，而 NodeJs 的出现使得 JavaScript 一跃成为最流行的 web 开发语言。各类 node web 框架层出不穷，其中不乏著名的 Express、Koa......

Koa

Express 无疑是使用最广泛的 node 框架，从 github start 可以看出来其受欢迎的程度，但基于 ECMAScript 版本的变化，Express 很多功能受到 ES5 的约束，比如一直令人头疼的Callback Hell在新窗口中打开。

为解决一系列问题，TJ在新窗口中打开发现对 Express 进行重构似乎更加困难，于是就有了现在的 Koa。

架构设计

Express 一体式的架构设计能够让开发者快速的搭建一个 node server，其自身集成了例如 static在新窗口中打开、 router在新窗口中打开、 views在新窗口中打开等功能，能够为开发者提供静态文件、路由方法、模板引擎等服务。庞大的社区也为其提供了众多中间件模块，其成熟稳定的生态环境是众多开发者选择的关键因素。但是这也使整个框架显得较为厚重，毕竟一部分功能开发者可能并不会使用到。

而 Koa 则是摒弃了原有思想，致力于实现一个轻量级应用框架,事实上它确实非常轻巧，只有大约 550 行代码。它将原有功能进行拆分，分包成各个模块，因此拥有大量有用的方法但占用空间很小,开发者可以根据需要进行引用。

Middleware

核心设计的不同也使得 Koa 与 Express 风格的中间件不兼容，大量原社区资源无法直接利用。

模型

相比 Express 中间件执行的线性流程，Koa 采用堆栈形式的先进后出，可以更全面的对 HTTP 流程做出响应，下图为 Koa 洋葱模型：
Koa onion

Express 中间件只有两个参数 request 与 response，Koa 2.x 比 Express 增加了一个上下文的对象 Context在新窗口中打开，并且将 request 与 response 挂载在 context 上作为第一个参数传入。

在 Koa 中开发者可以很方便地对 ctx 对象进行拓展，并且在所有中间件中进行共享。

Error handling

Express 附带一个错误处理程序，但使用起来较为繁琐，对于异步代码需要手动调用 next 传递错误信息。
Koa 配合 try..catch.. 的错误处理方式便显得更加优雅。

app.use(async (ctx, next) => {
  try {
    await next()
  } catch (err) {
    ctx.status = err.status || 500
    ctx.body = { info: 'error...' }
    ctx.app.emit('error', err, this)
  }
})

1
2
3
4
5
6
7
8
9

Uma

使用 Koa，你可以很快构建出性能出色的 Web 应用程序，不再被回调所困扰、更快的处理错误......但 Koa 作为一个轻量级框架它更多地只是提供一些基础性服务。

Uma 在 Koa 2 的基础上对其进行了拓展，致力于为开发者提供一个更加强大、便捷、易于开发和维护的企业级 Web 应用框架。

架构

流程图

用户请求达到 router
router 解析请求穿过 plugin 中的中间件，然后到达 controller
controller 可以通过 IOC 调用 service 和 resource
controller、service、resource 等可以通过 AOP 的 Aspect 进行切面开发
controller 返回 Result，Umajs 解析 Result 按 Koa 框架格式返回数据
AOP 可以对 controller、service、resource 进行切面开发，还可以将 middleware 封装成 Aspect.around 对 controller 进行切页面开发
中间件（middleware）有提供两种形式使用，一种是插件配置(plugin.config.ts)，一种是封装成 Aspect.around 以装饰器形式使用
Plugin 有两种形式进行扩展，一种中间件形式、一种复合形式

特性

TypeScript

如果你有过 Java 开发经验，那你一定体会过静态语言所带来的优势。 TypeScript在新窗口中打开作为 JavaScript 的超集，使得 JS 能够实现静态类型检测，更加有利于构建复杂的大型项目。

Uma 使用 TS 进行源码开发，我们强烈建议开发者配合使用 Uma + TS 。

易于理解

代码中有函数参数类型、返回值类型、变量类型以及泛型约束这些类型信息作为辅助，能让生疏的代码更易于理解。这在接手新项目、阅读开源代码以及代码评审实践中都能带来很多便利。

IDE 支持

由于静态类型的原因，一些 IDE 能够为开发者提供比往常更多的预测性辅助功能，如智能补全与路径跟踪。如果你不想在运行时才发现一堆错误提示，那么 TS 将是一个很好的选择。

新特性与兼容

TS 较好的兼容了一些未来语法，你可以使用 ES6、ES7 及更高版本中的新功能，编译器会为你将他们转换为 ES5 或者你所指定的内容。

IOC / DI

事实上控制反转在新窗口中打开与依赖注入在新窗口中打开是同一个概念，Uma 框架设计继承了这样的思想，你可以将与核心业务无关的代码抽离出去交给系统来为你寻找依赖，这对于代码解耦有着重要的意义。

对于某几个类，你可以选择不使用 DI，但是对于一个大型项目来说依赖管理要复杂得多，而 Uma 框架可以很好的来帮助你管理你的依赖项和对象之间的交互。特别是在编写单元测试时，你可以独立于其他对象添加和测试对象，而不需要设置任何无关项。

AOP

AOP（面向切面编程）扩展了传统的 OOP（面向对象编程）模型，以改善跨不同对象层次结构的代码重用。AOP 基本概念是一个切面，这是一种常见的行为，通常分散在方法，类，对象层次结构甚至整个对象模型中。

例如：我们需要在代码中添加日志功能，但日志打印并不是我们核心业务需要关注的。
在 AOP 中，日志功能作为横切关注点，会建议将其抽象化并封装到一个切面中去。

Uma 提供 @Aspect 装饰器作为 IOC 容器，你可以在 aspect 文件夹下新建自己的切面，并且定义 5 类通知：

前置通知
后置通知
异常通知
最终通知
环绕通知

开发者可以通过调用@Aspect('xx')的方式在类或方法中织入切面。

更多使用方式可查看AOP一节。

# Uma 与 Koa

# Koa

# 架构设计

# Middleware

# Error handling

# Uma

# 架构

# 流程图

# 特性

# TypeScript

# IOC / DI

# AOP

详情