程序包 cn.taketoday.test.context.support

类 AbstractGenericContextLoader

java.lang.Object

cn.taketoday.test.context.support.AbstractContextLoader

cn.taketoday.test.context.support.AbstractGenericContextLoader

所有已实现的接口:

AotContextLoader, ContextLoader, SmartContextLoader

直接已知子类:

AnnotationConfigContextLoader, GenericPropertiesContextLoader, GenericXmlContextLoader

public abstract class AbstractGenericContextLoader
extends AbstractContextLoader
implements AotContextLoader

Abstract, generic extension of AbstractContextLoader that loads a GenericApplicationContext.

• If instances of concrete subclasses are invoked via the ContextLoader SPI, the context will be loaded from the locations provided to loadContext(String...).
• If instances of concrete subclasses are invoked via the SmartContextLoader SPI, the context will be loaded from the MergedContextConfiguration provided to loadContext(MergedContextConfiguration). In such cases, a SmartContextLoader will decide whether to load the context from locations or annotated classes.

Concrete subclasses must provide an appropriate implementation of createBeanDefinitionReader(), potentially overriding loadBeanDefinitions() as well.

从以下版本开始:

4.0

作者:

Sam Brannen, Juergen Hoeller, Phillip Webb, Harry Yang

另请参阅:

• loadContext(MergedContextConfiguration)
• loadContext(String...)

字段概要

字段

修饰符和类型	字段	说明
protected static final cn.taketoday.logging.Logger	log

构造器概要

构造器

构造器	说明
AbstractGenericContextLoader()

方法概要

修饰符和类型	方法	说明
protected abstract cn.taketoday.beans.factory.support.BeanDefinitionReader	createBeanDefinitionReader(cn.taketoday.context.support.GenericApplicationContext context)	Factory method for creating a new BeanDefinitionReader for loading bean definitions into the supplied context.
protected cn.taketoday.context.support.GenericApplicationContext	createContext()	Factory method for creating the GenericApplicationContext used by this ContextLoader.
protected void	customizeBeanFactory(cn.taketoday.beans.factory.support.StandardBeanFactory beanFactory)	Customize the internal bean factory of the ApplicationContext created by this ContextLoader.
protected void	customizeContext(cn.taketoday.context.support.GenericApplicationContext context)	Customize the GenericApplicationContext created by this ContextLoader after bean definitions have been loaded into the context but before the context is refreshed.
protected void	loadBeanDefinitions(cn.taketoday.context.support.GenericApplicationContext context, MergedContextConfiguration mergedConfig)	Load bean definitions into the supplied context from the locations or classes in the supplied MergedContextConfiguration.
final cn.taketoday.context.ApplicationContext	loadContext(MergedContextConfiguration mergedConfig)	Load a GenericApplicationContext for the supplied MergedContextConfiguration.
private cn.taketoday.context.support.GenericApplicationContext	loadContext(MergedContextConfiguration mergedConfig, boolean forAotProcessing)	Load a GenericApplicationContext for the supplied MergedContextConfiguration.
final cn.taketoday.context.ConfigurableApplicationContext	loadContext(String... locations)	Load a Infra ApplicationContext from the supplied locations.
final cn.taketoday.context.support.GenericApplicationContext	loadContextForAotProcessing(MergedContextConfiguration mergedConfig)	Load a GenericApplicationContext for AOT build-time processing based on the supplied MergedContextConfiguration.
final cn.taketoday.context.support.GenericApplicationContext	loadContextForAotRuntime(MergedContextConfiguration mergedConfig, cn.taketoday.context.ApplicationContextInitializer initializer)	Load a GenericApplicationContext for AOT run-time execution based on the supplied MergedContextConfiguration and ApplicationContextInitializer.
protected void	prepareContext(cn.taketoday.context.support.GenericApplicationContext context)	Prepare the GenericApplicationContext created by this ContextLoader.
protected void	validateMergedContextConfiguration(MergedContextConfiguration mergedConfig)	Validate the supplied MergedContextConfiguration with respect to what this context loader supports.

从类继承的方法 cn.taketoday.test.context.support.AbstractContextLoader

customizeContext, generateDefaultLocations, getResourceSuffix, getResourceSuffixes, isGenerateDefaultLocations, modifyLocations, prepareContext, processContextConfiguration, processLocations

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 cn.taketoday.test.context.SmartContextLoader

processContextConfiguration, processLocations

字段详细资料

log

protected static final cn.taketoday.logging.Logger log

构造器详细资料

AbstractGenericContextLoader

public AbstractGenericContextLoader()

方法详细资料

loadContext

public final cn.taketoday.context.ApplicationContext loadContext(MergedContextConfiguration mergedConfig)
                                                          throws Exception

Load a GenericApplicationContext for the supplied MergedContextConfiguration.

Implementation details:

