インターフェース BeanFactory

メソッドの詳細

• getBean

  ObjectSE getBean(StringSE name) throws BeansException

  指定された Bean のインスタンス（共有または独立）を返します。

  この方法では、Spring BeanFactory をシングルトンまたはプロトタイプの設計パターンの代わりとして使用できます。シングルトン Bean の場合、呼び出し元は返されたオブジェクトへの参照を保持できます。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 取得する Bean の名前

  戻り値:

  Bean のインスタンス。戻り値が null になることはありませんが、ファクトリメソッドから返された null のスタブになる可能性があり、equals(null) を介してチェックされることに注意してください。オプションの依存関係を解決するには、getBeanProvider(Class) の使用を検討してください。

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  BeansException - Bean を取得できなかった場合

• getBean

  <T> T getBean(StringSE name, ClassSE<T> requiredType) throws BeansException

  指定された Bean のインスタンス（共有または独立）を返します。

  getBean(String) と同じように動作しますが、Bean が必要な型でない場合は BeanNotOfRequiredTypeException をスローすることにより、型安全の基準を提供します。これは、getBean(String) で発生する可能性があるように、結果を正しくキャストすると ClassCastException がスローされないことを意味します。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 取得する Bean の名前

  requiredType - Bean が一致する必要があることを入力します。インターフェースまたはスーパークラスにすることができます

  戻り値:

  Bean のインスタンス。戻り値が null になることはないことに注意してください。リクエストされた Bean に対して解決されたファクトリメソッドからの null のスタブの場合、NullBean スタブに対する BeanNotOfRequiredTypeException が発生します。オプションの依存関係を解決するには、getBeanProvider(Class) の使用を検討してください。

  例外:

  NoSuchBeanDefinitionException - そのような Bean 定義がない場合

  BeanNotOfRequiredTypeException - Bean が必要な型でない場合

  BeansException - Bean を作成できなかった場合

• getBean

  ObjectSE getBean(StringSE name, ObjectSE... args) throws BeansException

  指定された Bean のインスタンス（共有または独立）を返します。

  Bean 定義で指定されたデフォルト引数 (存在する場合) をオーバーライドして、明示的なコンストラクター引数 / ファクトリメソッド引数を指定できるようにします。指定された引数は、宣言されたパラメーターの順序で特定の候補コンストラクター / ファクトリメソッドと一致する必要があることに注意してください。

  パラメーター:

  name - 取得する Bean の名前

  args - 明示的な引数を使用して Bean インスタンスを作成するときに使用する引数 (既存のインスタンスを取得するのではなく、新しいインスタンスを作成するときにのみ適用されます)

  戻り値:

  Bean のインスタンス

  例外:

  NoSuchBeanDefinitionException - そのような Bean 定義がない場合

  BeanDefinitionStoreException - 引数は指定されているが、影響を受ける Bean がプロトタイプではない場合

  BeansException - Bean を作成できなかった場合

  導入:

  2.5

• getBean

  <T> T getBean(ClassSE<T> requiredType) throws BeansException

  指定されたオブジェクト型が存在する場合、一意に一致する Bean インスタンスを返します。

  このメソッドは、ListableBeanFactory の型別ルックアップ領域に入りますが、指定された型の名前に基づいた従来の名前別ルックアップにも変換できます。Bean のセット全体でより広範な検索操作を行うには、ListableBeanFactory または BeanFactoryUtils（あるいはその両方）を使用します。

  パラメーター:

  requiredType - Bean が一致する必要があることを入力します。インターフェースまたはスーパークラスにすることができます

  戻り値:

  必要な型に一致する単一の Bean のインスタンス

  例外:

  NoSuchBeanDefinitionException - 指定された型の Bean が見つからなかった場合

  NoUniqueBeanDefinitionException - 指定された型の複数の Bean が見つかった場合

  BeansException - Bean を作成できなかった場合

  導入:

  3.0

  関連事項:

  • ListableBeanFactory

