批注接口 RestClientTest
@Target(TYPE)
@Retention(RUNTIME)
@Documented
@Inherited
@BootstrapWith(org.springframework.boot.test.autoconfigure.web.client.RestClientTestContextBootstrapper.class)
@ExtendWith(org.springframework.test.context.junit.jupiter.SpringExtension.class)
@OverrideAutoConfiguration(enabled=false)
@TypeExcludeFilters(RestClientTypeExcludeFilter.class)
@AutoConfigureCache
@AutoConfigureWebClient
@AutoConfigureMockRestServiceServer
@ImportAutoConfiguration
public @interface RestClientTest
Annotation for a Spring rest client test that focuses only on beans
that use
RestTemplateBuilder
or RestClient.Builder
.
Using this annotation only enables auto-configuration that is relevant to rest client tests. Similarly, component scanning is limited to beans annotated with:
@JsonComponent
as well as beans that implement:
Module
, if Jackson is available
By default, tests annotated with RestClientTest
will also auto-configure a
MockRestServiceServer
. For more fine-grained control the
@AutoConfigureMockRestServiceServer
annotation can be used.
If you are testing a bean that doesn't use RestTemplateBuilder
but instead
injects a RestTemplate
directly, you can add
@AutoConfigureWebClient(registerRestTemplate=true)
.
When using JUnit 4, this annotation should be used in combination with
@RunWith(SpringRunner.class)
.
- 从以下版本开始:
- 1.4.0
- 作者:
- Stephane Nicoll, Phillip Webb, Artsiom Yudovin
-
可选元素概要
可选元素修饰符和类型可选元素说明Class<?>[]
Specifies the components to test.Class<?>[]
Auto-configuration exclusions that should be applied for this test.A set of exclude filters which can be used to filter beans that would otherwise be added to the application context.A set of include filters which can be used to add otherwise filtered beans to the application context.String[]
Properties in form key=value that should be added to the SpringEnvironment
before the test runs.boolean
Determines if default filtering should be used with@SpringBootApplication
.Class<?>[]
Specifies the components to test.
-
元素详细资料
-
properties
String[] propertiesProperties in form key=value that should be added to the SpringEnvironment
before the test runs.- 返回:
- the properties to add
- 从以下版本开始:
- 2.1.0
- 默认值:
{}
-
value
Specifies the components to test. This is an alias ofcomponents()
which can be used for brevity if no other attributes are defined. Seecomponents()
for details.- 返回:
- the components to test
- 另请参阅:
- 默认值:
{}
-
components
Specifies the components to test. May be left blank if components will be manually imported or created directly.- 返回:
- the components to test
- 另请参阅:
- 默认值:
{}
-
useDefaultFilters
boolean useDefaultFiltersDetermines if default filtering should be used with@SpringBootApplication
. By default only@JsonComponent
andModule
beans are included.- 返回:
- if default filters should be used
- 另请参阅:
- 默认值:
true
-
includeFilters
ComponentScan.Filter[] includeFiltersA set of include filters which can be used to add otherwise filtered beans to the application context.- 返回:
- include filters to apply
- 默认值:
{}
-
excludeFilters
ComponentScan.Filter[] excludeFiltersA set of exclude filters which can be used to filter beans that would otherwise be added to the application context.- 返回:
- exclude filters to apply
- 默认值:
{}
-
excludeAutoConfiguration
@AliasFor(annotation=ImportAutoConfiguration.class, attribute="exclude") Class<?>[] excludeAutoConfigurationAuto-configuration exclusions that should be applied for this test.- 返回:
- auto-configuration exclusions to apply
- 默认值:
{}
-