コンストラクターの詳細

• DefaultSingletonBeanRegistry

  public DefaultSingletonBeanRegistry()

メソッドの詳細

• registerSingleton

  public void registerSingleton(StringSE beanName,
                                ObjectSE singletonObject)
                         throws IllegalStateExceptionSE

  インターフェースからコピーされた説明: SingletonBeanRegistry
  指定された既存のオブジェクトを、指定された Bean 名で、Bean レジストリにシングルトンとして登録します。

  与えられたインスタンスは完全に初期化されることになっています。レジストリは初期化コールバックを実行しません（特に、InitializingBean の afterPropertiesSet メソッドを呼び出しません）。指定されたインスタンスは、（DisposableBean の destroy メソッドのような）破棄コールバックも受け取りません。

  完全な BeanFactory 内で実行する場合: Bean が初期化および / または破棄コールバックを受け取ることになっている場合、既存のインスタンスの代わりに Bean 定義を登録します。

  通常、レジストリ設定中に呼び出されますが、シングルトンのランタイム登録にも使用できます。結果として、レジストリ実装はシングルトンアクセスを同期する必要があります。BeanFactory のシングルトンの遅延初期化をサポートする場合、これを行う必要があります。

  次で指定:

  インターフェース SingletonBeanRegistry の registerSingleton 

  パラメーター:

  beanName - Bean の名前

  singletonObject - 既存のシングルトンオブジェクト

  例外:

  IllegalStateExceptionSE

  関連事項:

  InitializingBean.afterPropertiesSet(), DisposableBean.destroy(), BeanDefinitionRegistry.registerBeanDefinition(java.lang.String, org.springframework.beans.factory.config.BeanDefinition)

• addSingleton

  protected void addSingleton(StringSE beanName,
                              ObjectSE singletonObject)

  指定されたシングルトンオブジェクトをこのファクトリのシングルトンキャッシュに追加します。

  シングルトンの積極的な登録のために呼び出されます。

  パラメーター:

  beanName - Bean の名前

  singletonObject - シングルトンオブジェクト

• addSingletonFactory

  protected void addSingletonFactory(StringSE beanName,
                                     ObjectFactory<?> singletonFactory)

  必要に応じて、指定されたシングルトンを構築するために、指定されたシングルトンファクトリを追加します。

  シングルトンの先行した登録を求められる循環参照を解決できるようにします。

  パラメーター:

  beanName - Bean の名前

  singletonFactory - シングルトンオブジェクトのファクトリ

• getSingleton

  @Nullable
  public ObjectSE getSingleton(StringSE beanName)

  インターフェースからコピーされた説明: SingletonBeanRegistry
  指定された名前で登録された（生の）シングルトンオブジェクトを返します。

  すでにインスタンス化されているシングルトンのみをチェックします。まだインスタンス化されていないシングルトン Bean 定義のオブジェクトを返しません。

  このメソッドの主な目的は、手動で登録されたシングルトンにアクセスすることです（SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object) を参照）。また、すでに作成されている Bean 定義によって定義されたシングルトンにそのままのメソッドでアクセスするためにも使用できます。

  注意 : この検索方法は、FactoryBean のプレフィックスまたはエイリアスを認識しません。シングルトンインスタンスを取得する前に、最初に正規の Bean 名を解決する必要があります。

  次で指定:

  インターフェース SingletonBeanRegistry の getSingleton 

  パラメーター:

  beanName - 検索する Bean の名前

  戻り値:

  登録されたシングルトンオブジェクト。見つからない場合は null 

  関連事項:

  ConfigurableListableBeanFactory.getBeanDefinition(java.lang.String)

• getSingleton

  @Nullable
  protected ObjectSE getSingleton(StringSE beanName,
                                          boolean allowEarlyReference)

  指定された名前で登録された（生の）シングルトンオブジェクトを返します。

  すでにインスタンス化されているシングルトンをチェックし、現在作成されているシングルトンへの早期参照も可能にします（循環参照の解決）。

  パラメーター:

  beanName - 検索する Bean の名前

  allowEarlyReference - 早期参照を作成する必要があるかどうか

  戻り値:

  登録されたシングルトンオブジェクト。見つからない場合は null 

• getSingleton

  public ObjectSE getSingleton(StringSE beanName,
                             ObjectFactory<?> singletonFactory)

  指定された名前で登録された（生の）シングルトンオブジェクトを返し、まだ登録されていない場合は新しいオブジェクトを作成して登録します。

  パラメーター:

  beanName - Bean の名前

  singletonFactory - 必要に応じてシングルトンを遅延作成する ObjectFactory

  戻り値:

  登録されたシングルトンオブジェクト