• getBean

  <T> T getBean(ClassSE<T> requiredType, ObjectSE... args) throws BeansException

  指定された Bean のインスタンス（共有または独立）を返します。

  Bean 定義で指定されたデフォルト引数 (存在する場合) をオーバーライドして、明示的なコンストラクター引数 / ファクトリメソッド引数を指定できるようにします。指定された引数は、宣言されたパラメーターの順序で特定の候補コンストラクター / ファクトリメソッドと一致する必要があることに注意してください。

  このメソッドは、ListableBeanFactory の型別ルックアップ領域に入りますが、指定された型の名前に基づいた従来の名前別ルックアップにも変換できます。Bean のセット全体でより広範な検索操作を行うには、ListableBeanFactory または BeanFactoryUtils（あるいはその両方）を使用します。

  パラメーター:

  requiredType - Bean が一致する必要があることを入力します。インターフェースまたはスーパークラスにすることができます

  args - 明示的な引数を使用して Bean インスタンスを作成するときに使用する引数 (既存のインスタンスを取得するのではなく、新しいインスタンスを作成するときにのみ適用されます)

  戻り値:

  Bean のインスタンス

  例外:

  NoSuchBeanDefinitionException - そのような Bean 定義がない場合

  BeanDefinitionStoreException - 引数は指定されているが、影響を受ける Bean がプロトタイプではない場合

  BeansException - Bean を作成できなかった場合

  導入:

  4.1

• getBeanProvider

  <T> ObjectProvider<T> getBeanProvider(ClassSE<T> requiredType)

  指定された Bean のプロバイダーを返します。これにより、可用性および一意性オプションを含め、インスタンスの遅延オンデマンド取得が可能になります。

  ジェネリクス型を照合するには、getBeanProvider(ResolvableType) を検討してください。

  パラメーター:

  requiredType - Bean が一致する必要があることを入力します。インターフェースまたはスーパークラスにすることができます

  戻り値:

  対応するプロバイダーのハンドル

  導入:

  5.1

  関連事項:

  • getBeanProvider(ResolvableType)

• getBeanProvider

  <T> ObjectProvider<T> getBeanProvider(ResolvableType requiredType)

  指定された Bean のプロバイダーを返します。これにより、可用性と一意性のオプションを含む、インスタンスの遅延オンデマンド取得が可能になります。このバリアントでは、メソッド / コンストラクターパラメーターでジェネリクス型宣言を使用するリフレクションインジェクションポイントと同様に、一致するジェネリクス型を指定できます。

  リフレクティブインジェクションポイントとは対照的に、ここでは Bean のコレクションはサポートされていないことに注意してください。特定の型に一致する Bean のリストをプログラムで取得するには、ここで引数として実際の Bean 型を指定し、その後 ObjectProvider.orderedStream() またはその遅延ストリーミング / 反復オプションを使用します。

  また、ジェネリクスのマッチングは、Java の割り当てルールに従って、ここでは厳密です。チェックされていないセマンティクスによる緩やかなフォールバックマッチング ('unchecked' Java コンパイラーの警告と同様) の場合、このバリアントで完全なジェネリクスマッチが available にない場合は、2 番目のステップとして生の型で getBeanProvider(Class) を呼び出すことを検討してください。

  パラメーター:

  requiredType - Bean が一致する必要があると入力します。ジェネリクス型宣言にすることができます

  戻り値:

  対応するプロバイダーのハンドル

  導入:

  5.1

  関連事項:

  • ObjectProvider.iterator()
  • ObjectProvider.stream()
  • ObjectProvider.orderedStream()

• containsBean

  boolean containsBean(StringSE name)

  この Bean ファクトリには、指定された名前の Bean 定義または外部登録されたシングルトンインスタンスが含まれているか判定します。

  指定された名前がエイリアスの場合、対応する正規の Bean 名に変換されます。

  このファクトリが階層的である場合、このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに問い合わせます。

  指定された名前に一致する Bean 定義またはシングルトンインスタンスが見つかった場合、このメソッドは、名前付き Bean 定義がスコープ内で具体的または抽象的、遅延または先行であるかどうかにかかわらず、true を返します。このメソッドからの true 戻り値は、必ずしも getBean(java.lang.String) が同じ名前のインスタンスを取得できることを示しているわけではないことに注意してください。

  パラメーター:

  name - 照会する Bean の名前

  戻り値:

  指定された名前の Bean が存在するかどうか

• isSingleton

  boolean isSingleton(StringSE name) throws NoSuchBeanDefinitionException

  この Bean は共有シングルトンですか？ つまり、getBean(java.lang.String) は常に同じインスタンスを返しますか？

  メモ: false を返すこのメソッドは、独立したインスタンスを明確に示していません。これは、スコープが設定された Bean にも対応している可能性がある非シングルトンインスタンスを示します。isPrototype(java.lang.String) 操作を使用して、独立したインスタンスを明示的にチェックします。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 照会する Bean の名前

  戻り値:

  この Bean がシングルトンインスタンスに対応するかどうか

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  関連事項:

  • getBean(java.lang.String)
  • isPrototype(java.lang.String)

