Lifetimes and scopes

ライフタイムは、解決されたインスタンスがどれだけ長く生きるかを定義します。適切なライフタイムを選ぶことで、状態の所有関係が明確になり、リクエスト固有の依存関係がユーザーやリクエストをまたいで漏れることを防げます。

Singleton

singleton はステートレスなサービスや、プロセス全体で共有する依存関係に使います。

container.register(LoggerToken, {
  useClass: ConsoleLogger,
  lifetime: "singleton",
});

よい候補:

リクエスト固有の状態を singleton に持たせることは避けてください。

scoped は 1 リクエストまたは 1 単位の処理の中で再利用すべき依存関係に使います。

container.register(UserRepositoryToken, {
  useClass: UserRepository,
  lifetime: "scoped",
});

よい候補:

transient は、resolve のたびに新しい instance を作るべきときに使います。

container.register(ReportBuilder);

Transient は、状態を共有する必要がない、短期間だけ使うオブジェクトに向いています。

Web フレームワークでは、リクエストが始まるとリクエストスコープが作られ、リクエストが終わると破棄されます。

const scope = container.createScope();

try {
  await handleRequest(scope);
} finally {
  await scope.dispose();
}

対応しているフレームワークでは、アダプターがこれを自動で行います。

Wyrly はライフタイムの関係を検証できます。たとえば singleton は scoped な依存関係に依存すべきではありません。プロセス全体で共有されるインスタンスにリクエスト固有の状態が保持されてしまうためです。テストや CI の一部として検証を実行してください。

const result = container.validate();