NestJS, birleşik bir API sağlayan yerleşik bir caching modülü (@nestjs/cache-manager) sunar ve bu modül farklı depolarla çalışır — varsayılan olarak bellek içi caching veya birden fazla örnek arasında dağıtılmış caching için Redis. Caching, tekrarlanan pahalı işlemleri önleyerek performansı önemli ölçüde iyileştirir.
({
: [
.({
: ,
: ,
: ,
}),
],
})
{}
@Controller("products")
@UseInterceptors(CacheInterceptor) // automatically caches GET responses
export class ProductsController {
@Get()
@CacheTTL(30000) // override TTL for this route
findAll() {
return this.productsService.findAll(); // result cached; subsequent GETs are instant
}
}
CacheInterceptor, GET endpoint yanıtlarını otomatik olarak önbelleğe alır (URL'ye göre anahtarlanmış) ve tekrarlanan isteklerde önbelleğe alınmış sonuçları sunar — okuma yoğun endpoint'ler için en basit caching yöntemidir.
@Injectable()
export class ProductsService {
constructor(@Inject(CACHE_MANAGER) private cache: Cache) {}
async getProduct(id: string) {
const cached = await this.cache.get(`product:${id}`); // check cache first
if (cached) return cached; // cache HIT
const product = await this.db.findProduct(id); // cache MISS — fetch
await this.cache.set(`product:${id}`, product, 3600000); // store (1h TTL)
return product;
}
}
CACHE_MANAGER'ı inject etmek tam kontrol sağlar — önbellek kontrolü, kaynağa geri dönüş, sonuç depolama şeması (get-or-fetch pattern) belirli pahalı işlemleri önbelleğe almak için kullanılır.
CacheModule.registerAsync({
useFactory: async () => ({
store: await redisStore({ url: process.env.REDIS_URL }), // use Redis as the store
ttl: 60000,
}),
});
Aynı API, Redis ile desteklendiğinde, tüm uygulama örnekleri arasında paylaşılan bir önbellek sunar — birden fazla örneği çalıştırırken gereklidir (bellek içi önbellek örnekler arasında paylaşılmaz).
async updateProduct(id: string, data) {
await this.db.update(id, data);
await this.cache.del(`product:${id}`); // INVALIDATE on change → avoid stale data
}
The biggest caching challenge: INVALIDATION. When data changes, the cache must be
cleared/updated, or users see stale data. Strategies: TTL (accept brief staleness),
explicit deletion on writes (cache.del), or cache tags.
Caching, arka uç uygulamaları için en yüksek etkili performans optimizasyonlarından biridir ve NestJS'nin yerleşik caching modülü bunu temiz ve tutarlı hale getirir.
Bunu anlamak önemlidir çünkü okuma yoğun API'ler, pahalı işlemleri (veritabanı sorguları, dış API çağrıları, hesaplamalar) önbelleğe almaktan büyük ölçüde faydalanır — gecikmeyi ve yükü önemli ölçüde azaltır.
NestJS hem basit otomatik caching (GET endpoint'leri için CacheInterceptor) hem de ince taneli manuel kontrol (belirli işlemler için CACHE_MANAGER get-or-fetch şeması) sunar.
Önemlisi, birleşik API farklı depolarla çalışır, bu nedenle aynı kod bellek içi caching (hızlı, tek örnek) veya Redis (birden fazla örnek arasında paylaşılan önbellek) kullanabilir — ve bellek içi bir önbelleğin yatay ölçeklendirme sırasında paylaşılmadığını (dağıtılmış caching için Redis gereklidir) anlamak önemli bir mimari noktasıdır.
Eşit derecede önemli olan, caching'in temel zorluğunu anlamaktır — invalidation (veriler değiştiğinde önbelleği temizleme veya güncelleme, TTL veya açık silme yoluyla, eski verileri sunmaktan kaçınmak için) — çünkü bunu yanlış yapmak klasik caching başarısızlığıdır.
Caching'i nasıl ve ne zaman uygulanacağını bilmek, dağıtım için doğru depoyu seçmek ve invalidation işlemini doğru şekilde ele almak, hızlı ve ölçeklenebilir NestJS hizmetleri oluşturmak için değerli ileri seviye bilgidir.