Add exchangeSuccessfully to test clients

Closes gh-35582

Author: rstoyanchev

spring-test/src/main/java/org/springframework/test/web/reactive/server/DefaultWebTestClient.java

@@ -381,6 +381,11 @@ public ResponseSpec exchange() {
 					DefaultWebTestClient.this.entityResultConsumer, getResponseTimeout());
 		}
 
+		@Override
+		public ResponseSpec exchangeSuccessfully() {
+			return exchange().expectStatus().is2xxSuccessful();
+		}
+
 		private ClientRequest.Builder initRequestBuilder() {
 			return ClientRequest.create(this.httpMethod, initUri())
 					.headers(headersToUse -> {

spring-test/src/main/java/org/springframework/test/web/reactive/server/WebTestClient.java

@@ -700,10 +700,21 @@ interface RequestHeadersSpec<S extends RequestHeadersSpec<S>> {
 		S attributes(Consumer<Map<String, Object>> attributesConsumer);
 
 		/**
-		 * Perform the exchange without a request body.
-		 * @return a spec for decoding the response
+		 * Perform the exchange.
+		 * @return a spec for expectations on the response
 		 */
 		ResponseSpec exchange();
+
+		/**
+		 * Variant of {@link #exchange()} that expects a successful response.
+		 * Effectively, a shortcut for:
+		 * <pre class="code">
+		 * exchange().is2xxSuccessful()
+		 * </pre>
+		 * @return a spec for expectations on the response
+		 * @since 7.0
+		 */
+		ResponseSpec exchangeSuccessfully();
 	}
 
 

spring-test/src/main/java/org/springframework/test/web/servlet/client/DefaultRestTestClient.java

@@ -269,6 +269,11 @@ public ResponseSpec exchange() {
 							}, false),
 					DefaultRestTestClient.this.entityResultConsumer);
 		}
+
+		@Override
+		public ResponseSpec exchangeSuccessfully() {
+			return exchange().expectStatus().is2xxSuccessful();
+		}
 	}
 
 

spring-test/src/main/java/org/springframework/test/web/servlet/client/RestTestClient.java

@@ -514,10 +514,20 @@ interface RequestHeadersSpec<S extends RequestHeadersSpec<S>> {
 		S attributes(Consumer<Map<String, Object>> attributesConsumer);
 
 		/**
-		 * Perform the exchange without a request body.
-		 * @return a spec for decoding the response
+		 * Perform the exchange.
+		 * @return a spec for expectations on the response
 		 */
 		ResponseSpec exchange();
+
+		/**
+		 * Variant of {@link #exchange()} that expects a successful response.
+		 * Effectively, a shortcut for:
+		 * <pre class="code">
+		 * exchange().is2xxSuccessful()
+		 * </pre>
+		 * @return a spec for expectations on the response
+		 */
+		ResponseSpec exchangeSuccessfully();
 	}