VonaJS 5.0 隆重推出自动推断生成 DTO 的功能
在Nodejs生态中，Prisma是一个非常流行的ORM库，支持Typescript，提供了非常友好的类型推断能力。但是，Prisma却不能优雅的支持DTO。在与其他后端框架整合时，DTO是进行参数验证、生成Swagger元数据的关键节点。如果不能像推断类型一样自动推断出DTO，那么，我们就仍然需要手工创建DTO。随着业务的增长，复杂的表间关系会让手工补充DTO的工作日益繁重。 而VonaJS 5.0就提供了非常便利的工具，使我们可以非常直观的动态推断出DTO，就像推断类型一样，从而解放我们的双手，显著提升生产力。甚至可以说，能够自动推断DTO，为Nodejs后端框架打开了一扇窗。 限于篇幅，这里不展开讲解Vona ORM所有的知识点，而是以目录树为例，演示如何查询一棵目录树，以及如何动态生成DTO，并最终生成Swagger元数据。 1. 创建Entity 在VSCode中，可以通过右键菜单Vona Create/Entity创建Entity的代码骨架： @Entity('demoStudentCategory') export class EntityCategory extends EntityBase { @Api.field() name: string; @Api.field(v.optional()) categoryIdParent?: TableIdentity; } 行2: 继承自EntityBase，就会自动提供5个基础字段：id、createdAt、updatedAt、deleted、iid iid：是实例Id，通过多实例的机制支持多租户系统的开发 行4、7: 定义两个业务字段：name、categoryIdParent @Api.field：通过此装饰器定义的信息，可同时应用于参数验证和Swagger元数据 v.optional：声明为可选字段 2. 创建Model 在VSCode中，可以通过右键菜单Vona Create/Model创建Model的代码骨架： import { EntityCategory } from '../entity/category.ts'; @Model({ entity: EntityCategory }) export class ModelCategory extends BeanModelBase {} 行3: entity：指定Model所对应的Entity 行4: 继承自BeanModelBase，从而拥有大量操作数据库的方法，如：CRUD、聚合、分组，等等 3. 创建树形结构 如果要创建一棵目录树，本质就是建立Model引用自身的递归结构。Vona ORM同样支持4种关系：1对1、1对多、多对1，多对多。那么，在这里，我们就需要采用1对多来创建目录的自身引用关系。 import { EntityCategory } from '../entity/category.ts'; @Model({ entity: EntityCategory, + relations: { + children: $relation.hasMany(() => ModelCategory, 'categoryIdParent', { + autoload: true, + columns: ['id', 'name'], + }), + }, }) export class ModelCategory extends BeanModelBase {} 行5: relations：可以定义多个关系 行6: children：定义一个1对多的关系 $relation.hasMany： 参数1: 引用自身ModelCategory 参数2: 设置关联外键categoryIdParent 参数3: 关联选项 autoload：是否自动加载关联数据 columns：控制关联数据的字段列表 4. 创建Controller 在VSCode中，可以通过右键菜单Vona Create/Controller创建Controller的代码骨架： @Controller() export class ControllerCategory extends BeanBase {} 接下来我们创建一个Api，用于获取目录树： export class ControllerCategory extends BeanBase { @Web.get('getCategoryTree') async getCategoryTree() { } } 行2: 通过@Web.get定义一个api，path为getCategoryTree 5. 查询目录树 一般而言，我们还需要创建一个Service，从而实现以下调用链：Controller->Service->Model->操作数据库。为了简化起见，在这里，我们直接在Controller中调用Model方法： export class ControllerCategory extends BeanBase { @Web.get('getCategoryTree') async getCategoryTree() { const tree = await this.scope.model.category.select({ columns: ['id', 'name'], }); return tree; } } 行4: 通过this.scope取得Category Model，然后调用select方法 columns：指定要查询的字段列表 由于前面我们设置children关系为autoload: true，因此，查询结果tree就是一棵完整的目录树。下面我们看一下tree的类型推断效果： 6. 自动推断DTO 现在我们自动推断DTO，并且设为API的返回数据的类型： export class ControllerCategory extends BeanBase { @Web.get('getCategoryTree') + @Api.body(v.array(v.object($Dto.get(() => ModelCategory, { columns: ['id', 'name'] })))) async getCategoryTree() { const tree = await this.scope.model.category.select({ columns: ['id', 'name'], }); return tree; } } 行3: 通过@Api.body定义API返回数据的类型： v.array：定义数组类型 v.object：定义对象类型 $Dto.get：动态推断DTO 参数1：指定目标Model 参数2：指定选项 columns：指定要提取的字段列表 同样，由于前面我们设置children关系为autoload: true，因此，$Dto.get生成的DTO就是一棵完整的目录树。下面我们看一下API的Swagger效果： 从示意图中，我们可以清晰的看到，这棵树引用的children类型是名称为demo-student.entity.category_2c7d642ee581efa300341e343180fbb0ecdc785d的动态Entity的数组，从而形成一种递归的引用关系。 7. 封装DTO 虽然我们已经实现了预期的目标，但是Vona ORM提供的能力还没有结束。我们可以创建一个新的DTO，将前面的代码$Dto.get(() => ModelCategory, { columns: ['id', 'name'] })封装起来，从而用于其他地方： 在VSCode中，可以通过右键菜单Vona Create/Dto创建DTO的代码骨架： @Dto() export class DtoCategoryTree {} 然后我们通过继承机制来封装DTO： @Dto() export class DtoCategoryTree + extends $Dto.get(() => ModelCategory, { columns: ['id', 'name'] }) {} 现在，我们再使用新创建的DTO来改造前面的API代码： export class ControllerCategory extends BeanBase { @Web.get('getCategoryTree') + @Api.body(v.array(v.object(DtoCategoryTree))) + async getCategoryTree(): Promise<DtoCategoryTree[]> { const tree = await this.scope.model.category.select({ columns: ['id', 'name'], }); return tree; } } 行3: 直接传入DtoCategoryTree 行4: 返回类型为Promise<DtoCategoryTree[]>
