MikroORM中实现虚拟属性在Embeddable中的水合机制

在MikroORM这个Node.js的ORM框架中，Embeddable(可嵌入实体)是一个非常有用的特性，它允许我们将一组相关属性封装到一个可重用的类中。然而，当我们需要在Embeddable中使用虚拟属性(即不映射到实际数据库列的属性)时，会遇到一些挑战。

问题背景

在MikroORM的标准用法中，Embeddable通常用于表示实际存储在数据库中的值。但某些场景下，开发者希望将Embeddable用作计算属性的容器，这些属性并不直接对应数据库列，而是通过查询计算得出的。

例如，我们可能有一个统计信息的Embeddable，包含销售额、票数、收入等指标，这些数据是通过复杂查询聚合计算得出的，而非直接存储的字段。

技术实现方案

MikroORM通过persist: false配置项来标记虚拟属性。当在Embeddable中使用时，需要特别注意以下几点：

1. 属性级配置：在每个Embeddable属性上明确设置persist: false
2. 查询构建：使用QueryBuilder时，需要确保select语句中的别名与Embeddable属性名匹配
3. 水合机制：MikroORM会自动处理这些虚拟属性的水合过程

实际应用示例

以下是一个典型的使用场景：

@Entity()
export class EventEntity {
  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })
  id: string;

  @Property()
  name: string;

  @Embedded(() => Statistic, { nullable: true })
  statistic?: Statistic;
}

@Embeddable()
export class Statistic {
  @Property({ type: 'int', persist: false })
  sales?: number;

  @Property({ type: 'int', persist: false })
  tickets?: number;
  
  // 其他统计属性...
}

查询构建示例：

const qb = em.createQueryBuilder(EventEntity, 'e')
  .select([
    'e.*',
    'sum(oi.amount) as tickets',
    'count(distinct oi.order_id) as sales'
    // 其他计算字段...
  ])
  // 连接和分组条件...

注意事项

1. 性能考量：虚拟属性的计算通常发生在数据库层面，比应用层计算更高效
2. 类型安全：确保查询结果中的列别名与Embeddable属性名完全匹配
3. 默认行为：persist: true是默认值，在Embeddable中显式设置为false才能创建虚拟属性
4. 继承规则：在父级Embedded装饰器上设置persist: false会使所有子属性变为虚拟属性

最佳实践

1. 对于纯计算属性，建议统一使用persist: false标记
2. 考虑将相关计算逻辑封装到Repository或Service层
3. 对于复杂统计场景，可以结合数据库视图使用
4. 在团队开发中，明确文档说明Embeddable的使用方式

MikroORM的这种设计提供了灵活性，既支持传统的持久化Embeddable，也支持计算属性的场景，开发者可以根据实际需求选择最适合的方案。