依存性の注入について

依存性の注入 (DI) はAngularの基本的な概念の1つです。DIはAngularフレームワークに組み込まれており、コンポーネント、ディレクティブ、パイプ、注入可能などのAngularデコレーターを持つクラスが、必要な依存関係を設定できるようにします。

DIシステムには、依存関係のコンシューマーと依存関係のプロバイダーという2つの主要な役割があります。

Angularは Injector という抽象化を使用して、依存関係のコンシューマーと依存関係のプロバイダー間の相互作用を促進します。依存関係が要求されると、インジェクターは、そのレジストリにすでにインスタンスが存在するかどうかを確認します。存在しない場合は、新しいインスタンスが作成され、レジストリに格納されます。Angularは、アプリケーションのブートストラップ処理中に、アプリケーション全体で使用されるインジェクター（「ルート」インジェクターとも呼ばれます）を作成します。ほとんどの場合、インジェクターを手動で作成する必要はありませんが、プロバイダーとコンシューマーを結び付けるレイヤーがあることを知っておく必要があります。

このトピックでは、クラスが依存関係としてどのように機能するかという基本的なシナリオについて説明します。Angularでは、関数やオブジェクト、文字列やブール値などのプリミティブ型あるいはその他の型も依存関係として使用できます。詳細については、依存関係のプロバイダー を参照してください。

依存関係を提供する

コンポーネントで依存関係として機能する必要がある HeroService というクラスを考えてみましょう。

最初のステップは、@Injectable デコレーターを追加して、クラスを注入できることを示すことです。

      
@Injectable()class HeroService {}
    

次のステップは、それをDIで提供できるようにすることです。 依存関係は、複数の場所で提供できます。

• 推奨: providedIn を使用してアプリケーションのルートレベルで提供する。
• コンポーネントレベルで提供する。
• ApplicationConfig を使用してアプリケーションのルートレベルで提供する。
• NgModule ベースのアプリケーション。

推奨: providedIn を使用してアプリケーションのルートレベルで提供する

providedIn を使用してアプリケーションのルートレベルでサービスを提供すると、そのサービスを他のすべてのクラスに注入できます。 providedIn を使用すると、AngularとJavaScriptコードのオプティマイザーは、使用されていないサービスを効果的に削除できます（ツリーシェーキングとして知られています）。

@Injectable デコレーターで providedIn: 'root' を使用して、サービスを提供できます。

      
@Injectable({  providedIn: 'root'})class HeroService {}
    

ルートレベルでサービスを提供すると、Angularは HeroService の単一の共有インスタンスを作成し、それを要求するすべてのクラスに注入します。

コンポーネントレベルで提供する

@Component デコレーターの providers フィールドを使用して、@Component レベルでサービスを提供できます。 この場合、HeroService は、このコンポーネントのすべてのインスタンス、およびテンプレートで使用される他のコンポーネントやディレクティブで使用できるようになります。

例：

      
@Component({  standalone: true,  selector: 'hero-list',  template: '...',  providers: [HeroService]})class HeroListComponent {}
    

コンポーネントレベルでプロバイダーを登録すると、そのコンポーネントの新しいインスタンスごとに、サービスの新しいインスタンスが取得されます。

ApplicationConfig を使用してアプリケーションのルートレベルで提供する

bootstrapApplication 関数に渡される ApplicationConfig の providers フィールドを使用して、アプリケーションレベルでサービスまたはその他の Injectable を提供できます。

以下の例では、HeroService は、すべてのコンポーネント、ディレクティブ、およびパイプで使用できます。

      
export const appConfig: ApplicationConfig = {    providers: [      { provide: HeroService },    ]};
    

次に、main.ts で：

      
bootstrapApplication(AppComponent, appConfig)
    

NgModule ベースのアプリケーション

@NgModule ベースのアプリケーションは、@NgModule デコレーターの providers フィールドを使用して、アプリケーションレベルで使用可能なサービスまたはその他の Injectable を提供します。

モジュールで提供されたサービスは、モジュールのすべての宣言または同じ ModuleInjector を共有する他のモジュールで使用できます。 すべてのエッジケースを理解するには、階層型インジェクター を参照してください。

依存関係を注入する/消費する

依存関係を注入する最も一般的な方法は、クラスのコンストラクターで宣言することです。Angularがコンポーネント、ディレクティブ、またはパイプクラスの新しいインスタンスを作成すると、コンストラクターのパラメーター型を見て、そのクラスに必要なサービスまたはその他の依存関係を判断します。たとえば、HeroListComponent が HeroService を必要とする場合、コンストラクターは次のようになります。

      
@Component({ … })class HeroListComponent {  constructor(private service: HeroService) {}}
    

別のオプションは、inject メソッドを使用することです。

      
@Component({ … })class HeroListComponent {  private service = inject(HeroService);}
    

Angularがコンポーネントがサービスに依存していることを発見すると、最初にインジェクターにそのサービスの既存のインスタンスがあるかどうかを確認します。要求されたサービスインスタンスがまだ存在しない場合、インジェクターは登録されたプロバイダーを使用してインスタンスを作成し、サービスをAngularに返す前に、インジェクターに追加します。

要求されたすべてのサービスが解決され返されると、Angularはこれらのサービスを引数として、コンポーネントのコンストラクターを呼び出せます。

次のステップ