AnnotationConfigWebApplicationContext (Spring Framework 5.2.9.RELEASE API)

java.lang.ObjectSE
- org.springframework.core.io.DefaultResourceLoader
- - org.springframework.context.support.AbstractApplicationContext
  - - org.springframework.context.support.AbstractRefreshableApplicationContext
    - - org.springframework.context.support.AbstractRefreshableConfigApplicationContext
      - org.springframework.web.context.support.AbstractRefreshableWebApplicationContext
        
        org.springframework.web.context.support.AnnotationConfigWebApplicationContext

実装されているすべてのインターフェース:
CloseableSE, AutoCloseableSE, Aware, BeanFactory, BeanNameAware, HierarchicalBeanFactory, InitializingBean, ListableBeanFactory, AnnotationConfigRegistry, ApplicationContext, ApplicationEventPublisher, ConfigurableApplicationContext, Lifecycle, MessageSource, EnvironmentCapable, ResourceLoader, ResourcePatternResolver, ThemeSource, ConfigurableWebApplicationContext, WebApplicationContext
```
public class AnnotationConfigWebApplicationContext
extends AbstractRefreshableWebApplicationContext
implements AnnotationConfigRegistry
```
コンポーネントクラスを入力として受け入れる WebApplicationContext 実装 — 特に @Configuration アノテーション付きクラスだけでなく、プレーン @Component クラスおよび javax.inject アノテーションを使用する JSR-330 準拠クラスも受け入れます。
クラスを 1 つずつ登録して（クラス名を構成場所として指定）、クラスパススキャンを実行できます（基本パッケージを構成場所として指定）。
これは、本質的に Web 環境の AnnotationConfigApplicationContext と同等です。
このアプリケーションコンテキストを使用するには、ContextLoader の "contextClass" コンテキストパラメーターおよび / または FrameworkServlet の "contextClass" 初期化パラメーターを、このクラスの完全修飾名に設定する必要があります。
Spring 3.1 の時点で、web.xml の代わりに WebApplicationInitializer コードベースの代替を使用する場合、このクラスは直接インスタンス化され、Spring の DispatcherServlet または ContextLoaderListener に注入されることもあります。詳細と使用例については、Javadoc を参照してください。
XmlWebApplicationContext とは異なり、デフォルトの構成クラスの場所は想定されていません。むしろ、ContextLoader の場合は "contextConfigLocation" コンテキストパラメーター、FrameworkServlet の場合は "contextConfigLocation" init-param を設定する必要があります。param-value には、完全修飾クラス名と、コンポーネントをスキャンするための基本パッケージの両方を含めることができます。これらの場所がどのように処理されるかの詳細については、loadBeanDefinitions(org.springframework.beans.factory.support.DefaultListableBeanFactory) を参照してください。
"contextConfigLocation" パラメーターを設定する代わりに、ユーザーは ApplicationContextInitializer を実装し、"contextInitializerClasses" コンテキストパラメーター / 初期化パラメーターを設定できます。このような場合、ユーザーは、主に ContextLoader で使用される AbstractRefreshableConfigApplicationContext.setConfigLocation(String) メソッドよりも、AbstractApplicationContext.refresh() メソッドと scan(String...) メソッドを優先する必要があります。
メモ: 複数の @Configuration クラスの場合、後の @Bean 定義は、以前にロードされたファイルで定義されたものをオーバーライドします。これを利用して、追加の @Configuration クラスを介して特定の Bean 定義を意図的にオーバーライドできます。
導入:
3.0
作成者:
Chris Beams, Juergen Hoeller
関連事項:
AnnotationConfigApplicationContext

ネストされたクラスの要約
- クラス org.springframework.core.io.DefaultResourceLoader から継承されたネストクラス / インターフェース
  DefaultResourceLoader.ClassPathContextResource

フィールドのサマリー
- クラス org.springframework.context.support.AbstractApplicationContext から継承されたフィールド
  APPLICATION_EVENT_MULTICASTER_BEAN_NAME, LIFECYCLE_PROCESSOR_BEAN_NAME, logger, MESSAGE_SOURCE_BEAN_NAME
