カスタム `@Cacheable` デコレータを使用して Nest.js のパフォーマンスを強化する-jsチュートリアル-php.cn

カスタム `@Cacheable` デコレータを使用して Nest.js のパフォーマンスを強化する

Susan Sarandon

リリース： 2024-09-28 06:21:02

オリジナル

301 人が閲覧しました

Enhance Your Nest.js Performance with a Custom `@Cacheable` Decorator

キャッシュは、アプリケーションのパフォーマンスとスケーラビリティを向上させるための基本的な技術です。 Nest.js では、組み込みのキャッシュマネージャーを使用してキャッシュをシームレスに統合できます。この記事では、カスタム @Cacheable デコレータを作成して、Nest.js サービスまたはコントローラでのキャッシュを簡素化する方法を説明します。

?カスタム @Cacheable デコレーターを使用する理由

Nest.js はすぐに使用できる強力なキャッシュメカニズムを提供しますが、メソッド内にキャッシュロジックを直接適用するとコードが煩雑になる可能性があります。カスタムデコレータはこのロジックを抽象化し、コードをよりクリーンで保守しやすくします。

? @Cacheable デコレータの作成

メソッドの結果をキャッシュするために使用する @Cacheable デコレーターを作成することから始めましょう。

import { Cache } from 'cache-manager';

export function Cacheable(cacheKey: string) {
  return function (
    target: any,
    propertyName: string,
    descriptor: PropertyDescriptor,
  ) {
    const originalMethod = descriptor.value;

    descriptor.value = async function (...args: any[]) {
      const cache: Cache = this.cacheManager;

      if (!cache) {
        throw new Error(
          'Cannot use Cacheable() decorator without injecting the cache manager.',
        );
      }

      // Try to get cached data
      try {
        const cachedResult = await cache.get(cacheKey);
        if (cachedResult) {
          return cachedResult;
        }
      } catch (error) {
        console.error(`Cache get error for key: ${cacheKey}:`, error);
      }

      // Call the original method if cache miss
      const result = await originalMethod.apply(this, args);

      // Set the new result in cache
      try {
        await cache.set(cacheKey, result);
      } catch (error) {
        console.error(`Cache set error for key: ${cacheKey}:`, error);
      }

      return result;
    };

    return descriptor;
  };
}

ログイン後にコピー

?説明

キャッシュ取得: 元のメソッドを実行する前に、デコレーターは結果が既にキャッシュされているかどうかを確認します。
キャッシュミス処理: 結果がキャッシュにない場合は、元のメソッドを実行してから結果をキャッシュします。
エラー処理: キャッシュの取得または設定中にエラーをキャッチしてログに記録し、キャッシュの問題が原因でアプリケーションがクラッシュしないようにします。

? @Cacheable デコレータの使用

サービス内のメソッドに @Cacheable デコレーターを適用する方法は次のとおりです。

import { Injectable } from '@nestjs/common';
import { Cacheable } from './cacheable.decorator';

const SETTING_CACHE_KEY = 'settings';

@Injectable()
export class SettingsService {
  // Inject the cache manager
  constructor(private readonly cacheManager: Cache) {}

  /**
   * Retrieves settings from the cache if available, or loads them from the
   * repository and caches the result.
   *
   * @returns A promise that resolves to a `Settings` object.
   */
  @Cacheable(SETTING_CACHE_KEY)
  async getSettings(): Promise<Settings> {
    return await this.findAll();
  }

  // ... other methods like findAll() and buildTree()
}

ログイン後にコピー

?説明

デコレーターアプリケーション: @Cacheable デコレーターは、特定のキャッシュキーを使用して getSettings() メソッドに適用されます。
依存関係の挿入: キャッシュマネージャーは、デコレーターによって使用されるサービスに挿入されます。

? Nest.js へのキャッシュマネージャーの統合

アプリケーションでキャッシュマネージャーを使用するには、モジュールにキャッシュマネージャーを登録する必要があります。

import { Module } from '@nestjs/common';
import { CacheModule } from '@nestjs/cache-manager';
import { SettingsService } from './settings.service';

@Module({
  imports: [
    CacheModule.register({
      isGlobal: true,
      ttl: 300, // Time to live in seconds
      max: 100, // Maximum number of items in cache
    }),
  ],
  providers: [SettingsService],
})
export class AppModule {}

ログイン後にコピー

?説明

グローバルキャッシュ: isGlobal: true を設定すると、アプリケーション全体でキャッシュマネージャーを利用できるようになります。
TTL と最大アイテム数: キャッシュ内の有効期間 (ttl) とアイテムの最大数 (max) を構成します。

?キャッシュマネージャーの挿入

@Cacheable デコレーターを使用するサービスまたはコントローラーにキャッシュマネージャーを挿入していることを確認してください。

import { Injectable } from '@nestjs/common';
import { Cache } from 'cache-manager';

@Injectable()
export class SettingsService {
  constructor(private readonly cacheManager: Cache) {}

  // ... your methods
}

ログイン後にコピー