フィールドの詳細

• CONFIG_LOCATION_DELIMITERS

  static final StringSE CONFIG_LOCATION_DELIMITERS

  これらの文字は、1 つの文字列値に含まれる複数のコンテキスト設定パス間の区切り文字とみなされます。

  関連事項:

  AbstractRefreshableConfigApplicationContext.setConfigLocation(java.lang.String), ContextLoader.CONFIG_LOCATION_PARAM, FrameworkServlet.setContextConfigLocation(java.lang.String), 定数フィールド値

• CONVERSION_SERVICE_BEAN_NAME

  static final StringSE CONVERSION_SERVICE_BEAN_NAME

  ファクトリ内の ConversionService Bean の名前。何も指定しない場合、デフォルトの変換ルールが適用されます。

  導入:

  3.0

  関連事項:

  ConversionService, 定数フィールド値

• LOAD_TIME_WEAVER_BEAN_NAME

  static final StringSE LOAD_TIME_WEAVER_BEAN_NAME

  ファクトリ内の LoadTimeWeaver Bean の名前。その Bean が提供される場合、コンテキストは、LoadTimeWeaver がすべての実際の Bean クラスを処理できるようにするために、型のマッチングに一時的な ClassLoader を使用します。

  導入:

  2.5

  関連事項:

  LoadTimeWeaver, 定数フィールド値

• ENVIRONMENT_BEAN_NAME

  static final StringSE ENVIRONMENT_BEAN_NAME

  ファクトリ内の Environment Bean の名前。

  導入:

  3.1

  関連事項:

  定数フィールド値

• SYSTEM_PROPERTIES_BEAN_NAME

  static final StringSE SYSTEM_PROPERTIES_BEAN_NAME

  ファクトリのシステムプロパティ Bean の名前。

  関連事項:

  System.getProperties()SE, 定数フィールド値

• SYSTEM_ENVIRONMENT_BEAN_NAME

  static final StringSE SYSTEM_ENVIRONMENT_BEAN_NAME

  ファクトリのシステム環境 Bean の名前。

  関連事項:

  System.getenv()SE, 定数フィールド値

• APPLICATION_STARTUP_BEAN_NAME

  static final StringSE APPLICATION_STARTUP_BEAN_NAME

  ファクトリ内の ApplicationStartup Bean の名前。

  導入:

  5.3

  関連事項:

  定数フィールド値

• SHUTDOWN_HOOK_THREAD_NAME

  static final StringSE SHUTDOWN_HOOK_THREAD_NAME

  シャットダウンフックスレッドの NameSE: "SpringContextShutdownHook"。

  導入:

  5.2

  関連事項:

  registerShutdownHook(), 定数フィールド値

メソッドの詳細

• setId

  void setId(StringSE id)

  このアプリケーションコンテキストの一意の ID を設定します。

  導入:

  3.0

• setParent

  void setParent(@Nullable
                 ApplicationContext parent)

  このアプリケーションコンテキストの親を設定します。

  親は変更しないでください。たとえば、WebApplicationContext セットアップの場合など、このクラスのオブジェクトを作成するときに使用できない場合にのみ、コンストラクターの外部で設定する必要があります。

  パラメーター:

  parent - 親コンテキスト

  関連事項:

  ConfigurableWebApplicationContext

• setEnvironment

  void setEnvironment(ConfigurableEnvironment environment)

  このアプリケーションコンテキストの Environment を設定します。

  パラメーター:

  environment - 新しい環境

  導入:

  3.1

• getEnvironment

  ConfigurableEnvironment getEnvironment()

  このアプリケーションコンテキストの Environment を構成可能な形式で返し、さらにカスタマイズできるようにします。

  次で指定:

  インターフェース EnvironmentCapable の getEnvironment 

  導入:

  3.1

• setApplicationStartup

  void setApplicationStartup(ApplicationStartup applicationStartup)

  このアプリケーションコンテキストに ApplicationStartup を設定します。

  これにより、アプリケーションコンテキストは起動時にメトリクスを記録できます。

  パラメーター:

  applicationStartup - 新しいコンテキストイベントファクトリ

  導入:

  5.3

• getApplicationStartup

  ApplicationStartup getApplicationStartup()

  このアプリケーションコンテキストの ApplicationStartup を返します。

  導入:

  5.3

• addBeanFactoryPostProcessor

  void addBeanFactoryPostProcessor(BeanFactoryPostProcessor postProcessor)

  Bean 定義のいずれかが評価される前に、リフレッシュ時にこのアプリケーションコンテキストの内部 Bean ファクトリに適用される新しい BeanFactoryPostProcessor を追加します。コンテキスト設定中に呼び出されます。

  パラメーター:

  postProcessor - 登録するファクトリプロセッサー