- インターフェース org.springframework.web.context.ConfigurableWebApplicationContext から継承されたフィールド
  APPLICATION_CONTEXT_ID_PREFIX, SERVLET_CONFIG_BEAN_NAME
- インターフェース org.springframework.web.context.WebApplicationContext から継承されたフィールド
  CONTEXT_ATTRIBUTES_BEAN_NAME, CONTEXT_PARAMETERS_BEAN_NAME, ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, SCOPE_APPLICATION, SCOPE_REQUEST, SCOPE_SESSION, SERVLET_CONTEXT_BEAN_NAME
- インターフェース org.springframework.context.ConfigurableApplicationContext から継承されたフィールド
  CONFIG_LOCATION_DELIMITERS, CONVERSION_SERVICE_BEAN_NAME, ENVIRONMENT_BEAN_NAME, LOAD_TIME_WEAVER_BEAN_NAME, SHUTDOWN_HOOK_THREAD_NAME, SYSTEM_ENVIRONMENT_BEAN_NAME, SYSTEM_PROPERTIES_BEAN_NAME
- インターフェース org.springframework.beans.factory.BeanFactory から継承されたフィールド
  FACTORY_BEAN_PREFIX
- インターフェース org.springframework.core.io.support.ResourcePatternResolver から継承されたフィールド
  CLASSPATH_ALL_URL_PREFIX
- インターフェース org.springframework.core.io.ResourceLoader から継承されたフィールド
  CLASSPATH_URL_PREFIX

コンストラクターの概要
コンストラクター
コンストラクターと説明
AnnotationConfigWebApplicationContext()

