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

类 InfraApplicationContextLoader

java.lang.Object

cn.taketoday.test.context.support.AbstractContextLoader

cn.taketoday.framework.test.context.InfraApplicationContextLoader

所有已实现的接口:

ContextLoader, SmartContextLoader

public class InfraApplicationContextLoader
extends AbstractContextLoader

A ContextLoader that can be used to test Infra applications (those that normally startup using Application). Although this loader can be used directly, most test will instead want to use it with @InfraTest.

The loader supports both standard MergedContextConfiguration as well as WebMergedContextConfiguration. If WebMergedContextConfiguration is used the context will either use a mock servlet environment, or start the full embedded web server.

If @ActiveProfiles are provided in the test class they will be used to create the application context.

从以下版本开始:

4.0

作者:

Dave Syer, Phillip Webb, Andy Wilkinson, Stephane Nicoll, Madhura Bhave, Scott Frederick, Harry Yang

另请参阅:

• InfraTest

嵌套类概要

嵌套类

修饰符和类型	类	说明
private static class	InfraApplicationContextLoader.ContextCustomizerAdapter	Adapts a ContextCustomizer to a ApplicationContextInitializer so that it can be triggered via Application.
private static class	InfraApplicationContextLoader.ParentContextApplicationContextInitializer	ApplicationContextInitializer used to set the parent context.
private class	InfraApplicationContextLoader.PrepareEnvironmentListener	ApplicationListener used to prepare the application created environment.
private static class	InfraApplicationContextLoader.WebConfigurer	Inner class to configure WebMergedContextConfiguration.

构造器概要

构造器

构造器	说明
InfraApplicationContextLoader()

方法概要

修饰符和类型	方法	说明
protected Class<?>[]	detectDefaultConfigurationClasses(Class<?> declaringClass)	Detect the default configuration classes for the supplied test class.
protected cn.taketoday.framework.Application	getApplication()	Builds new Application instance.
protected cn.taketoday.core.env.ConfigurableEnvironment	getEnvironment()	Returns the ConfigurableEnvironment instance that should be applied to Application or null to use the default.
protected List<cn.taketoday.context.ApplicationContextInitializer>	getInitializers(MergedContextConfiguration config, cn.taketoday.framework.Application application)	Return the initializers that will be applied to the context.
protected String[]	getInlinedProperties(MergedContextConfiguration config)
protected String	getResourceSuffix()	Get the suffix to append to ApplicationContext resource locations when detecting default locations.
protected String[]	getResourceSuffixes()	Get the suffixes to append to ApplicationContext resource locations when detecting default locations.
private boolean	isEmbeddedWebEnvironment(MergedContextConfiguration config)
cn.taketoday.context.ApplicationContext	loadContext(MergedContextConfiguration config)	Load a new ApplicationContext based on the supplied MergedContextConfiguration, configure the context, and return the context in a fully refreshed state.
cn.taketoday.context.ApplicationContext	loadContext(String... locations)	SmartContextLoader does not support deprecated ContextLoader methods.
private void	prepareEnvironment(MergedContextConfiguration config, cn.taketoday.framework.Application application, cn.taketoday.core.env.ConfigurableEnvironment environment, boolean applicationEnvironment)
void	processContextConfiguration(ContextConfigurationAttributes configAttributes)	The default implementation processes locations analogous to AbstractContextLoader.processLocations(Class, String...), using the declaring class as the test class and the resource locations retrieved from the supplied configuration attributes as the locations to process.
private void	setActiveProfiles(cn.taketoday.core.env.ConfigurableEnvironment environment, String[] profiles, boolean applicationEnvironment)

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

customizeContext, generateDefaultLocations, isGenerateDefaultLocations, modifyLocations, prepareContext, processLocations

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

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

构造器详细资料

InfraApplicationContextLoader

public InfraApplicationContextLoader()

方法详细资料

loadContext

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

从接口复制的说明: SmartContextLoader

Load a new ApplicationContext based on the supplied MergedContextConfiguration, configure the context, and return the context in a fully refreshed state.

Concrete implementations should register annotation configuration processors with bean factories of application contexts loaded by this SmartContextLoader. Beans will therefore automatically be candidates for annotation-based dependency injection using @Autowired, @Resource, and @Inject. In addition, concrete implementations should perform the following actions.

• Set the parent ApplicationContext if appropriate (see MergedContextConfiguration.getParent()).
• Set the active bean definition profiles in the context's Environment (see MergedContextConfiguration.getActiveProfiles()).
• Add test PropertySources to the Environment (see MergedContextConfiguration.getPropertySourceLocations(), MergedContextConfiguration.getPropertySourceProperties(), and TestPropertySourceUtils).
• Invoke ApplicationContextInitializers (see MergedContextConfiguration.getContextInitializerClasses()).
• Invoke ContextCustomizers (see MergedContextConfiguration.getContextCustomizers()).
• Register a JVM shutdown hook for the ApplicationContext. Unless the context gets closed early, all context instances will be automatically closed on JVM shutdown. This allows for freeing of external resources held by beans within the context — for example, temporary files.

