在 NestJS 中处理 MikroORM 与虚拟实体的关系

解析 NestJS 中实体和虚拟视图之间的 MikroORM 关系

使用 MikroORM 与 NestJS 和 PostgreSQL 的后端解决方案，专注于模块化和优化方法

// --- StockItem Entity ---
import { Entity, PrimaryKey, OneToOne, Ref } from '@mikro-orm/core';
@Entity()
export class StockItem {
  @PrimaryKey()
  id: number;
  @OneToOne(() => StockItemStatus, (status) => status.stockItem, { eager: true })
  status: Ref<StockItemStatus>;
}
// --- StockItemStatus Virtual View Entity ---
@Entity({ expression: 'SELECT * FROM stock_item_status' })
export class StockItemStatus {
  @PrimaryKey()
  id: number;
  @OneToOne(() => StockItem, { joinColumn: 'stock_item_id', inverseJoinColumn: 'id' })
  stockItem: Ref<StockItem>;
}
// --- Service Layer: Custom Creation Method with Transaction Handling ---
import { Injectable } from '@nestjs/common';
import { EntityManager } from '@mikro-orm/core';
import { StockItem } from './stock-item.entity';
import { StockItemStatus } from './stock-item-status.entity';
@Injectable()
export class StockService {
  constructor(private readonly em: EntityManager) {}
  async createStockItem(data: Partial<StockItem>): Promise<StockItem> {
    return this.em.transactional(async (em) => {
      const stockItem = em.create(StockItem, data);
      await em.persistAndFlush(stockItem);
      const status = em.create(StockItemStatus, { stockItem });
      await em.persistAndFlush(status);
      return stockItem;
    });
  }
}
// --- Unit Test for StockService ---
import { Test, TestingModule } from '@nestjs/testing';
import { StockService } from './stock.service';
import { EntityManager } from '@mikro-orm/core';
describe('StockService', () => {
  let service: StockService;
  let mockEm: Partial<EntityManager>;
  beforeEach(async () => {
    mockEm = { transactional: jest.fn((fn) => fn({} as any)) };
    const module: TestingModule = await Test.createTestingModule({
      providers: [StockService, { provide: EntityManager, useValue: mockEm }],
    }).compile();
    service = module.get<StockService>(StockService);
  });
  it('should create a StockItem and its status', async () => {
    const result = await service.createStockItem({ id: 1 });
    expect(result).toBeDefined();
  });
});

使用 MikroORM Hook 自动处理关系的替代解决方案

后端解决方案利用 MikroORM 生命周期挂钩来优化虚拟实体关系的处理

// --- StockItem Entity with BeforeCreate Hook ---
import { Entity, PrimaryKey, OneToOne, Ref, BeforeCreate } from '@mikro-orm/core';
@Entity()
export class StockItem {
  @PrimaryKey()
  id: number;
  @OneToOne(() => StockItemStatus, (status) => status.stockItem, { eager: true })
  status: Ref<StockItemStatus>;
  @BeforeCreate()
  createStatus() {
    this.status = new StockItemStatus(this);
  }
}
// --- StockItemStatus Entity ---
import { Entity, PrimaryKey, OneToOne, Ref } from '@mikro-orm/core';
@Entity()
export class StockItemStatus {
  constructor(stockItem: StockItem) {
    this.stockItem = stockItem;
  }
  @PrimaryKey()
  id: number;
  @OneToOne(() => StockItem)
  stockItem: Ref<StockItem>;
}
// --- Stock Service (Same as Above) ---
import { Injectable } from '@nestjs/common';
import { EntityManager } from '@mikro-orm/core';
import { StockItem } from './stock-item.entity';
@Injectable()
export class StockService {
  constructor(private readonly em: EntityManager) {}
  async createStockItem(data: Partial<StockItem>) {
    const stockItem = this.em.create(StockItem, data);
    await this.em.persistAndFlush(stockItem);
    return stockItem;
  }
}

有关 MikroORM 和虚拟实体的常见问题

1. 如何在 MikroORM 中定义虚拟实体？
2. 您可以使用装饰器 @Entity({ expression: 'SELECT * FROM view_name' }) 将数据库视图映射为只读实体。
3. MikroORM 中的错误“无法读取未定义的属性（读取“匹配”）”是什么？
4. 当创建具有未完全初始化的关系的实体时，会发生此错误。确保在持久化实体之前建立关系。
5. 如何从虚拟实体中有效地获取数据？
6. 使用 custom repository methods 编写优化的 SQL 查询或动态过滤器来限制从视图中获取的数据。
7. 目的是什么 eager: true @OneToOne 中的选项？
8. 这 eager 选项确保在查询主实体时自动加载相关实体，从而减少额外查询的需要。
9. 我可以使用生命周期挂钩来初始化关系吗？
10. 是的，MikroORM 允许像这样的钩子 @BeforeCreate() 在将实体保存到数据库之前自动设置关系。

关于实体关系和虚拟视图的最终想法🚀

有效地将实体与数据库视图相关联 微ORM 需要仔细配置。生命周期钩子如 @创建之前 或事务方法确保在持久数据之前正确建立关系。

在现实应用程序中，例如库存系统或财务摘要，虚拟视图有助于简化数据聚合。通过遵循最佳实践，您可以避免错误并优化后端性能，以获得更流畅的开发体验。 ⚙️