コンストラクター
コンストラクターと説明
`AnnotationConfigWebApplicationContext()`

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected AnnotatedBeanDefinitionReader`	`getAnnotatedBeanDefinitionReader(DefaultListableBeanFactory beanFactory)` 指定された Bean ファクトリの `AnnotatedBeanDefinitionReader` を構築します。
`protected BeanNameGenerator`	`getBeanNameGenerator()` `AnnotatedBeanDefinitionReader` および / または `ClassPathBeanDefinitionScanner` で使用するカスタム `BeanNameGenerator` を返します（ある場合）。
`protected ClassPathBeanDefinitionScanner`	`getClassPathBeanDefinitionScanner(DefaultListableBeanFactory beanFactory)` 指定された Bean ファクトリ用に `ClassPathBeanDefinitionScanner` を構築します。
`protected ScopeMetadataResolver`	`getScopeMetadataResolver()` `AnnotatedBeanDefinitionReader` および / または `ClassPathBeanDefinitionScanner` で使用するカスタム `ScopeMetadataResolver` を返します（ある場合）。
`protected void`	`loadBeanDefinitions(DefaultListableBeanFactory beanFactory)` `register(Class...)` で指定されたクラスの `BeanDefinition` を登録し、`scan(String...)` で指定されたパッケージをスキャンします。
`void`	`register(ClassSE<?>... componentClasses)` 処理する 1 つ以上のコンポーネントクラスを登録します。
`void`	`scan(StringSE... basePackages)` 指定された基本パッケージ内でスキャンを実行します。
`void`	`setBeanNameGenerator(BeanNameGenerator beanNameGenerator)` `AnnotatedBeanDefinitionReader` および / または `ClassPathBeanDefinitionScanner` で使用するカスタム `BeanNameGenerator` を設定します。
`void`	`setScopeMetadataResolver(ScopeMetadataResolver scopeMetadataResolver)` `AnnotatedBeanDefinitionReader` および / または `ClassPathBeanDefinitionScanner` で使用するカスタム `ScopeMetadataResolver` を設定します。

クラス org.springframework.web.context.support.AbstractRefreshableWebApplicationContext から継承されたメソッド
createEnvironment, getApplicationName, getConfigLocations, getNamespace, getResourceByPath, getResourcePatternResolver, getServletConfig, getServletContext, getTheme, initPropertySources, onRefresh, postProcessBeanFactory, setNamespace, setServletConfig, setServletContext

クラス org.springframework.context.support.AbstractRefreshableConfigApplicationContext から継承されたメソッド
afterPropertiesSet, getDefaultConfigLocations, resolvePath, setBeanName, setConfigLocation, setConfigLocations, setId

クラス org.springframework.context.support.AbstractRefreshableApplicationContext から継承されたメソッド
assertBeanFactoryActive, cancelRefresh, closeBeanFactory, createBeanFactory, customizeBeanFactory, getBeanFactory, hasBeanFactory, refreshBeanFactory, setAllowBeanDefinitionOverriding, setAllowCircularReferences

クラス org.springframework.context.support.AbstractApplicationContext から継承されたメソッド
addApplicationListener, addBeanFactoryPostProcessor, close, containsBean, containsBeanDefinition, containsLocalBean, destroy, destroyBeans, doClose, findAnnotationOnBean, finishBeanFactoryInitialization, finishRefresh, getAliases, getApplicationListeners, getAutowireCapableBeanFactory, getBean, getBean, getBean, getBean, getBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanFactoryPostProcessors, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeanProvider, getBeanProvider, getBeansOfType, getBeansOfType, getBeansWithAnnotation, getDisplayName, getEnvironment, getId, getInternalParentBeanFactory, getInternalParentMessageSource, getMessage, getMessage, getMessage, getParent, getParentBeanFactory, getResources, getStartupDate, getType, getType, initApplicationEventMulticaster, initLifecycleProcessor, initMessageSource, invokeBeanFactoryPostProcessors, isActive, isPrototype, isRunning, isSingleton, isTypeMatch, isTypeMatch, obtainFreshBeanFactory, onClose, prepareBeanFactory, prepareRefresh, publishEvent, publishEvent, publishEvent, refresh, registerBeanPostProcessors, registerListeners, registerShutdownHook, resetCommonCaches, setDisplayName, setEnvironment, setParent, start, stop, toString

クラス org.springframework.core.io.DefaultResourceLoader から継承されたメソッド
addProtocolResolver, clearResourceCaches, getClassLoader, getProtocolResolvers, getResource, getResourceCache, setClassLoader

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, waitSE, waitSE, waitSE

インターフェース org.springframework.web.context.ConfigurableWebApplicationContext から継承されたメソッド
setConfigLocation, setConfigLocations

インターフェース org.springframework.context.ConfigurableApplicationContext から継承されたメソッド
addApplicationListener, addBeanFactoryPostProcessor, addProtocolResolver, close, getBeanFactory, getEnvironment, isActive, refresh, registerShutdownHook, setClassLoader, setEnvironment, setId, setParent

インターフェース org.springframework.context.ApplicationContext から継承されたメソッド
getAutowireCapableBeanFactory, getDisplayName, getId, getParent, getStartupDate

インターフェース org.springframework.beans.factory.ListableBeanFactory から継承されたメソッド
containsBeanDefinition, findAnnotationOnBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeansOfType, getBeansOfType, getBeansWithAnnotation

インターフェース org.springframework.beans.factory.HierarchicalBeanFactory から継承されたメソッド
containsLocalBean, getParentBeanFactory

インターフェース org.springframework.beans.factory.BeanFactory から継承されたメソッド
containsBean, getAliases, getBean, getBean, getBean, getBean, getBean, getBeanProvider, getBeanProvider, getType, getType, isPrototype, isSingleton, isTypeMatch, isTypeMatch

インターフェース org.springframework.context.MessageSource から継承されたメソッド
getMessage, getMessage, getMessage

インターフェース org.springframework.context.ApplicationEventPublisher から継承されたメソッド
publishEvent, publishEvent

インターフェース org.springframework.core.io.support.ResourcePatternResolver から継承されたメソッド
getResources

インターフェース org.springframework.core.io.ResourceLoader から継承されたメソッド
getClassLoader, getResource

インターフェース org.springframework.context.Lifecycle から継承されたメソッド
isRunning, start, stop

- コンストラクターの詳細
  - AnnotationConfigWebApplicationContext
```
public AnnotationConfigWebApplicationContext()
```
- メソッドの詳細
  - setBeanNameGenerator
```
public void setBeanNameGenerator(@Nullable
                                 BeanNameGenerator beanNameGenerator)
