アプリケーションの複數(shù)の部分で共有する必要があるオブジェクト (データベース接続、WebSocket クライアント、構(gòu)成マネージャーなど) を扱っていることに気付いたことがありますか?

アプリケーションやプロセスのライフサイクル全體を通じて一貫性を保ち、アクセスできるようにするには、このようなオブジェクトをどのように管理すればよいでしょうか?ここで シングルトン デザイン パターン が登場(chǎng)します。

概要

シングルトン は 創(chuàng)造的なデザイン パターン であり、新しいオブジェクトを使用してオブジェクトを作成するネイティブな方法に伴うさまざまな問(wèn)題に対処するデザイン パターンのカテゴリです。 キーワードまたは演算子。

シングルトン設(shè)計(jì)パターンは、次の 2 つの主要な問(wèn)題を解決することに重點(diǎn)を置いています。

1. インスタンスに グローバル アクセス ポイントを提供するにはどうすればよいですか?
2. クラス または特定のタイプのオブジェクトのインスタンスが 1 つだけであることを確認(rèn)するにはどうすればよいですか?

これにより、データベース接続、WebSocket クライアント、キャッシュ サービス、またはアプリケーションのライフサイクル全體を通じてメモリ內(nèi)で永続化および変更する必要があるものなど、特定の種類(lèi)またはタイプのグローバル狀態(tài)を管理する方法が簡(jiǎn)素化および標(biāo)準(zhǔn)化されます。

シングルトン設(shè)計(jì)パターンを?qū)g裝するにはどうすればよいでしょうか?

上記のスキーマは次の TypeScript クラスに変換されます。

TypeScript の例

class Singleton {
  private static instance: Singleton
  // other properties...
  public authorName: string

  private constructor({ authorName }: { authorName: string }) {
    this.authorName = authorName
  }

  public static getInstance(params) {
    if (!this.instance) {
      this.instance = new Singleton(params)
    }
    return this.instance
  }
  // other methods...
}

• クラスは、一意に共有可能なインスタンスを保存するための靜的プロパティを定義する必要があります。

キーワード static は、インスタンス オブジェクトがクラスのインスタンスではなく、クラス定義自體に関連付けられていることを意味します。

• クラスのコンストラクターはプライベートとしてマークされる必要があります。クラスのインスタンスを取得する唯一の方法は、靜的メソッド getInstance を呼び出すことです。

const instance = Singleton.getInstance({ authorName: "Sidali Assoul" })


// let's imagine
const instance1 = Singleton.getInstance({ authorName: "Sidali Assoul" }) // "Sidali Assoul"
const instance2 = Singleton.getInstance({ authorName: "John Doe" }) // "Sidali Assoul"

Singleton クラスに関連付けられた靜的メソッド getInstance を呼び出すことで、上記のクラスを利用できます。

getInstance メソッドは、コードベースの異なる場(chǎng)所でクラスを複數(shù)回インスタンス化した場(chǎng)合でも、常に同じインスタンスを取得することを保証します。

したがって、両方の変數(shù) (instance1 と instance2) は同じシングルトン インスタンスを共有します。

最初の実踐的なシナリオ

Prisma は、JavaScript エコシステムでよく知られた ORM です。アプリケーションで Prisma を使用するには、PrismaClient をインポートし、そこからオブジェクトをインスタンス化する必要があります。

class Singleton {
  private static instance: Singleton
  // other properties...
  public authorName: string

  private constructor({ authorName }: { authorName: string }) {
    this.authorName = authorName
  }

  public static getInstance(params) {
    if (!this.instance) {
      this.instance = new Singleton(params)
    }
    return this.instance
  }
  // other methods...
}

Prisma クライアントは、遅延的な方法で、つまり、最初にエンティティのクエリまたは変更を試みたときにのみ、データベースに接続します。

const instance = Singleton.getInstance({ authorName: "Sidali Assoul" })


// let's imagine
const instance1 = Singleton.getInstance({ authorName: "Sidali Assoul" }) // "Sidali Assoul"
const instance2 = Singleton.getInstance({ authorName: "John Doe" }) // "Sidali Assoul"

prismaClient がファイルにインポートされるたびに、PrismaClient から新しいインスタンスが作成されます。したがって、これらのインスタンスを使用するたびに、多くのデータベース接続が確立されます。

import { PrismaClient } from "@prisma/client"

export const prismaClient = new PrismaClient()

データベースは通常、限られた數(shù)の接続しか処理できないため、多數(shù)のオープンデータベース接続はアプリケーションのパフォーマンスを低下させ、データベースのシャットダウンにつながる可能性もあります。

シングルトン デザイン パターン は、PrismaClient クラスのインスタンスが複數(shù)存在することを回避し、PrismaClientSingleton.getInstance() 靜的メソッド経由でインスタンスにアクセスするための単一ポイントを提供することで、このような問(wèn)題を防ぐのに役立ちます。

import { prismaClient } from "@/db"

const users = await prismaClient.user.findMany() // query on the users table

2 番目の実踐的なシナリオ

これから説明するもう 1 つの実際的なシナリオは、メモリ內(nèi)レート リミッター サービスです。

ユーザーやハッカーは、特定のエンドポイントに大量のリクエストを送信することで、そのエンドポイントにスパムを送信する可能性があります。これにより、脆弱性、予期せぬコスト、またはサーバー障害が発生する可能性があります。

これを防ぐために、基本的なインメモリ レート リミッター サービスを?qū)g裝できます。

サービスは、特定のタイミング ウィンドウ間隔 (たとえば、60 秒) の間、IP アドレスごとのリクエストの數(shù)を制限する必要があります。

export const prismaClient = new PrismaClient() // a new instance is created every time it gets imported then used.

RateLimiterService クラスは、指定されたタイミング ウィンドウ內(nèi)で IP アドレス (マップ キー) によって識(shí)別される特定のユーザーによって行われたリクエスト (requests[ip].count) の數(shù)を追跡するマップを保存します。 (リクエスト[ip].lastRequestTime).

私たちの RateLimiterService はグローバルに使用することを目的としています。つまり、RateLimiterService がインポートされるたびに、リクエスト マップ、リミット、ウィンドウ変數(shù)で構(gòu)成される內(nèi)部狀態(tài)値をリセットする必要はありません。

結(jié)論

シングルトン設(shè)計(jì)パターンは、アプリケーション內(nèi)の共有リソースを効果的に管理するための強(qiáng)力なツールです

重要なポイント:

1. シングルトンは、クラスのインスタンスが 1 つだけであることを保証し、そのインスタンスへのグローバル アクセス ポイントを提供します。
2. データベース接続、構(gòu)成設(shè)定、キャッシュなどの共有リソースの管理に役立ちます。
3. 実際のアプリケーションには、Prisma などの ORM とのデータベース接続の最適化や、レート制限サービスの実裝が含まれます。

接觸

ご質(zhì)問(wèn)がある場(chǎng)合、またはさらに話し合いたい場(chǎng)合は、お?dú)葺Xにここからご連絡(luò)ください。

コーディングを楽しんでください!

以上がシングルトン設(shè)計(jì)パターン: アプリケーションでのグローバル狀態(tài)の管理の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。