Spring依存性インジェクションの内部動作：実装原理とソースコード分析

本稿では、Springフレームワークにおける依存性インジェクション（DI）の内部動作に焦点を当てます。従来のように大量のソースコードを提示するのではなく、主要なクラスと中核的なロジックに絞り、原理の解説を重視します。実際のソースコードを追いながら学習することをお勧めします。

SpringのDIはBeanインスタンス生成後のプロパティ設定段階で実行されます。Springでは通常、Beanはシングルトンとして管理されるため、各クラスのプロパティは適切に初期化される必要があります。この過程でプロキシやリフレクションなどの技術が活用されます。

DI実装の基本アプローチ

Springでは依存性の注入を主に2つの方法で実装します：

  1. 手動インジェクション
  2. 自動インジェクション

それぞれのアプローチについて詳しく見ていきましょう。

手動インジェクションの実装

XML設定を用いた手動インジェクションには、主に2つの手法があります。

プロパティベースの設定：

<bean id="customerService" class="com.example.service.CustomerServiceImpl">
    <property name="repository" ref="userRepository"/>
</bean>

このアプローチでは、セッターメソッドを介して依存性が注入されます。

コンストラクタベースの設定：

<bean id="customerService" class="com.example.service.CustomerServiceImpl">
    <constructor-arg index="0" ref="userRepository"/>
</bean>

こちらではコンストラクタを通じて依存性が設定されます。

自動インジェクションの実装

XMLベースの自動設定

XML設定では、autowire属性を指定して自動インジェクションを有効化できます：

<bean id="customerService" class="com.example.service.CustomerServiceImpl" autowire="byType"/>
<bean id="customerService" class="com.example.service.CustomerServiceImpl" autowire="byName"/>

主なモード：

  • byType：型による一致
  • byName：名前による一致
  • constructor：コンストラクタ引数による一致
アノテーションベースの自動設定

@Autowiredアノテーションを使用した実装例：

フィールドインジェクション：

@Service
public class OrderManagementService {
    @Autowired
    private InventoryService stockService;
}

セッターインジェクション：

@Service
public class OrderManagementService {
    private InventoryService stockService;
    
    @Autowired
    public void configureInventoryService(InventoryService service) {
        this.stockService = service;
    }
}

コンストラクタインジェクション：

@Service
public class OrderManagementService {
    private final InventoryService stockService;
    
    @Autowired
    public OrderManagementService(InventoryService service) {
        this.stockService = service;
    }
}

DI実行の内部プロセス

インジェクションポイントの特定

SpringではAutowiredAnnotationBeanPostProcessorがBeanの作成プロセスでインジェクションポイントを特定します。主要な処理フロー：

  1. ターゲットクラスのフィールドをスキャンし、@Autowired/@Value/@Injectが付与されたフィールドを特定
  2. static修飾子が付与されたフィールドは除外
  3. 各フィールドのrequired属性を評価し、AutowiredFieldElementとしてキャッシュ
  4. メソッドに対しても同様のスキャンを実施
  5. staticメソッドは除外対象
  6. 引数なしのメソッドは警告を生成
  7. 親クラスが存在する場合は再帰的にスキャン
  8. 特定されたインジェクションポイントをInjectionMetadataとしてまとめてキャッシュ

staticメンバーへのインジェクション制限

Springがstaticフィールド/メソッドへのインジェクションをサポートしない理由は、staticメンバーがクラスレベルで管理され、インスタンスに属さないためです。プロトタイプスコープのBeanを考慮すると：

@Component
@Scope("prototype")
public class PaymentProcessor {
    @Autowired
    private static NotificationService notifier;
    
    public void executePayment() {
        notifier.sendConfirmation();
    }
}

もしstaticフィールドへのインジェクションを許可すると、プロトタイプBeanの生成意図に反し、意図しない動作を引き起こす可能性があります。

実際のインジェクション処理

プロパティの充填はpopulateBeanメソッド内で実行され、AutowiredAnnotationBeanPostProcessor.postProcessProperties()が呼び出されます。

フィールドインジェクションの処理：

  1. AutowiredFieldElementのコレクションを走査
  2. 各フィールドをDependencyDescriptorに変換
  3. beanFactory.resolveDependency()で注入対象のBeanを解決
  4. 解決結果をキャッシュ（プロトタイプ対応）
  5. リフレクションを使用してフィールドに値を設定

メソッドインジェクションの処理：

  1. AutowiredMethodElementのコレクションを走査
  2. resolveMethodArguments()で引数を解決
  3. 各パラメータをDependencyDescriptorに変換
  4. beanFactory.resolveDependency()でBeanを解決
  5. 解決結果をキャッシュ
  6. リフレクションでメソッドを実行

インジェクションポイントの探索ロジック（findAutowiringMetadata）：

private InjectionMetadata locateInjectionPoints(String beanId, Class<?> beanClass, @Nullable PropertyValues values) {
    String cacheIdentifier = (StringUtils.hasText(beanId) ? beanId : beanClass.getName());
    InjectionMetadata cachedInfo = this.injectionMetadataCache.get(cacheIdentifier);
    
    if (InjectionMetadata.requiresRefresh(cachedInfo, beanClass)) {
        synchronized (this.injectionMetadataCache) {
            cachedInfo = this.injectionMetadataCache.get(cacheIdentifier);
            if (InjectionMetadata.requiresRefresh(cachedInfo, beanClass)) {
                if (cachedInfo != null) {
                    cachedInfo.clear(values);
                }
                // インジェクションポイントを解析してキャッシュ
                cachedInfo = constructInjectionMetadata(beanClass);
                this.injectionMetadataCache.put(cacheIdentifier, cachedInfo);
            }
        }
    }
    return cachedInfo;
}

@Resourceアノテーションの動作

@Resourceアノテーションによるインジェクションは、CommonAnnotationBeanPostProcessorによって処理されます。基本的な動作は@Autowiredと似ていますが、インジェクションポイントの特定にはpostProcessMergedBeanDefinition()、プロパティ設定にはpostProcessProperties()が使用されます。

@Qualifierアノテーションによる曖昧性解決

インターフェースに複数の実装が存在する場合、@Qualifierを使用して具体的な実装を指定できます：

public interface DataSource {
}

@Repository
@Qualifier("primaryDb")
public class PrimaryDataSource implements DataSource {
}

@Repository
@Qualifier("backupDb")
public class BackupDataSource implements DataSource {
}

@Service
public class DataAccessLayer {
    @Autowired
    @Qualifier("backupDb")
    private DataSource connectionPool;
}

この場合、SpringはbackupDbという修飾子を持つBeanを選択します。修飾子の照合はbeanFactory.resolveDependency()の実行時に行われ、QualifierAnnotationAutowireCandidateResolver.isAutowireCandidate()メソッドで詳細な処理が実装されています。

Springの依存性インジェクションを理解する上で重要なのは、インジェクションポイントの特定と実際の注入という2つのフェーズが存在することです。また、staticメンバーへのインジェクションが制限されている理由も理解しておく必要があります。ソースコードを追う際は、全体のフローを意識しながら各コンポーネントの役割を把握することが重要です。

タグ: Spring 依存性インジェクション DI Autowired BeanPostProcessor

5月13日 12:50 投稿

ホットタグ

©2026 異端開発室