any exception thrown while attempting to load an ApplicationContext should be wrapped in a ContextLoadException. Concrete implementations should therefore contain a try-catch block similar to the following.

 ApplicationContext context = // create context
 try {
     // configure and refresh context
 }
 catch (Exception ex) {
     throw new ContextLoadException(context, ex);
 }
 

参数:

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

返回:

a new application context

抛出:

ContextLoadException - if context loading failed

Exception

另请参阅:

• SmartContextLoader.processContextConfiguration(ContextConfigurationAttributes)
• AnnotationConfigUtils.registerAnnotationConfigProcessors(cn.taketoday.beans.factory.support.BeanDefinitionRegistry)
• ConfigurableApplicationContext.getEnvironment()

prepareEnvironment

private void prepareEnvironment(MergedContextConfiguration config,
 cn.taketoday.framework.Application application,
 cn.taketoday.core.env.ConfigurableEnvironment environment,
 boolean applicationEnvironment)

setActiveProfiles

private void setActiveProfiles(cn.taketoday.core.env.ConfigurableEnvironment environment,
 String[] profiles,
 boolean applicationEnvironment)

getApplication

protected cn.taketoday.framework.Application getApplication()

Builds new Application instance. You can override this method to add custom behavior

返回:

Application instance

getEnvironment

protected cn.taketoday.core.env.ConfigurableEnvironment getEnvironment()

Returns the ConfigurableEnvironment instance that should be applied to Application or null to use the default. You can override this method if you need a custom environment.

返回:

a ConfigurableEnvironment instance

getInlinedProperties

protected String[] getInlinedProperties(MergedContextConfiguration config)

getInitializers

protected List<cn.taketoday.context.ApplicationContextInitializer> getInitializers(MergedContextConfiguration config,
 cn.taketoday.framework.Application application)

Return the initializers that will be applied to the context. By default this method will adapt context customizers, add application initializers and add initializers specified on the test.

参数:

config - the source context configuration

application - the application instance

返回:

the initializers to apply

isEmbeddedWebEnvironment

private boolean isEmbeddedWebEnvironment(MergedContextConfiguration config)

processContextConfiguration

public void processContextConfiguration(ContextConfigurationAttributes configAttributes)

从类复制的说明: AbstractContextLoader

The default implementation processes locations analogous to AbstractContextLoader.processLocations(Class, String...), using the declaring class as the test class and the resource locations retrieved from the supplied configuration attributes as the locations to process. The processed locations are then set in the supplied configuration attributes.

Can be overridden in subclasses — for example, to process annotated classes instead of resource locations.

指定者:

processContextConfiguration 在接口中 SmartContextLoader

覆盖:

processContextConfiguration 在类中 AbstractContextLoader

参数:

configAttributes - the context configuration attributes to process

另请参阅:

• AbstractContextLoader.processLocations(Class, String...)

detectDefaultConfigurationClasses

protected Class<?>[] detectDefaultConfigurationClasses(Class<?> declaringClass)

Detect the default configuration classes for the supplied test class. By default simply delegates to AnnotationConfigContextLoaderUtils.detectDefaultConfigurationClasses(java.lang.Class<?>).

参数:

declaringClass - the test class that declared @ContextConfiguration

返回:

an array of default configuration classes, potentially empty but never null

另请参阅:

• AnnotationConfigContextLoaderUtils

loadContext

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

从接口复制的说明: SmartContextLoader

SmartContextLoader does not support deprecated ContextLoader methods.

Call SmartContextLoader.loadContext(MergedContextConfiguration) instead.

参数:

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

返回:

a new application context

抛出:

Exception - if context loading failed

getResourceSuffixes

protected String[] getResourceSuffixes()

从类复制的说明: AbstractContextLoader

Get the suffixes to append to ApplicationContext resource locations when detecting default locations.

The default implementation simply wraps the value returned by AbstractContextLoader.getResourceSuffix() in a single-element array, but this can be overridden by subclasses in order to support multiple suffixes.

覆盖:

getResourceSuffixes 在类中 AbstractContextLoader

返回:

the resource suffixes; never null or empty

另请参阅:

• AbstractContextLoader.generateDefaultLocations(Class)

getResourceSuffix

protected String getResourceSuffix()

从类复制的说明: AbstractContextLoader

Get the suffix to append to ApplicationContext resource locations when detecting default locations.

Subclasses must provide an implementation of this method that returns a single suffix. Alternatively subclasses may provide a no-op implementation of this method and override AbstractContextLoader.getResourceSuffixes() in order to provide multiple custom suffixes.

指定者:

getResourceSuffix 在类中 AbstractContextLoader

返回:

the resource suffix; never null or empty

另请参阅:

• AbstractContextLoader.generateDefaultLocations(Class)
• AbstractContextLoader.getResourceSuffixes()