类 AbstractGenericContextLoader

字段详细资料

• logger

  protected static final Log logger

构造器详细资料

• AbstractGenericContextLoader

  public AbstractGenericContextLoader()

方法详细资料

• loadContext

  public final ConfigurableApplicationContext loadContext​(MergedContextConfiguration mergedConfig)
                                                   throws Exception

  Load a Spring ApplicationContext from the supplied MergedContextConfiguration.

  Implementation details:

  • Calls validateMergedContextConfiguration(MergedContextConfiguration) to allow subclasses to validate the supplied configuration before proceeding.
  • Creates a GenericApplicationContext instance.
  • If the supplied MergedContextConfiguration references a parent configuration, the corresponding ApplicationContext will be retrieved and set as the parent for the context created by this method.
  • Calls prepareContext(GenericApplicationContext) for backwards compatibility with the ContextLoader SPI.
  • Calls AbstractContextLoader.prepareContext(ConfigurableApplicationContext, MergedContextConfiguration) to allow for customizing the context before bean definitions are loaded.
  • Calls customizeBeanFactory(DefaultListableBeanFactory) to allow for customizing the context's DefaultListableBeanFactory.
  • Delegates to loadBeanDefinitions(GenericApplicationContext, MergedContextConfiguration) to populate the context from the locations or classes in the supplied MergedContextConfiguration.
  • Delegates to AnnotationConfigUtils for registering annotation configuration processors.
  • Calls customizeContext(GenericApplicationContext) to allow for customizing the context before it is refreshed.
  • Calls AbstractContextLoader.customizeContext(ConfigurableApplicationContext, MergedContextConfiguration) to allow for customizing the context before it is refreshed.
  • Refreshes the context and registers a JVM shutdown hook for it.

  参数:

  mergedConfig - the merged context configuration to use to load the application context

  返回:

  a new application context

  抛出:

  Exception - if context loading failed

  从以下版本开始:

  3.1

  另请参阅:

  SmartContextLoader.loadContext(MergedContextConfiguration), GenericApplicationContext

• validateMergedContextConfiguration

  protected void validateMergedContextConfiguration​(MergedContextConfiguration mergedConfig)

  Validate the supplied MergedContextConfiguration with respect to what this context loader supports.

  The default implementation is a no-op but can be overridden by subclasses as appropriate.

  参数:

  mergedConfig - the merged configuration to validate

  抛出:

  IllegalStateException - if the supplied configuration is not valid for this context loader

  从以下版本开始:

  4.0.4

• loadContext

  public final ConfigurableApplicationContext loadContext​(String... locations)
                                                   throws Exception

  Load a Spring ApplicationContext from the supplied locations.

  Implementation details:

  • Creates a GenericApplicationContext instance.
  • Calls prepareContext(GenericApplicationContext) to allow for customizing the context before bean definitions are loaded.
  • Calls customizeBeanFactory(DefaultListableBeanFactory) to allow for customizing the context's DefaultListableBeanFactory.
  • Delegates to createBeanDefinitionReader(GenericApplicationContext) to create a BeanDefinitionReader which is then used to populate the context from the specified locations.
  • Delegates to AnnotationConfigUtils for registering annotation configuration processors.
  • Calls customizeContext(GenericApplicationContext) to allow for customizing the context before it is refreshed.
  • Refreshes the context and registers a JVM shutdown hook for it.

  Note: this method does not provide a means to set active bean definition profiles for the loaded context. See loadContext(MergedContextConfiguration) and AbstractContextLoader.prepareContext(ConfigurableApplicationContext, MergedContextConfiguration) for an alternative.

  参数:

  locations - the resource locations to use to load the application context

  返回:

  a new application context

  抛出:

  Exception - if context loading failed

  从以下版本开始:

  2.5

  另请参阅:

  ContextLoader.loadContext(java.lang.String...), GenericApplicationContext, loadContext(MergedContextConfiguration)

• prepareContext

  protected void prepareContext​(GenericApplicationContext context)

  Prepare the GenericApplicationContext created by this ContextLoader. Called before bean definitions are read.

  The default implementation is empty. Can be overridden in subclasses to customize GenericApplicationContext's standard settings.

  参数:

  context - the context that should be prepared

  从以下版本开始:

  2.5

  另请参阅:

  loadContext(MergedContextConfiguration), loadContext(String...), GenericApplicationContext.setAllowBeanDefinitionOverriding(boolean), GenericApplicationContext.setResourceLoader(org.springframework.core.io.ResourceLoader), AbstractApplicationContext.setId(java.lang.String), AbstractContextLoader.prepareContext(ConfigurableApplicationContext, MergedContextConfiguration)

• customizeBeanFactory

  protected void customizeBeanFactory​(DefaultListableBeanFactory beanFactory)

  Customize the internal bean factory of the ApplicationContext created by this ContextLoader.

  The default implementation is empty but can be overridden in subclasses to customize DefaultListableBeanFactory's standard settings.

  参数:

  beanFactory - the bean factory created by this ContextLoader

  从以下版本开始:

  2.5

  另请参阅:

  loadContext(MergedContextConfiguration), loadContext(String...), DefaultListableBeanFactory.setAllowBeanDefinitionOverriding(boolean), DefaultListableBeanFactory.setAllowEagerClassLoading(boolean), AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean), AbstractAutowireCapableBeanFactory.setAllowRawInjectionDespiteWrapping(boolean)

• loadBeanDefinitions

  protected void loadBeanDefinitions​(GenericApplicationContext context,
                                     MergedContextConfiguration mergedConfig)

  Load bean definitions into the supplied context from the locations or classes in the supplied MergedContextConfiguration.

  The default implementation delegates to the BeanDefinitionReader returned by createBeanDefinitionReader(GenericApplicationContext) to load the bean definitions.

  Subclasses must provide an appropriate implementation of createBeanDefinitionReader(GenericApplicationContext). Alternatively subclasses may provide a no-op implementation of createBeanDefinitionReader() and override this method to provide a custom strategy for loading or registering bean definitions.

  参数:

  context - the context into which the bean definitions should be loaded

  mergedConfig - the merged context configuration

  从以下版本开始:

  3.1

  另请参阅:

  loadContext(MergedContextConfiguration)

• createBeanDefinitionReader

  protected abstract BeanDefinitionReader createBeanDefinitionReader​(GenericApplicationContext context)

  Factory method for creating a new BeanDefinitionReader for loading bean definitions into the supplied context.

  参数:

  context - the context for which the BeanDefinitionReader should be created

  返回:

  a BeanDefinitionReader for the supplied context

  从以下版本开始:

  2.5

  另请参阅:

  loadContext(String...), loadBeanDefinitions(org.springframework.context.support.GenericApplicationContext, org.springframework.test.context.MergedContextConfiguration), BeanDefinitionReader

• customizeContext

  protected void customizeContext​(GenericApplicationContext context)

  Customize the GenericApplicationContext created by this ContextLoaderafter bean definitions have been loaded into the context but before the context is refreshed.

  The default implementation is empty but can be overridden in subclasses to customize the application context.

  参数:

  context - the newly created application context

  从以下版本开始:

  2.5

  另请参阅:

  loadContext(MergedContextConfiguration), loadContext(String...), AbstractContextLoader.customizeContext(ConfigurableApplicationContext, MergedContextConfiguration)