• isPrototype

  boolean isPrototype(StringSE name) throws NoSuchBeanDefinitionException

  この Bean はプロトタイプですか？ つまり、getBean(java.lang.String) は常に独立したインスタンスを返しますか？

  メモ: false を返すこのメソッドは、シングルトンオブジェクトを明確に示していません。これは独立したインスタンスを示し、スコープ付き Bean にも対応する場合があります。isSingleton(java.lang.String) 操作を使用して、共有シングルトンインスタンスを明示的に確認します。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 照会する Bean の名前

  戻り値:

  この Bean が常に独立したインスタンスを配信するかどうか

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  導入:

  2.0.3

  関連事項:

  • getBean(java.lang.String)
  • isSingleton(java.lang.String)

• isTypeMatch

  boolean isTypeMatch(StringSE name, ResolvableType typeToMatch) throws NoSuchBeanDefinitionException

  指定された名前の Bean が指定された型と一致するかどうかを確認します。より具体的には、指定された名前の getBean(java.lang.String) 呼び出しが、指定されたターゲット型に割り当て可能なオブジェクトを返すかどうかを確認します。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 照会する Bean の名前

  typeToMatch - 照合する型 (ResolvableType として)

  戻り値:

  Bean 型が一致する場合は true、一致しないかまだ判別できない場合は false 

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  導入:

  4.2

  関連事項:

  • getBean(java.lang.String)
  • getType(java.lang.String)

• isTypeMatch

  boolean isTypeMatch(StringSE name, ClassSE<?> typeToMatch) throws NoSuchBeanDefinitionException

  指定された名前の Bean が指定された型と一致するかどうかを確認します。より具体的には、指定された名前の getBean(java.lang.String) 呼び出しが、指定されたターゲット型に割り当て可能なオブジェクトを返すかどうかを確認します。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 照会する Bean の名前

  typeToMatch - 照合する型 (Class として)

  戻り値:

  Bean 型が一致する場合は true、一致しないかまだ判別できない場合は false 

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  導入:

  2.0.1

  関連事項:

  • getBean(java.lang.String)
  • getType(java.lang.String)

• getType

  @Nullable ClassSE<?> getType(StringSE name) throws NoSuchBeanDefinitionException

  指定された名前の Bean の型を判別します。具体的には、指定された名前に対して getBean(java.lang.String) が返すオブジェクトの型を決定します。

  FactoryBean の場合は、FactoryBean.getObjectType() によって公開されている、FactoryBean が作成するオブジェクトの型を返します。これにより、以前に初期化されていない FactoryBean （getType(String, boolean) を参照）が初期化される可能性があります。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 照会する Bean の名前

  戻り値:

  Bean の型、または判別できない場合は null 

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  導入:

  1.1.2

  関連事項:

  • getBean(java.lang.String)
  • isTypeMatch(java.lang.String, org.springframework.core.ResolvableType)

• getType

  @Nullable ClassSE<?> getType(StringSE name, boolean allowFactoryBeanInit) throws NoSuchBeanDefinitionException

  指定された名前の Bean の型を判別します。具体的には、指定された名前に対して getBean(java.lang.String) が返すオブジェクトの型を決定します。

  FactoryBean の場合は、FactoryBean.getObjectType() によって公開されている、FactoryBean が作成するオブジェクトの型を返します。allowFactoryBeanInit フラグによっては、初期の型情報が利用できない場合、以前に初期化されていない FactoryBean が初期化される可能性があります。

  エイリアスを対応する正規の Bean 名に変換します。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - 照会する Bean の名前

  allowFactoryBeanInit - FactoryBean がオブジェクト型を判別する目的でのみ初期化されるかどうか

  戻り値:

  Bean の型、または判別できない場合は null 

  例外:

  NoSuchBeanDefinitionException - 指定された名前の Bean がない場合

  導入:

  5.2

  関連事項:

  • getBean(java.lang.String)
  • isTypeMatch(java.lang.String, org.springframework.core.ResolvableType)

• getAliases

  StringSE[] getAliases(StringSE name)

  存在する場合、指定された Bean 名のエイリアスを返します。

  これらのエイリアスはすべて、getBean(java.lang.String) 呼び出しで使用される場合、同じ Bean を指します。

  指定された名前がエイリアスの場合、対応する元の Bean 名と他のエイリアス（存在する場合）が返され、元の Bean 名が配列の最初の要素になります。

  このファクトリインスタンスで Bean が見つからないかどうかを親ファクトリに確認します。

  パラメーター:

  name - エイリアスをチェックする Bean 名

  戻り値:

  エイリアス、または存在しない場合は空の配列

  関連事項:

  • getBean(java.lang.String)