众所周知JavaScript因为语言的特性，无法与JAVA一样提供一种动态类型反射机制，而市面上又缺乏完善的解决方案，EasyType的出现是为了从根本上解决这个问题, 赋予开发者尤其是后端开发者更多的能力。
从18年开始，我就决定让团队使用node+typescript来开发后端服务，经过一年多的实践，发现各种库都有一套自己的“建模语言”来申明类型，比如mongoose、数据验证器、GraphQL、GRPC、swagger等等。这不禁让我迷惑不解，为什么用了typescript以后还要重复写这么多的类型申明？于是我从19年初开始开发了这个框架陆续来实现。刚开始是通过AST来分析mongoose的schema生成模型接口和定义，但是没有从根本上解决问题，所以接下来是通过直接分析typescript的类申明来实现，后续又引入了json-schema标准，最后对枚举、方法、联合类型、泛型都提供了支持。
- 能够覆盖typescript绝大多数的类型，尤其是对泛型能提供完善的支持。
- 尽可能的减少侵入，无需改动任何的代码
- 支持Transpile模式，无需构建即可直接运行，而且编译速度非常快
- 能够通过cli运行与构建项目,也能够脱离cli运行或者构建项目
| 项目 | 对比 |
|---|---|
| io-ts | 定义了一套类型声明，设计目标可能主要是解决IO传输中的编码与解码 |
| class-transformer | 定义了一套修饰器，只支持部分的TS类型 |
| typescript-json-schema | 需要调用CLI生成JSON格式的类型声明，非动态 |
| tsruntime | 是和typescript-json-schema一样在TypeCheck阶段实现，因此不支持Transpile模式 |
| type-reflect | 类似，但功能不够完善 |
引入EasyType将为你的后端开发带来更大的想象空间，其中我们团队用到的部分就包括：
- 不用添加任何代码，将TS类申明直接转换成mongoose schema
- 不用添加任何代码，可以直接使用各种json-schema数据验证器
- 不用添加任何代码，动态生成API文档，稍微改动就能生成OpenAPI规范的swagger文档，你的接口改动团队其他成员可以随时看到。
- 不用添加任何代码，动态生成RPC声明，比如一键生成GRPC proto申明文件，把微服务开发变成一件很轻松的事情。
- 由于后端能够输出完整的类型申明，因此前端（尤其是后台开发）能够快速的构建出数据显示、操作界面，会使开发变得更快速高效。
通过typescript的自定义transform，在编译阶段把类型写入类描述中，最后在运行时生成json-schema标准的类型说明。
@Reflectable()
export class User extends Document {
/** 用户ID */
uid: number;
/** 用户名 */
username: string;
}比如以上代码，通过编译器将变为:
export class User extends Document {
$easy.IsObject({
$type: 1,
$properties: {
uid: {
$type: 2,
$description: "\u7528\u6237ID",
$ref: Number
},
username: {
$type: 2,
$description: "\u7528\u6237\u540D",
$ref: String
},
},
$target: User,
$id: "User",
$extends: mongoose_1.Document
})
private $metadata: any;
}通过在运行时调用 Schema.getMetadata(User), 即可得到User的类型声明(json-schema):
{
"type": "object",
"properties": {
"_id": {
"type": "string",
"format": "OBJECT_ID",
"description": "ID"
},
"uid": {
"type": "number",
"description": "用户ID",
},
"username": {
"type": "string",
"description": "用户名",
}
},
"required": [
"_id",
"uid",
"username"
],
"$id": "User",
"$x": "Document"
}在typescript中enum的存在更像是为了描述类型（你在运行时很难分清哪个是key,哪个是value），这也就不能与JAVA一样提供一些操作, 因此EasyType在编译阶段增加一些方法，使之变得更加灵活和强大，借助这些特性我们就能够实现无缝输出ENUM信息到API文档，而无需再书写任何的注释或者代码。
export interface EnumInterface<T> {
readonly keys: string[];
readonly values: number[] | string[];
getValue(key: string): Undefinable<T>;
hasValue(value: any): boolean;
getKeys(value: any): string[];
getKey(value: any): Undefinable<string>;
hasKey(key: string): boolean;
getDescription(key: string): Undefinable<string>;
}
export type Enum<T = any, V = number | string> =
{ readonly [P in keyof T]: T[P]; }
& Readonly<EnumInfo>
& EnumInterface<V>
;现在你可以通过 Enum<Foo>.Keys 和 Enum<Bar>.values 获得键值，也可以拿到对应的像这样的类型申明：
{
"name": "AssetType",
"description": "用户资产类型",
"fields": [
{
"key": "BALANCE",
"value": 1,
"description": "账户余额"
},
{
"key": "POINTS",
"value": 3,
"description": "账户积分"
}
]
},使用关键词extends会继承基类所有的属性，有时候如果你想部分继承基类属性，可以使用Inherits语法糖：
@Reflectable()
export class UserLoginDto implements Inherits<User> {
username: string;
password: string;
}方法的注释、修饰符、参数、返回值等信息会被标注到Metadata中，可以通过 Reflect.getMetadata('easy:metadata', target, propertyKey) 获取。
- 还没来得及做完整的单元测试，所以暂时不能用于商业项目
- 泛型目前编译器这块已完成，但是运行时由于时间关系还未能提供支持
- 由于设计原因，只能支持类的输出，不支持interface和type的输出，因为前者在js运行时以function存在，后者不存在于运行时，或许后面会想办法支持。
- 低版本的TypeScript（3.7以下）会有一些问题，所以用最新的TSC编译吧。
即将推出基于EasyType+nest.js的全家桶开发包，尽情期待。 项目地址: https://github.com/davanchen/easynest