التعامل مع علاقات MikroORM بالكيانات الافتراضية في NestJS

حل علاقات MikroORM بين الكيانات وطرق العرض الافتراضية في NestJS

حل الواجهة الخلفية باستخدام 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 للتعامل مع العلاقات تلقائيًا

يعمل حل الواجهة الخلفية على الاستفادة من خطافات دورة حياة 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() لتعيين العلاقات تلقائيًا قبل حفظ الكيان في قاعدة البيانات.

الأفكار النهائية حول علاقات الكيان ووجهات النظر الافتراضية 🚀

ربط الكيانات بكفاءة بطرق عرض قاعدة البيانات في ميكروأورم يتطلب التكوين الدقيق. خطافات دورة الحياة مثل @قبل الإنشاء أو تضمن طرق المعاملات إنشاء العلاقات بشكل صحيح قبل استمرار البيانات.

في تطبيقات العالم الحقيقي، مثل أنظمة المخزون أو الملخصات المالية، تساعد طرق العرض الافتراضية في تبسيط عملية تجميع البيانات. ومن خلال اتباع أفضل الممارسات، يمكنك تجنب الأخطاء وتحسين أداء الواجهة الخلفية لديك للحصول على تجارب تطوير أكثر سلاسة. ⚙️