能够动态推断与生成DTO是Node生态的一个重要里程碑
发布于 3 小时前 作者 zhennann 19 次浏览 来自 分享

在开发后端 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关系

@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 方法

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 进行动态推断与生成

+ 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 效果如下:

dto-1.png

4. 封装DTO

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

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

@Dto()
export class DtoOrderResult
+ extends $Dto.get(() => ModelOrder, { include: { products: true } }) {}
  1. 现在,我们再使用DtoOrderResult重构前面的 API 代码:
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

回到顶部