• Calls validateMergedContextConfiguration(MergedContextConfiguration) to allow subclasses to validate the supplied configuration before proceeding.
• Calls createContext() to create 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(StandardBeanFactory) 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.

指定者:

loadContext 在接口中 SmartContextLoader

参数:

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

返回:

a new application context

抛出:

ContextLoadException - if context loading failed

Exception

另请参阅:

• SmartContextLoader.loadContext(MergedContextConfiguration)

loadContextForAotProcessing

public final cn.taketoday.context.support.GenericApplicationContext loadContextForAotProcessing(MergedContextConfiguration mergedConfig)
                                                                                         throws Exception

Load a GenericApplicationContext for AOT build-time processing based on the supplied MergedContextConfiguration.

In contrast to loadContext(MergedContextConfiguration), this method does not refresh the ApplicationContext or register a JVM shutdown hook for it. Otherwise, this method implements behavior identical to loadContext(MergedContextConfiguration).

指定者:

loadContextForAotProcessing 在接口中 AotContextLoader

参数:

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

返回:

a new application context

抛出:

Exception - if context loading failed

另请参阅:

• AotContextLoader.loadContextForAotProcessing(MergedContextConfiguration)

loadContextForAotRuntime

public final cn.taketoday.context.support.GenericApplicationContext loadContextForAotRuntime(MergedContextConfiguration mergedConfig,
 cn.taketoday.context.ApplicationContextInitializer initializer)
                                                                                      throws Exception

Load a GenericApplicationContext for AOT run-time execution based on the supplied MergedContextConfiguration and ApplicationContextInitializer.

指定者:

loadContextForAotRuntime 在接口中 AotContextLoader

参数:

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

initializer - the ApplicationContextInitializer that should be applied to the context in order to recreate bean definitions

返回:

a new application context

抛出:

Exception - if context loading failed

另请参阅:

• AotContextLoader.loadContextForAotRuntime(MergedContextConfiguration, ApplicationContextInitializer)

loadContext

private cn.taketoday.context.support.GenericApplicationContext loadContext(MergedContextConfiguration mergedConfig,
 boolean forAotProcessing)
                                                                    throws Exception

Load a GenericApplicationContext for the supplied MergedContextConfiguration.

参数:

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

forAotProcessing - true if the context is being loaded for AOT processing, meaning not to refresh the ApplicationContext or register a JVM shutdown hook for it

返回:

a new application context

抛出:

Exception

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

loadContext

public final cn.taketoday.context.ConfigurableApplicationContext loadContext(String... locations)
                                                                      throws Exception

Load a Infra ApplicationContext from the supplied locations.

Implementation details:

• Calls createContext() to create a GenericApplicationContext instance.
• Calls prepareContext(GenericApplicationContext) to allow for customizing the context before bean definitions are loaded.
• Calls customizeBeanFactory(StandardBeanFactory) 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.

指定者:

loadContext 在接口中 ContextLoader

指定者:

loadContext 在接口中 SmartContextLoader

参数:

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

返回:

a new application context

抛出:

Exception - if context loading failed

另请参阅:

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

createContext

protected cn.taketoday.context.support.GenericApplicationContext createContext()

Factory method for creating the GenericApplicationContext used by this ContextLoader.

The default implementation creates a GenericApplicationContext using the default constructor. This method may be overridden — for example, to use a custom context subclass or to create a GenericApplicationContext with a custom StandardBeanFactory implementation.

返回:

a newly instantiated GenericApplicationContext

prepareContext

protected void prepareContext(cn.taketoday.context.support.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

另请参阅:

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

customizeBeanFactory

protected void customizeBeanFactory(cn.taketoday.beans.factory.support.StandardBeanFactory 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

另请参阅:

• loadContext(MergedContextConfiguration)
• StandardBeanFactory.setAllowBeanDefinitionOverriding(boolean)
• StandardBeanFactory.setAllowEagerClassLoading(boolean)
• AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean)
• AbstractAutowireCapableBeanFactory.setAllowRawInjectionDespiteWrapping(boolean)

loadBeanDefinitions

protected void loadBeanDefinitions(cn.taketoday.context.support.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

另请参阅:

• loadContext(MergedContextConfiguration)

createBeanDefinitionReader

protected abstract cn.taketoday.beans.factory.support.BeanDefinitionReader createBeanDefinitionReader(cn.taketoday.context.support.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

另请参阅:

• loadContext(MergedContextConfiguration)
• loadBeanDefinitions(cn.taketoday.context.support.GenericApplicationContext, cn.taketoday.test.context.MergedContextConfiguration)
• BeanDefinitionReader

customizeContext

protected void customizeContext(cn.taketoday.context.support.GenericApplicationContext context)

Customize the GenericApplicationContext created by this ContextLoader after 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

另请参阅:

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