• onSuppressedException

  protected void onSuppressedException(ExceptionSE ex)

  シングルトン Bean インスタンスの作成中に発生した例外を登録します。一時的な循環参照解決の問題。

  デフォルトの実装では、このレジストリの抑制された例外のコレクションにある特定の例外が 100 例外まで保持され、関連する原因として最終的なトップレベルの BeanCreationException に追加されます。

  パラメーター:

  ex - 登録する例外

  関連事項:

  BeanCreationException.getRelatedCauses()

• removeSingleton

  protected void removeSingleton(StringSE beanName)

  このファクトリのシングルトンキャッシュから指定された名前の Bean を削除し、作成が失敗した場合にシングルトンの積極的な登録をクリーンアップできるようにします。

  パラメーター:

  beanName - Bean の名前

  関連事項:

  getSingletonMutex()

• containsSingleton

  public boolean containsSingleton(StringSE beanName)

  インターフェースからコピーされた説明: SingletonBeanRegistry
  このレジストリに、指定された名前のシングルトンインスタンスが含まれているかどうかを確認します。

  すでにインスタンス化されているシングルトンのみをチェックします。まだインスタンス化されていないシングルトン Bean 定義の true を返しません。

  このメソッドの主な目的は、手動で登録されたシングルトンをチェックすることです（SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object) を参照）。Bean 定義で定義されたシングルトンがすでに作成されているかどうかを確認するためにも使用できます。

  Bean ファクトリに特定の名前の Bean 定義が含まれているかどうかを確認するには、ListableBeanFactory の containsBeanDefinition を使用します。containsBeanDefinition と containsSingleton の両方を呼び出すと、特定の Bean ファクトリに、指定された名前のローカル Bean インスタンスが含まれているかどうかがわかります。

  BeanFactory の containsBean を使用して、ファクトリが特定の名前の Bean を知っているかどうか（手動でシングルトンインスタンスを登録したか、Bean 定義によって作成されたか）を確認し、祖先ファクトリもチェックします。

  注意 : この検索方法は、FactoryBean のプレフィックスまたはエイリアスを認識しません。シングルトンステータスを確認する前に、最初に正規の Bean 名を解決する必要があります。

  次で指定:

  インターフェース SingletonBeanRegistry の containsSingleton 

  パラメーター:

  beanName - 検索する Bean の名前

  戻り値:

  この Bean ファクトリに、指定された名前のシングルトンインスタンスが含まれている場合

  関連事項:

  SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object), ListableBeanFactory.containsBeanDefinition(java.lang.String), BeanFactory.containsBean(java.lang.String)

• getSingletonNames

  public StringSE[] getSingletonNames()

  インターフェースからコピーされた説明: SingletonBeanRegistry
  このレジストリに登録されているシングルトン Bean の名前を返します。

  すでにインスタンス化されているシングルトンのみをチェックします。まだインスタンス化されていないシングルトン Bean 定義の名前は返しません。

  このメソッドの主な目的は、手動で登録されたシングルトンをチェックすることです（SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object) を参照）。Bean 定義で定義されているシングルトンがすでに作成されているかどうかを確認するためにも使用できます。

  次で指定:

  インターフェース SingletonBeanRegistry の getSingletonNames 

  戻り値:

  文字列配列としての名前のリスト (非 null)

  関連事項:

  SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object), BeanDefinitionRegistry.getBeanDefinitionNames(), ListableBeanFactory.getBeanDefinitionNames()

• getSingletonCount

  public int getSingletonCount()

  インターフェースからコピーされた説明: SingletonBeanRegistry
  このレジストリに登録されているシングルトン Bean の数を返します。

  すでにインスタンス化されているシングルトンのみをチェックします。まだインスタンス化されていないシングルトン Bean 定義はカウントしません。

  このメソッドの主な目的は、手動で登録されたシングルトンをチェックすることです（SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object) を参照）。すでに作成されている Bean 定義によって定義されたシングルトンの数をカウントするためにも使用できます。

  次で指定:

  インターフェース SingletonBeanRegistry の getSingletonCount 

  戻り値:

  シングルトン Bean の数

  関連事項:

  SingletonBeanRegistry.registerSingleton(java.lang.String, java.lang.Object), BeanDefinitionRegistry.getBeanDefinitionCount(), ListableBeanFactory.getBeanDefinitionCount()

• setCurrentlyInCreation

  public void setCurrentlyInCreation(StringSE beanName,
                                     boolean inCreation)

• isCurrentlyInCreation

  public boolean isCurrentlyInCreation(StringSE beanName)

• isActuallyInCreation

  protected boolean isActuallyInCreation(StringSE beanName)

• isSingletonCurrentlyInCreation

  public boolean isSingletonCurrentlyInCreation(StringSE beanName)

  指定されたシングルトン Bean が現在（ファクトリ全体内で）作成中かどうかを返します。

  パラメーター:

  beanName - Bean の名前

