Add createException to ConvertibleClientHttpResponse

Closes spring-projectsgh-35391

Author: rstoyanchev

spring-web/src/main/java/org/springframework/web/client/DefaultRestClient.java

@@ -961,6 +961,11 @@ public void close() {
 			Class<T> bodyClass = bodyClass(type);
 			return readWithMessageConverters(this.delegate, () -> {}, type, bodyClass, this.hints);
 		}
+
+		@Override
+		public RestClientResponseException createException() throws IOException {
+			return StatusHandler.createException(this, DefaultRestClient.this.messageConverters);
+		}
 	}
 
 }

spring-web/src/main/java/org/springframework/web/client/RestClient.java

@@ -878,6 +878,15 @@ interface ConvertibleClientHttpResponse extends ClientHttpResponse {
 			 * @return the body, or {@code null} if no response body was available
 			 */
 			<T> @Nullable T bodyTo(ParameterizedTypeReference<T> bodyType);
+
+			/**
+			 * Create a {@link RestClientResponseException} of the appropriate
+			 * subtype depending on the response status code. The exception contains
+			 * the status, headers, and body of the response.
+			 * @throws IOException in case of a response failure (e.g. to obtain the status)
+			 * @since 7.0
+			 */
+			RestClientResponseException createException() throws IOException;
 		}
 	}
 

spring-web/src/main/java/org/springframework/web/client/StatusHandler.java

@@ -108,7 +108,16 @@ public static StatusHandler createDefaultStatusHandler(List<HttpMessageConverter
 				});
 	}
 
-	private static RestClientResponseException createException(
+	/**
+	 * Create a {@link RestClientResponseException} of the appropriate
+	 * subtype depending on the response status code.
+	 * @param response the response
+	 * @param converters the converters to use to decode the body
+	 * @return the created exception
+	 * @throws IOException in case of a response failure (e.g. to obtain the status)
+	 * @since 7.0
+	 */
+	public static RestClientResponseException createException(
 			ClientHttpResponse response, List<HttpMessageConverter<?>> converters) throws IOException {
 
 		HttpStatusCode statusCode = response.getStatusCode();