@Target(value=TYPE) @Retention(value=RUNTIME) @Documented @Inherited @BootstrapWith(value=org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTestContextBootstrapper.class) @OverrideAutoConfiguration(enabled=false) @TypeExcludeFilters(value=org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTypeExcludeFilter.class) @AutoConfigureCache @AutoConfigureWebMvc @AutoConfigureMockMvc @ImportAutoConfiguration public @interface WebMvcTest
@RunWith(SpringRunner.class)
for a typical Spring MVC test. Can be used when a test focuses only on
Spring MVC components.
Using this annotation will disable full auto-configuration and instead apply only
configuration relevant to MVC tests (i.e. @Controller
,
@ControllerAdvice
, @JsonComponent
Filter
,
WebMvcConfigurer
and HandlerMethodArgumentResolver
beans but not
@Component
, @Service
or @Repository
beans).
By default, tests annotated with @WebMvcTest
will also auto-configure Spring
Security and MockMvc
(include support for HtmlUnit WebClient and Selenium
WebDriver). For more fine-grained control of MockMVC the
@AutoConfigureMockMvc
annotation can be used.
Typically @WebMvcTest
is used in combination with @MockBean
or
@Import
to create any collaborators required by your @Controller
beans.
If you are looking to load your full application configuration and use MockMVC, you
should consider @SpringBootTest
combined with
@AutoConfigureMockMvc
rather than this annotation.
AutoConfigureWebMvc
,
AutoConfigureMockMvc
,
AutoConfigureCache
Modifier and Type | Optional Element and Description |
---|---|
Class<?>[] |
controllers
Specifies the controllers to test.
|
Class<?>[] |
excludeAutoConfiguration
Auto-configuration exclusions that should be applied for this test.
|
org.springframework.context.annotation.ComponentScan.Filter[] |
excludeFilters
A set of exclude filters which can be used to filter beans that would otherwise be
added to the application context.
|
org.springframework.context.annotation.ComponentScan.Filter[] |
includeFilters
A set of include filters which can be used to add otherwise filtered beans to the
application context.
|
boolean |
secure
If Spring Security's
MockMvc support should be auto-configured when it is
on the classpath. |
boolean |
useDefaultFilters
Determines if default filtering should be used with
@SpringBootApplication . |
Class<?>[] |
value
Specifies the controllers to test.
|
@AliasFor(value="controllers") public abstract Class<?>[] value
controllers()
which
can be used for brevity if no other attributes are defined. See
controllers()
for details.controllers()
public abstract boolean useDefaultFilters
@SpringBootApplication
. By default only
@Controller
(when no explicit controllers
are
defined), @ControllerAdvice
and WebMvcConfigurer
beans are
included.includeFilters()
,
excludeFilters()
public abstract org.springframework.context.annotation.ComponentScan.Filter[] includeFilters
public abstract org.springframework.context.annotation.ComponentScan.Filter[] excludeFilters
@AliasFor(annotation=AutoConfigureMockMvc.class, attribute="secure") public abstract boolean secure
MockMvc
support should be auto-configured when it is
on the classpath. Defaults to true
.@AliasFor(annotation=ImportAutoConfiguration.class, attribute="exclude") public abstract Class<?>[] excludeAutoConfiguration
Copyright © 2017 Pivotal Software, Inc.. All rights reserved.