• addApplicationListener

  void addApplicationListener(ApplicationListener<?> listener)

  コンテキストのリフレッシュやシャットダウンなどのコンテキストイベントで通知される新しい ApplicationListener を追加します。

  ここに登録されている ApplicationListener は、コンテキストがまだアクティブでない場合はリフレッシュ時に適用されます。コンテキストがすでにアクティブな場合は、現在のイベントマルチキャスターでオンザフライで適用されます。

  パラメーター:

  listener - 登録する ApplicationListener

  関連事項:

  ContextRefreshedEvent, ContextClosedEvent

• setClassLoader

  void setClassLoader(ClassLoaderSE classLoader)

  クラスパスリソースと Bean クラスをロードする ClassLoader を指定します。

  このコンテキストクラスローダーは、内部 Bean ファクトリに渡されます。

  導入:

  5.2.7

  関連事項:

  DefaultResourceLoader(ClassLoader), ConfigurableBeanFactory.setBeanClassLoader(java.lang.ClassLoader)

• addProtocolResolver

  void addProtocolResolver(ProtocolResolver resolver)

  特定のプロトコルリゾルバーをこのアプリケーションコンテキストに登録して、追加のリソースプロトコルを処理できるようにします。

  そのようなリゾルバーは、このコンテキストの標準の解決ルールより先に呼び出されます。デフォルトのルールも上書きする可能性があります。

  導入:

  4.3

• refresh

  void refresh()
        throws BeansException,
               IllegalStateExceptionSE

  Java ベースの構成、XML ファイル、プロパティファイル、リレーショナルデータベーススキーマ、その他の形式の構成の永続的な表現をロードまたはリフレッシュします。

  これはスタートアップメソッドであるため、リソースがぶら下がらないように、失敗した場合はすでに作成されているシングルトンを破棄する必要があります。つまり、このメソッドを呼び出した後は、シングルトンをインスタンス化するか、まったくインスタンス化しないかのどちらかです。

  例外:

  BeansException - Bean ファクトリを初期化できなかった場合

  IllegalStateExceptionSE - すでに初期化されていて、複数回のリフレッシュ試行がサポートされていない場合

• registerShutdownHook

  void registerShutdownHook()

  シャットダウンフックを JVM ランタイムに登録し、その時点ですでに閉じられていない限り、JVM シャットダウン時にこのコンテキストを閉じます。

  このメソッドは複数回呼び出すことができます。各コンテキストインスタンスに登録されるシャットダウンフックは（最大で）1 つだけです。

  Spring Framework 5.2 では、シャットダウンフックスレッドの名前は SHUTDOWN_HOOK_THREAD_NAMESE である必要があります。

  関連事項:

  Runtime.addShutdownHook(java.lang.Thread)SE, close()

• close

  void close()

  このアプリケーションコンテキストを閉じ、実装が保持している可能性があるすべてのリソースとロックを解放します。これには、キャッシュされたすべてのシングルトン Bean の破棄が含まれます。

  メモ: 親コンテキストで close を呼び出しません。親コンテキストには、独自の独立したライフサイクルがあります。

  このメソッドは、副作用なしに複数回呼び出すことができます。すでに閉じられているコンテキストに対する後続の close 呼び出しは無視されます。

  次で指定:

  インターフェース AutoCloseableSE の closeSE 

  次で指定:

  インターフェース CloseableSE の closeSE 

• isActive

  boolean isActive()

  このアプリケーションコンテキストがアクティブかどうか、つまり、少なくとも 1 回はリフレッシュされ、まだ閉じられていないかどうかを判断します。

  戻り値:

  コンテキストがまだアクティブかどうか

  関連事項:

  refresh(), close(), getBeanFactory()

• getBeanFactory

  ConfigurableListableBeanFactory getBeanFactory()
                                          throws IllegalStateExceptionSE

  このアプリケーションコンテキストの内部 Bean ファクトリを返します。基になるファクトリの特定の機能にアクセスするために使用できます。

  メモ: これを Bean ファクトリの後処理に使用しないでください。シングルトンはすでにインスタンス化されています。Bean に触れる前に、BeanFactoryPostProcessor を使用して BeanFactory セットアッププロセスをインターセプトします。

  通常、この内部ファクトリには、コンテキストがアクティブな間、つまり refresh() と close() の間のみでアクセスできます。isActive() フラグを使用して、コンテキストが適切な状態にあるかどうかを確認できます。

  戻り値:

  基礎となる Bean ファクトリ

  例外:

  IllegalStateExceptionSE - コンテキストが内部 Bean ファクトリを保持していない場合 (通常、refresh() がまだ呼び出されていない場合、close() がすでに呼び出されている場合)

  関連事項:

  isActive(), refresh(), close(), addBeanFactoryPostProcessor(org.springframework.beans.factory.config.BeanFactoryPostProcessor)