Modullarni lazy loading qilish

Standart holatda modullar eager tarzda yuklanadi, ya'ni ilova yuklanishi bilan birga barcha modullar ham yuklanadi, ular darhol kerak bo'lishi yoki bo'lmasligidan qat'i nazar. Bu ko'pchilik ilovalar uchun yaxshi, ammo serverless environment da ishlaydigan ilova/workerlar uchun bo'g'in nuqtaga aylanishi mumkin, chunki ishga tushish kechikishi ("cold start") juda muhim.

Lazy loading muayyan serverless funksiya chaqiruvi uchun kerak bo'lgan modullargina yuklanishi hisobiga bootstrap vaqtini qisqartirishga yordam beradi. Bundan tashqari, serverless funksiya "warm" bo'lgach, keyingi chaqiruvlar uchun bootstrap vaqtini yanada tezlashtirish maqsadida boshqa modullarni asinxron tarzda yuklashingiz mumkin (kechiktirilgan modullar ro'yxatdan o'tkazilishi).

Boshlash

Modullarni talab bo'yicha yuklash uchun Nest LazyModuleLoader sinfini taqdim etadi, uni odatdagi tarzda sinfga in'eksiya qilish mumkin:

1@Injectable()
2export class CatsService {
3  constructor(private lazyModuleLoader: LazyModuleLoader) {}
4}

Muqobil ravishda, LazyModuleLoader provayderiga havolani ilovangizning bootstrap faylidan (main.ts) quyidagicha olishingiz mumkin:

1// "app" represents a Nest application instance
2const lazyModuleLoader = app.get(LazyModuleLoader);

Shundan so'ng, quyidagi konstruktsiya yordamida istalgan modulni yuklashingiz mumkin:

1const { LazyModule } = await import('./lazy.module');
2const moduleRef = await this.lazyModuleLoader.load(() => LazyModule);

Bu yerda lazy.module.ts - oddiy Nest modulni eksport qiladigan TypeScript fayli (qo'shimcha o'zgarishlar talab etilmaydi).

LazyModuleLoader#load metodi module reference (LazyModule uchun) ni qaytaradi; u provayderlarning ichki ro'yxatini ko'rish va in'eksiya tokeni bo'yicha istalgan provayderga havola olish imkonini beradi.

Masalan, quyidagi ta'rifga ega LazyModule bor deylik:

1@Module({
2  providers: [LazyService],
3  exports: [LazyService],
4})
5export class LazyModule {}

Shu bilan, LazyService provayderiga havolani quyidagicha olishimiz mumkin:

1const { LazyModule } = await import('./lazy.module');
2const moduleRef = await this.lazyModuleLoader.load(() => LazyModule);
3
4const { LazyService } = await import('./lazy.service');
5const lazyService = moduleRef.get(LazyService);

Kontrollerlar, gatewaylar va resolverlarni lazy loading qilish

Nestda kontrollerlar (yoki GraphQL ilovalarida resolverlar) route/path/topiclar (yoki query/mutationlar) to'plamini ifodalaydi, shuning uchun ularni LazyModuleLoader sinfi yordamida lazy load qilib bo'lmaydi.

Masalan, Fastify drayveri ( @nestjs/platform-fastify paketi) ostida REST API (HTTP ilova) qurayapsiz deylik. Fastify ilova tayyor bo'lib, xabarlarni tinglashni boshlagandan keyin route'larni ro'yxatdan o'tkazishga ruxsat bermaydi. Bu shuni anglatadiki, modul kontrollerlarida ro'yxatdan o'tkazilgan route mapping'larini tahlil qilsak ham, barcha lazy loaded route'lar ochiq bo'lmaydi, chunki ularni runtime paytida ro'yxatdan o'tkazishning iloji yo'q.

Xuddi shuningdek, @nestjs/microservices paketi doirasida taqdim etiladigan ba'zi transport strategiyalari (jumladan Kafka, gRPC yoki RabbitMQ) ulanish o'rnatilishidan oldin muayyan topic/channel'larni subscribe/listen qilishni talab qiladi. Ilovangiz xabarlarni tinglashni boshlagach, freymvork yangi topic'larni subscribe/listen qila olmaydi.

Nihoyat, @nestjs/graphql paketi code-first yondashuvi yoqilgan bo'lsa, metadata asosida GraphQL sxemasini avtomatik generatsiya qiladi. Bu esa barcha sinflar oldindan yuklangan bo'lishini talab qiladi. Aks holda, mos va to'g'ri sxemani yaratib bo'lmaydi.

Keng tarqalgan use-case'lar

Ko'pincha lazy loaded modullarni worker/cron job/lambda & serverless function/webhook kiruvchi argumentlarga (route path/date/query parameters va hokazo) qarab turli servislarni (turli mantiqni) ishga tushirishi kerak bo'lgan holatlarda ko'rasiz. Boshqa tomondan, monolit ilovalar uchun modullarni lazy loading qilish unchalik mantiqli bo'lmasligi mumkin, chunki u yerda startup vaqti uncha ahamiyatli emas.