• beforeSingletonCreation

  protected void beforeSingletonCreation(StringSE beanName)

  シングルトン作成前のコールバック。

  デフォルトの実装では、現在作成中のシングルトンを登録します。

  パラメーター:

  beanName - 作成されるシングルトンの名前

  関連事項:

  isSingletonCurrentlyInCreation(java.lang.String)

• afterSingletonCreation

  protected void afterSingletonCreation(StringSE beanName)

  シングルトン作成後のコールバック。

  デフォルトの実装では、シングルトンはもう作成されていません。

  パラメーター:

  beanName - 作成されたシングルトンの名前

  関連事項:

  isSingletonCurrentlyInCreation(java.lang.String)

• registerDisposableBean

  public void registerDisposableBean(StringSE beanName,
                                     DisposableBean bean)

  指定された Bean をこのレジストリの使い捨て Bean のリストに追加します。

  使い捨て Bean は通常、登録済みのシングルトンに対応し、Bean 名と一致しますが、異なるインスタンスになる可能性があります（たとえば、Spring の DisposableBean インターフェースを自然に実装しないシングルトン用の DisposableBean アダプター）。

  パラメーター:

  beanName - Bean の名前

  bean - Bean インスタンス

• registerContainedBean

  public void registerContainedBean(StringSE containedBeanName,
                                    StringSE containingBeanName)

  2 つの Bean 間の包含関連を登録します。内部 Bean とそれを含む外部 Bean の間。

  また、含まれている Bean を、破棄の順序に関して、含まれている Bean に依存するものとして登録します。

  パラメーター:

  containedBeanName - 含まれている（内部）Bean の名前

  containingBeanName - 包含（外部）Bean の名前

  関連事項:

  registerDependentBean(java.lang.String, java.lang.String)

• registerDependentBean

  public void registerDependentBean(StringSE beanName,
                                    StringSE dependentBeanName)

  所定の Bean が破棄される前に破棄される、所定の Bean の依存 Bean を登録します。

  パラメーター:

  beanName - Bean の名前

  dependentBeanName - 依存 Bean の名前

• isDependent

  protected boolean isDependent(StringSE beanName,
                                StringSE dependentBeanName)

  指定された依存 Bean が、指定された Bean またはその推移的な依存関係のいずれかに依存するものとして登録されているかどうかを判別します。

  パラメーター:

  beanName - チェックする Bean の名前

  dependentBeanName - 依存 Bean の名前

  導入:

  4.0

• hasDependentBean

  protected boolean hasDependentBean(StringSE beanName)

  指定された名前に依存する Bean が登録されているかどうかを判別します。

  パラメーター:

  beanName - チェックする Bean の名前

• getDependentBeans

  public StringSE[] getDependentBeans(StringSE beanName)

  指定された Bean に依存するすべての Bean の名前を返します（存在する場合）。

  パラメーター:

  beanName - Bean の名前

  戻り値:

  依存する Bean 名の配列、ない場合は空の配列

• getDependenciesForBean

  public StringSE[] getDependenciesForBean(StringSE beanName)

  指定された Bean が依存するすべての Bean の名前を返します（存在する場合）。

  パラメーター:

  beanName - Bean の名前

  戻り値:

  Bean が依存する Bean の名前の配列、ない場合は空の配列

• destroySingletons

  public void destroySingletons()

• clearSingletonCache

  protected void clearSingletonCache()

  このレジストリ内のすべてのキャッシュされたシングルトンインスタンスをクリアします。

  導入:

  4.3.15

• destroySingleton

  public void destroySingleton(StringSE beanName)

  与えられた Bean を破棄します。対応する使い捨て Bean インスタンスが見つかった場合は、destroyBean に委譲します。

  パラメーター:

  beanName - Bean の名前

  関連事項:

  destroyBean(java.lang.String, org.springframework.beans.factory.DisposableBean)

• destroyBean

  protected void destroyBean(StringSE beanName,
                             @Nullable
                             DisposableBean bean)

  与えられた Bean を破棄します。Bean 自体の前に、指定された Bean に依存する Bean を破棄する必要があります。例外をスローするべきではありません。

  パラメーター:

  beanName - Bean の名前

  bean - 破棄する Bean インスタンス

• getSingletonMutex

  public final ObjectSE getSingletonMutex()

  シングルトンミューテックスをサブクラスおよび外部の協力者に公開します。

  サブクラスは、何らかの拡張されたシングルトン作成フェーズを実行する場合、指定されたオブジェクトで同期する必要があります。特に、lazy-init の状況でデッドロックが発生する可能性を回避するために、サブクラスはシングルトンの作成に関与する独自のミューテックスを持っていてはなりません。

  次で指定:

  インターフェース SingletonBeanRegistry の getSingletonMutex 

  戻り値:

  ミューテックスオブジェクト (非 null)