NestJS'de MikroORM'nin Sanal Varlıklarla İlişkilerini Yönetme

NestJS'de Varlıklar ve Sanal Görünümler Arasındaki MikroORM İlişkilerinin Çözümlenmesi

Modüler ve optimize edilmiş yöntemlere odaklanan, NestJS ve PostgreSQL ile MikroORM kullanan arka uç çözümü

// --- 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();
  });
});

İlişkileri Otomatik Olarak Yönetmek İçin MikroORM Hook'u Kullanan Alternatif Çözüm

Sanal varlık ilişkilerinin optimize edilmiş yönetimi için MikroORM yaşam döngüsü kancalarından yararlanan arka uç çözümü

// --- 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 ve Sanal Varlıklar Hakkında Sıkça Sorulan Sorular

1. MikroORM'de sanal varlığı nasıl tanımlarım?
2. Dekoratörü kullanabilirsiniz @Entity({ expression: 'SELECT * FROM view_name' }) bir veritabanı görünümünü salt okunur bir varlık olarak eşlemek için.
3. MikroORM'de “Tanımlanmamış özellikleri okunamıyor ('eşleşme' okunuyor)” hatası nedir?
4. Bu hata, tam olarak başlatılmamış bir ilişkiye sahip bir varlık oluştururken ortaya çıkar. Varlığı sürdürmeden önce ilişkinin kurulduğundan emin olun.
5. Verileri sanal bir varlıktan verimli bir şekilde nasıl alabilirim?
6. Kullanmak custom repository methods görünümden getirilen verileri sınırlamak amacıyla optimize edilmiş SQL sorguları veya dinamik filtreler yazmak için.
7. Amacı nedir? eager: true @OneToOne'da seçenek var mı?
8. eager seçeneği, ana varlık sorgulanırken ilgili varlığın otomatik olarak yüklenmesini sağlayarak ek sorgu ihtiyacını azaltır.
9. İlişkileri başlatmak için yaşam döngüsü kancalarını kullanabilir miyim?
10. Evet, MikroORM aşağıdaki gibi kancalara izin verir: @BeforeCreate() bir varlığı veritabanına kaydetmeden önce ilişkileri otomatik olarak ayarlamak için.

Varlık İlişkileri ve Sanal Görünümler Üzerine Son Düşünceler 🚀

Varlıkları veritabanı görünümleriyle verimli bir şekilde ilişkilendirme MikroORM dikkatli konfigürasyon gerektirir. Yaşam döngüsü kancaları gibi @BeforeCreate veya işlemsel yöntemler, verilerin kalıcı hale getirilmesinden önce ilişkilerin doğru şekilde kurulmasını sağlar.

Envanter sistemleri veya finansal özetler gibi gerçek dünya uygulamalarında sanal görünümler, veri toplamanın kolaylaştırılmasına yardımcı olur. En iyi uygulamaları takip ederek hataları önleyebilir ve daha sorunsuz geliştirme deneyimleri için arka uç performansınızı optimize edebilirsiniz. ⚙️