パッケージ org.springframework.boot.autoconfigure.condition

アノテーションインターフェース ConditionalOnSingleCandidate

@TargetSE({TYPESE,METHODSE}) @RetentionSE(RUNTIMESE) @DocumentedSE @Conditional(org.springframework.boot.autoconfigure.condition.OnBeanCondition.class) public @interface ConditionalOnSingleCandidate
指定されたクラスの Bean がすでに BeanFactory に含まれ、単一の候補を決定できる場合にのみ一致する @Conditional。

複数の一致する Bean インスタンスがすでに BeanFactory に含まれているが、主要候補が定義されている場合も、条件は一致します。基本的に、定義された型の Bean のオートワイヤーが成功した場合、条件は一致します。

この条件は、これまでにアプリケーションコンテキストによって処理された Bean 定義にのみ一致するため、自動構成クラスでのみこの条件を使用することを強くお勧めします。候補 Bean が別の自動構成によって作成される可能性がある場合、この条件を使用するものが実行されることを確認してください。

導入:
1.3.0
作成者:
Stephane Nicoll

  • オプション要素のサマリー

    オプション要素
    修飾子と型
    オプションの要素
    説明
    SearchStrategy
    search
    アプリケーションコンテキスト階層（親コンテキスト）を考慮するかどうかを決定する戦略。
    StringSE
    type
    チェックする Bean のクラス型名。
    ClassSE<?>
    value
    チェックする必要がある Bean のクラス型。

  • 要素の詳細

    • value

      ClassSE<?> value
      チェックする Bean のクラス型。指定されたクラスの Bean が BeanFactory に含まれており、複数のインスタンスがある場合はプライマリ候補が存在する場合に条件が一致します。オートワイヤ候補ではない Bean、デフォルト候補ではない Bean、またはフォールバック候補である Bean は無視されます。

      この属性は、type() と組み合わせて使用することはできませんが、type() の代わりに使用することができます。

      戻り値:
      チェックする Bean のクラス型
      関連事項:
      デフォルト:
      java.lang.Object.class

    • type

      StringSE type
      チェックする Bean のクラス型名。指定されたクラスの Bean が BeanFactory に含まれており、複数のインスタンスがある場合はプライマリ候補が存在する場合に条件が一致します。オートワイヤ候補ではない Bean、デフォルト候補ではない Bean、またはフォールバック候補である Bean は無視されます。

      この属性は、value() と組み合わせて使用することはできませんが、value() の代わりに使用することができます。

      戻り値:
      チェックする Bean のクラス型名
      関連事項:
      デフォルト:
      ""

    • search

      SearchStrategy search
      アプリケーションコンテキスト階層（親コンテキスト）を考慮するかどうかを決定する戦略。
      戻り値:
      検索戦略
      デフォルト:
      ALL