Require spring-boot-restclient dependency to use TestRestTemplate

Previously, spring-boot-restclient was a required dependency of
spring-boot-resttestclient. This had the unwanted side-effect of
increasing the risk of the test classpath enabling auto-configuration
for RestClient.Builder when it was main code that needed such a bean.
This could lead to integration tests passing but the application
itself failing to start when its run through its main method.

This commit makes spring-boot-restclient an optional dependency of
spring-boot-resttestclient. As a result, a dependency on
spring-boot-resttestclient is no longer sufficient to auto-configure
a RestClient.Builder bean, although it is still sufficient to
auto-configure a RestTestClient bean.

Those that wish to use TestRestTemplate rather than migrating to
RestTestClient will now have to add a dependency on
spring-boot-restclient. This makes it presence more obvious. It now
has to be declared directly rather than being somewhat hidden due to
being pulled in transitively. The hope is that this will reduce the
chances of the dependency being accidentially on the test classpath
when main code requires it to be on the runtime classpath.

Fixes gh-48253

Author: wilkinsona

documentation/spring-boot-docs/src/docs/antora/modules/reference/pages/testing/spring-boot-applications.adoc

@@ -197,10 +197,14 @@ include-code::MyRandomPortWebTestClientTests[]
 
 TIP: javadoc:org.springframework.test.web.reactive.server.WebTestClient[] can also used with a xref:testing/spring-boot-applications.adoc#testing.spring-boot-applications.with-mock-environment[mock environment], removing the need for a running server, by annotating your test class with javadoc:org.springframework.boot.webflux.test.autoconfigure.AutoConfigureWebTestClient[format=annotation] from `spring-boot-webflux-test`.
 
-The `spring-boot-resttestclient` modules also provides a javadoc:org.springframework.boot.resttestclient.TestRestTemplate[] facility:
+The `spring-boot-resttestclient` module also provides a javadoc:org.springframework.boot.resttestclient.TestRestTemplate[] facility:
 
 include-code::MyRandomPortTestRestTemplateTests[]
 
+To use `TestRestTemplate` a dependency on `spring-boot-restclient` is also required.
+Take care when adding this dependency as it will enable auto-configuration for `RestClient.Builder`.
+If your main code uses `RestClient.Builder`, declare the `spring-boot-restclient` dependency so that it is on your application's main classpath and not only on its test classpath.
+
 
 
 [[testing.spring-boot-applications.customizing-rest-test-client]]

documentation/spring-boot-docs/src/docs/antora/modules/reference/pages/testing/test-utilities.adoc

@@ -44,6 +44,9 @@ include-code::MyOutputCaptureTests[]
 
 javadoc:org.springframework.boot.resttestclient.TestRestTemplate[] is a convenience alternative to Spring's javadoc:org.springframework.web.client.RestTemplate[] that is useful in integration tests.
 It's provided by the `spring-boot-resttestclient` module.
+A dependency on `spring-boot-restclient` is also required.
+Take care when adding this dependency as it will enable auto-configuration for `RestClient.Builder`.
+If your main code uses `RestClient.Builder`, declare the `spring-boot-restclient` dependency so that it is on your application's main classpath and not only on its test classpath.
 
 You can get a vanilla template or one that sends Basic HTTP authentication (with a username and password).
 In either case, the template is fault tolerant.

module/spring-boot-resttestclient/build.gradle

@@ -28,10 +28,10 @@ description = "Spring Boot RestTestClient"
 dependencies {
 	api(project(":core:spring-boot-test"))
 	api(project(":module:spring-boot-http-converter"))
-	api(project(":module:spring-boot-restclient"))
 	api("org.springframework:spring-web")
 
 	optional(project(":core:spring-boot-autoconfigure"))
+	optional(project(":module:spring-boot-restclient"))
 	optional("org.apache.httpcomponents.client5:httpclient5")
 	optional("org.jetbrains.kotlin:kotlin-stdlib")
 	optional("org.jetbrains.kotlin:kotlin-reflect")

smoke-test/spring-boot-smoke-test-actuator-custom-security/build.gradle

@@ -28,6 +28,7 @@ dependencies {
 
 	testImplementation(project(":starter:spring-boot-starter-actuator-test"))
 	testImplementation(project(":starter:spring-boot-starter-webmvc-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 
 	testRuntimeOnly("org.apache.httpcomponents.client5:httpclient5")
 }

smoke-test/spring-boot-smoke-test-actuator-extension/build.gradle

@@ -26,6 +26,7 @@ dependencies {
 
 	testImplementation(project(":starter:spring-boot-starter-actuator-test"))
 	testImplementation(project(":starter:spring-boot-starter-webmvc-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 }
 
 tasks.named("compileTestJava") {

smoke-test/spring-boot-smoke-test-actuator-ui/build.gradle

@@ -28,6 +28,7 @@ dependencies {
 
 	testImplementation(project(":starter:spring-boot-starter-actuator-test"))
 	testImplementation(project(":starter:spring-boot-starter-webmvc-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 }
 
 tasks.named("compileTestJava") {

smoke-test/spring-boot-smoke-test-actuator/build.gradle

@@ -32,6 +32,7 @@ dependencies {
 
 	testImplementation(project(":starter:spring-boot-starter-actuator-test"))
 	testImplementation(project(":starter:spring-boot-starter-webmvc-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 
 	testRuntimeOnly("org.apache.httpcomponents.client5:httpclient5")
 }

smoke-test/spring-boot-smoke-test-devtools/build.gradle

@@ -31,6 +31,7 @@ dependencies {
 	implementation(project(":starter:spring-boot-starter-webmvc"))
 
 	testImplementation(project(":starter:spring-boot-starter-webmvc-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 }
 
 tasks.named("compileTestJava") {

smoke-test/spring-boot-smoke-test-hateoas/build.gradle

@@ -24,6 +24,7 @@ dependencies {
 	implementation(project(":starter:spring-boot-starter-hateoas"))
 
 	testImplementation(project(":starter:spring-boot-starter-hateoas-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 }
 
 tasks.named("compileTestJava") {

smoke-test/spring-boot-smoke-test-jersey/build.gradle

@@ -28,4 +28,5 @@ dependencies {
 	runtimeOnly("jakarta.xml.bind:jakarta.xml.bind-api")
 
 	testImplementation(project(":starter:spring-boot-starter-jersey-test"))
+	testImplementation(project(":module:spring-boot-restclient"))
 }