org.springframework.boot.test.context

Interface AssertableApplicationContext

public interface AssertableApplicationContext

An ApplicationContext that additionally supports AssertJ style assertions. Can be used to decorate and existing application context or an application context that failed to start.

See AssertProviderApplicationContext for more details.

Since:

2.0.0

Author:

Phillip Webb

See Also:

ApplicationContextTester, ApplicationContext

Field Summary

Fields inherited from interface org.springframework.beans.factory.BeanFactory

FACTORY_BEAN_PREFIX

Fields inherited from interface org.springframework.core.io.support.ResourcePatternResolver

CLASSPATH_ALL_URL_PREFIX

Fields inherited from interface org.springframework.core.io.ResourceLoader

CLASSPATH_URL_PREFIX

Method Summary

Modifier and Type	Method and Description
ApplicationContextAssert<C>	assertThat() Deprecated. use standard AssertJ assertThat(context)... calls instead.
void	close()
static <T extends org.springframework.boot.test.context.AssertProviderApplicationContext<C>,C extends ApplicationContext> T	get(Class<T> type, Class<? extends C> contextType, Supplier<? extends C> contextSupplier) Factory method to create a new AssertProviderApplicationContext instance.
static AssertableApplicationContext	get(Supplier<? extends ConfigurableApplicationContext> contextSupplier) Factory method to create a new AssertableApplicationContext instance.
C	getSourceApplicationContext() Return the original source ApplicationContext.
<T extends C> T	getSourceApplicationContext(Class<T> requiredType) Return the original source ApplicationContext, casting it to the requested type.
Throwable	getStartupFailure() Return the failure that caused application context to fail or null if the context started without issue.

Methods inherited from interface org.springframework.context.ApplicationContext

getApplicationName, getAutowireCapableBeanFactory, getDisplayName, getId, getParent, getStartupDate

Methods inherited from interface org.springframework.core.env.EnvironmentCapable

getEnvironment

Methods inherited from interface org.springframework.beans.factory.ListableBeanFactory

containsBeanDefinition, findAnnotationOnBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeansOfType, getBeansOfType, getBeansWithAnnotation

Methods inherited from interface org.springframework.beans.factory.HierarchicalBeanFactory

containsLocalBean, getParentBeanFactory

Methods inherited from interface org.springframework.beans.factory.BeanFactory

containsBean, getAliases, getBean, getBean, getBean, getBean, getBean, getType, isPrototype, isSingleton, isTypeMatch, isTypeMatch

Methods inherited from interface org.springframework.context.MessageSource

getMessage, getMessage, getMessage

Methods inherited from interface org.springframework.context.ApplicationEventPublisher

publishEvent, publishEvent

Methods inherited from interface org.springframework.core.io.support.ResourcePatternResolver

getResources

Methods inherited from interface org.springframework.core.io.ResourceLoader

getClassLoader, getResource

Method Detail

get

static AssertableApplicationContext get(Supplier<? extends ConfigurableApplicationContext> contextSupplier)

Factory method to create a new AssertableApplicationContext instance.

Parameters:

contextSupplier - a supplier that will either return a fully configured ConfigurableApplicationContext or throw an exception if the context fails to start.

Returns:

an AssertableApplicationContext instance

assertThat

@Deprecated
ApplicationContextAssert<C> assertThat()

Deprecated. use standard AssertJ assertThat(context)... calls instead.

Return an assert for AspectJ.

Specified by:

assertThat in interface org.assertj.core.api.AssertProvider<ApplicationContextAssert<C extends ApplicationContext>>

Returns:

an AspectJ assert

getSourceApplicationContext

C getSourceApplicationContext()

Return the original source ApplicationContext.

Returns:

the source application context

Throws:

IllegalStateException - if the source context failed to start

getSourceApplicationContext

<T extends C> T getSourceApplicationContext(Class<T> requiredType)

Return the original source ApplicationContext, casting it to the requested type.

Type Parameters:

T - the context type

Parameters:

requiredType - the required context type

Returns:

the source application context

Throws:

IllegalStateException - if the source context failed to start

getStartupFailure

Throwable getStartupFailure()

Return the failure that caused application context to fail or null if the context started without issue.

Returns:

the startup failure or null

close

void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

get

static <T extends org.springframework.boot.test.context.AssertProviderApplicationContext<C>,C extends ApplicationContext> T get(Class<T> type,
                                                                                                                                Class<? extends C> contextType,
                                                                                                                                Supplier<? extends C> contextSupplier)

Factory method to create a new AssertProviderApplicationContext instance.

Type Parameters:

T - the assert provider type

C - the context type

Parameters:

type - the type of AssertProviderApplicationContext required (must be an interface)

contextType - the type of ApplicationContext being managed (must be an interface)

contextSupplier - a supplier that will either return a fully configured ApplicationContext or throw an exception if the context fails to start.

Returns:

a AssertProviderApplicationContext instance