能够动态推断与生成DTO是Node生态的一个重要里程碑

在开发后端 API 服务时,DTO 是进行参数验证生成Swagger元数据的关键节点。如果不能像推断类型一样动态推断出 DTO,那么,我们就仍然需要手工创建 DTO。随着业务的增长,复杂的表间关系会让手工补充 DTO 的工作日益繁重

而 Vona ORM 首创 DTO 动态推断与生成能力,解放我们的双手,显著提升生产力。甚至可以说,对于构建更加优雅的 Node.js 后端框架而言,能够动态推断与生成 DTO,是非常重要的里程碑

DTO清单

Vona ORM 提供了以下 DTO:

名称 说明
get 标注返回结果
query 标注Query参数
queryPage 标注带分页的Query参数
selectAndCount 标注带分页的返回结果
create 标注Create参数
update 标注Update参数
aggregate 标注聚合操作的返回结果
group 标注分组操作的返回结果

DTO使用方法

下面以 Order/Product 为例,演示如何针对主表-明细表进行查询操作

1. Model关系定义

先在 Model Order 中定义与 Model Product 的1:n关系

typescript 复制代码
@Model({
  entity: EntityOrder,
  relations: {
    products: $relation.hasMany(() => ModelProduct, 'orderId', {
      columns: ['id', 'name', 'price', 'quantity', 'amount'],
    }),
  },
})
class ModelOrder {}
  • relations.products: 定义1:n关系

2. 创建Api端点

创建 Controller,提供 findAll 方法

typescript 复制代码
class ControllerOrder {
  @Web.get('findAll')
  async findAll() {
    return this.scope.model.order.select({
      include: {
        products: true,
      },
    });
  }
}
  • model.order: 是Order的model实例
  • select:指定include.products: true,从而查询出主表-明细表数据

3. 动态推断与生成DTO

由于此 Api 返回的结果是主表-明细表结构,我们不能简单的使用EntityOrder数组来标注返回类型。而是使用 DTO 进行动态推断与生成

diff 复制代码
+ import { $Dto } from 'vona-module-a-orm';

class ControllerOrder {
  @Web.get('findAll')
+ @Api.body(v.array($Dto.get(() => ModelOrder, { include: { products: true } })))
  async findAll() {
    return this.scope.model.order.select({
      include: {
        products: true,
      },
    });
  }
}
  • @Api.body:标注返回结果
  • v.array: 标注数组
  • $Dto.get: 用于动态推断与生成 DTO

$Dto.get生成的 DTO 是主表-明细表结构,其 Swagger/Openapi 效果如下:

4. 封装DTO

我们还可以创建一个新的 DTO class,将前面的$Dto.get动态推断代码封装起来,从而用于其他地方

  1. 在 VSCode 中,可以通过右键菜单Vona Create/Dto创建 DTO 的代码骨架:
typescript 复制代码
@Dto()
export class DtoOrderResult {}
  1. 使用继承机制来封装 DTO:
diff 复制代码
+ import { $Dto } from 'vona-module-a-orm';

@Dto()
export class DtoOrderResult
+ extends $Dto.get(() => ModelOrder, { include: { products: true } }) {}
  1. 现在,我们再使用DtoOrderResult重构前面的 API 代码:
diff 复制代码
class ControllerOrder {
  @Web.get('findAll')
+ @Api.body(v.array(DtoOrderResult))
+ async findAll(): Promise<DtoOrderResult[]> {
    return this.scope.model.order.select({
      include: {
        products: true,
      },
    });
  }
}
  • 行 3: 直接使用v.array(DtoOrderResult)标注类型
  • 行 4: 方法返回类型为Promise<DtoOrderResult[]>

Vona ORM已开源:github.com/vonajs/vona

相关推荐
Zuckjet_2 小时前
开启 3D 之旅 - 你的第一个 WebGL 三角形
前端·javascript·3d·webgl
2401_863801462 小时前
探索 12 种 3D 文件格式:综合指南
前端·3d
珍宝商店4 小时前
前端老旧项目全面性能优化指南与面试攻略
前端·面试·性能优化
bitbitDown4 小时前
四年前端分享给你的高效开发工具库
前端·javascript·vue.js
gnip5 小时前
实现AI对话光标跟随效果
前端·javascript
脑花儿6 小时前
ABAP SMW0下载Excel模板并填充&&剪切板方式粘贴
java·前端·数据库
Q_Q5110082856 小时前
python+django/flask+uniapp基于微信小程序的瑜伽体验课预约系统
spring boot·python·django·flask·uni-app·node.js·php
烛阴6 小时前
【TS 设计模式完全指南】构建你的专属“通知中心”:深入观察者模式
javascript·设计模式·typescript
lumi.7 小时前
Vue.js 从入门到实践1:环境搭建、数据绑定与条件渲染
前端·javascript·vue.js
二十雨辰7 小时前
vue核心原理实现
前端·javascript·vue.js