From 62dbd90d46b067d6d28b7f970d735a2f9931aaad Mon Sep 17 00:00:00 2001 From: Stephane Nicoll Date: Mon, 31 Aug 2020 09:58:56 +0200 Subject: [PATCH] Document how to add auto-configurations to a test slice Closes gh-22531 --- .../src/docs/asciidoc/spring-boot-features.adoc | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc index dfdbd0f173..2405ef3048 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc @@ -7342,7 +7342,7 @@ The following example shows the `@WebServiceClientTest` annotation in use: [[boot-features-testing-spring-boot-applications-testing-auto-configured-additional-auto-config]] ==== Additional Auto-configuration and Slicing Each slice provides one or more `@AutoConfigure...` annotations that namely defines the auto-configurations that should be included as part of a slice. -Additional auto-configurations can be added by creating a custom `@AutoConfigure...` annotation or by adding `@ImportAutoConfiguration` to the test as shown in the following example: +Additional auto-configurations can be added on a test-by-test basis by creating a custom `@AutoConfigure...` annotation or by adding `@ImportAutoConfiguration` to the test as shown in the following example: [source,java,indent=0] ---- @@ -7355,6 +7355,15 @@ Additional auto-configurations can be added by creating a custom `@AutoConfigure NOTE: Make sure to not use the regular `@Import` annotation to import auto-configurations as they are handled in a specific way by Spring Boot. +Alternatively, additional auto-configurations can be added for any use of a slice annotation by registering them in `META-INF/spring.factories` as shown in the following example: + +[indent=0] +---- + org.springframework.boot.test.autoconfigure.jdbc.JdbcTest=com.example.IntegrationAutoConfiguration +---- + +TIP: A slice or `@AutoConfigure...` annotation can be customized this way as long as it is meta-annotated with `@ImportAutoConfiguration`. + [[boot-features-testing-spring-boot-applications-testing-user-configuration]]