6. DIの考え方

DI(依存性の注入)とは、クラスが必要とする別のクラスを自分で new するのではなく、外部から渡してもらう設計です。NestJS の中心にはこの仕組みを自動化する「DIコンテナ」があり、クラスの生成と受け渡しをフレームワークが肩代わりします。

実務での利点は差し替えやすさです。たとえばテスト時に本物の DB アクセスクラスを偽物に置き換えたい場合、new が各所に散らばっていると大変ですが、生成をコンテナに集約していれば登録を1か所変えるだけで済みます。

下のコードはデコレータを使わずに DIコンテナの本質を再現したものです。「トークン名で生成方法を登録し、resolve で取り出す。一度作ったインスタンスは使い回す」という動きが、NestJS が裏でやっていることの核心です。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

TypeScript

// 簡易DIコンテナ: NestJS が裏でやっていることの本質
class Logger {
  log(message: string): void {
    console.log("[LOG] " + message);
  }
}

class UserService {
  constructor(private logger: Logger) {} // 依存は外から受け取る
  createUser(userName: string): void {
    this.logger.log("ユーザー作成: " + userName);
  }
}

class Container {
  private factories = new Map<string, (c: Container) => unknown>();
  private instances = new Map<string, unknown>();

  register<T>(token: string, factory: (c: Container) => T): void {
    this.factories.set(token, factory);
  }

  resolve<T>(token: string): T {
    if (!this.instances.has(token)) {
      const factory = this.factories.get(token);
      if (!factory) throw new Error("未登録のトークン: " + token);
      this.instances.set(token, factory(this)); // 初回だけ生成
    }
    return this.instances.get(token) as T;
  }
}

const container = new Container();
container.register("Logger", () => new Logger());
container.register(
  "UserService",
  (c) => new UserService(c.resolve<Logger>("Logger"))
);

const service = container.resolve<UserService>("UserService");
service.createUser("Alice");

// 同じトークンからは同じインスタンスが返る(シングルトン)
const again = container.resolve<UserService>("UserService");
console.log("同一インスタンス?: " + (service === again));

// 簡易DIコンテナ: NestJS が裏でやっていることの本質
class Logger {
  log(message: string): void {
    console.log("[LOG] " + message);
  }
}

class UserService {
  constructor(private logger: Logger) {} // 依存は外から受け取る
  createUser(userName: string): void {
    this.logger.log("ユーザー作成: " + userName);
  }
}

class Container {
  private factories = new Map<string, (c: Container) => unknown>();
  private instances = new Map<string, unknown>();

resolve<T>(token: string): T {
    if (!this.instances.has(token)) {
      const factory = this.factories.get(token);
      if (!factory) throw new Error("未登録のトークン: " + token);
      this.instances.set(token, factory(this)); // 初回だけ生成
    }
    return this.instances.get(token) as T;
  }
}

const container = new Container();
container.register("Logger", () => new Logger());
container.register(
  "UserService",
  (c) => new UserService(c.resolve<Logger>("Logger"))
);

const service = container.resolve<UserService>("UserService");
service.createUser("Alice");

// 同じトークンからは同じインスタンスが返る(シングルトン)
const again = container.resolve<UserService>("UserService");
console.log("同一インスタンス?: " + (service === again));

公式ドキュメントで詳しく ↗