```
    AnnotatedBeanDefinitionReader および / または ClassPathBeanDefinitionScanner で使用するカスタム BeanNameGenerator を設定します。
    デフォルトは AnnotationBeanNameGenerator です。
    関連事項:
    AnnotatedBeanDefinitionReader.setBeanNameGenerator(org.springframework.beans.factory.support.BeanNameGenerator), ClassPathBeanDefinitionScanner.setBeanNameGenerator(org.springframework.beans.factory.support.BeanNameGenerator)
  - getBeanNameGenerator
```
@Nullable
protected BeanNameGenerator getBeanNameGenerator()
```
    AnnotatedBeanDefinitionReader および / または ClassPathBeanDefinitionScanner で使用するカスタム BeanNameGenerator を返します（ある場合）。
  - setScopeMetadataResolver
```
public void setScopeMetadataResolver(@Nullable
                                     ScopeMetadataResolver scopeMetadataResolver)
```
    AnnotatedBeanDefinitionReader および / または ClassPathBeanDefinitionScanner で使用するカスタム ScopeMetadataResolver を設定します。
    デフォルトは AnnotationScopeMetadataResolver です。
    関連事項:
    AnnotatedBeanDefinitionReader.setScopeMetadataResolver(org.springframework.context.annotation.ScopeMetadataResolver), ClassPathBeanDefinitionScanner.setScopeMetadataResolver(org.springframework.context.annotation.ScopeMetadataResolver)
  - getScopeMetadataResolver
```
@Nullable
protected ScopeMetadataResolver getScopeMetadataResolver()
```
    AnnotatedBeanDefinitionReader および / または ClassPathBeanDefinitionScanner で使用するカスタム ScopeMetadataResolver を返します（ある場合）。
  - register
```
public void register(ClassSE<?>... componentClasses)
```
    処理する 1 つ以上のコンポーネントクラスを登録します。
    コンテキストで新しいクラスを完全に処理するには、AbstractApplicationContext.refresh() を呼び出す必要があることに注意してください。
    次で指定:
    インターフェース AnnotationConfigRegistry の register
    パラメーター:
    componentClasses - 1 つ以上のコンポーネントクラス。@Configuration クラス
    関連事項:
    scan(String...), loadBeanDefinitions(DefaultListableBeanFactory), AbstractRefreshableConfigApplicationContext.setConfigLocation(String), AbstractApplicationContext.refresh()
  - scan
```
public void scan(StringSE... basePackages)
```
    指定された基本パッケージ内でスキャンを実行します。
    コンテキストで新しいクラスを完全に処理するには、AbstractApplicationContext.refresh() を呼び出す必要があることに注意してください。
    次で指定:
    インターフェース AnnotationConfigRegistry の scan
    パラメーター:
    basePackages - コンポーネントクラスをチェックするパッケージ
    関連事項:
    loadBeanDefinitions(DefaultListableBeanFactory), register(Class...), AbstractRefreshableConfigApplicationContext.setConfigLocation(String), AbstractApplicationContext.refresh()
  - loadBeanDefinitions
```
protected void loadBeanDefinitions(DefaultListableBeanFactory beanFactory)
```
    register(Class...) で指定されたクラスの BeanDefinition を登録し、scan(String...) で指定されたパッケージをスキャンします。
    AbstractRefreshableConfigApplicationContext.setConfigLocation(String) または AbstractRefreshableConfigApplicationContext.setConfigLocations(String[]) で指定された値について、まず各場所をクラスとしてロードし、クラスのロードが成功した場合（つまり ClassNotFoundException が発生した場合）に BeanDefinition を登録し、値がパッケージであると想定してコンポーネントクラスをスキャンします。
    @Autowired、@Required、関連するアノテーションを使用できるように、アノテーション構成ポストプロセッサーのデフォルトセットを有効にします。
    value 属性がステレオタイプアノテーションに提供されない限り、構成クラス Bean 定義は、生成された Bean 定義名で登録されます。
    次で指定:
    クラス AbstractRefreshableApplicationContext の loadBeanDefinitions
    パラメーター:
    beanFactory - Bean 定義をロードする Bean ファクトリ
    関連事項:
    register(Class...), scan(String...), AbstractRefreshableConfigApplicationContext.setConfigLocation(String), AbstractRefreshableConfigApplicationContext.setConfigLocations(String[]), AnnotatedBeanDefinitionReader, ClassPathBeanDefinitionScanner
  - getAnnotatedBeanDefinitionReader
```
protected AnnotatedBeanDefinitionReader getAnnotatedBeanDefinitionReader(DefaultListableBeanFactory beanFactory)
```
    指定された Bean ファクトリの AnnotatedBeanDefinitionReader を構築します。
    これは、Environment （必要な場合）で事前に構成する必要がありますが、BeanNameGenerator または ScopeMetadataResolver ではまだ構成しないでください。
    パラメーター:
    beanFactory - Bean 定義をロードする Bean ファクトリ
    導入:
    4.1.9
    関連事項:
    AbstractApplicationContext.getEnvironment(), getBeanNameGenerator(), getScopeMetadataResolver()
  - getClassPathBeanDefinitionScanner
```
protected ClassPathBeanDefinitionScanner getClassPathBeanDefinitionScanner(DefaultListableBeanFactory beanFactory)
```
    指定された Bean ファクトリ用に ClassPathBeanDefinitionScanner を構築します。
    これは、Environment （必要な場合）で事前に構成する必要がありますが、BeanNameGenerator または ScopeMetadataResolver ではまだ構成しないでください。
    パラメーター:
    beanFactory - Bean 定義をロードする Bean ファクトリ
    導入:
    4.1.9
    関連事項:
    AbstractApplicationContext.getEnvironment(), getBeanNameGenerator(), getScopeMetadataResolver()

クラス AnnotationConfigWebApplicationContext

ネストされたクラスの要約

クラス org.springframework.core.io.DefaultResourceLoader から継承されたネストクラス / インターフェース

フィールドのサマリー

クラス org.springframework.context.support.AbstractApplicationContext から継承されたフィールド

インターフェース org.springframework.web.context.ConfigurableWebApplicationContext から継承されたフィールド

インターフェース org.springframework.web.context.WebApplicationContext から継承されたフィールド

インターフェース org.springframework.context.ConfigurableApplicationContext から継承されたフィールド

インターフェース org.springframework.beans.factory.BeanFactory から継承されたフィールド

インターフェース org.springframework.core.io.support.ResourcePatternResolver から継承されたフィールド

インターフェース org.springframework.core.io.ResourceLoader から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.web.context.support.AbstractRefreshableWebApplicationContext から継承されたメソッド

クラス org.springframework.context.support.AbstractRefreshableConfigApplicationContext から継承されたメソッド

クラス org.springframework.context.support.AbstractRefreshableApplicationContext から継承されたメソッド

クラス org.springframework.context.support.AbstractApplicationContext から継承されたメソッド

クラス org.springframework.core.io.DefaultResourceLoader から継承されたメソッド

クラス java.lang.ObjectSE から継承されたメソッド

インターフェース org.springframework.web.context.ConfigurableWebApplicationContext から継承されたメソッド

インターフェース org.springframework.context.ConfigurableApplicationContext から継承されたメソッド

インターフェース org.springframework.context.ApplicationContext から継承されたメソッド

インターフェース org.springframework.beans.factory.ListableBeanFactory から継承されたメソッド

インターフェース org.springframework.beans.factory.HierarchicalBeanFactory から継承されたメソッド

インターフェース org.springframework.beans.factory.BeanFactory から継承されたメソッド

インターフェース org.springframework.context.MessageSource から継承されたメソッド

インターフェース org.springframework.context.ApplicationEventPublisher から継承されたメソッド

インターフェース org.springframework.core.io.support.ResourcePatternResolver から継承されたメソッド

インターフェース org.springframework.core.io.ResourceLoader から継承されたメソッド

インターフェース org.springframework.context.Lifecycle から継承されたメソッド

コンストラクターの詳細

AnnotationConfigWebApplicationContext

メソッドの詳細

setBeanNameGenerator

getBeanNameGenerator

setScopeMetadataResolver

getScopeMetadataResolver

register

scan

loadBeanDefinitions

getAnnotatedBeanDefinitionReader

getClassPathBeanDefinitionScanner