DIプラグインの設定
必要な依存関係: io.ktor:ktor-server-di
コード例: server-di
アプリケーション設定ファイルで依存性注入(DI)プラグインを設定できます。これらの設定は依存関係解決の動作にグローバルに影響し、登録されているすべての依存関係に適用されます。
依存関係キーのマッピング
ktor.di.keyMapping プロパティは、依存関係の解決時にキーをどのように一般化し、マッチングするかを定義します。これにより、要求された型を解決する際に、どの登録済み依存関係が互換性があるとみなされるかが決定されます。
yaml
ktor:
di:
keyMapping: Supertypes * Nullables * OutTypeArgumentsSupertypes * RawTypes上記の例は、DIプラグインで使用されるデフォルトのキーマッピングに一致します。
利用可能なキーマッピングオプション
DefaultSupertypes * Nullables * OutTypeArgumentsSupertypes * RawTypesSupertypesNullablesOutTypeArgumentsSupertypesout 型引数での共変性を許可します。 RawTypesUnnamed@Named)を無視します。 キーマッピングオプションの組み合わせ
集合演算子 *(積集合)、+(和集合)、および ()(グループ化)を使用して、キーマッピングオプションを組み合わせることができます。
以下の例では、List<String> として登録された依存関係を、Collection<String>(Supertypes)、List または List?(RawTypes および Nullables)として解決できます。
yaml
ktor:
di:
keyMapping: Supertypes + (Nullables * RawTypes)その組み合わせが式に含まれていないため、Collection? としては解決されません。
競合解決ポリシー
ktor.di.conflictPolicy プロパティは、同じ依存関係キーに対して複数のプロバイダーが登録された場合のDIコンテナの動作を制御します。
yaml
ktor:
di:
conflictPolicy: Default利用可能なポリシー
DefaultOverridePreviousIgnoreConflictsIgnoreConflicts を使用します。これにより、テストコードでエラーを発生させることなく本番環境の依存関係を上書きできます。 