Polishing

Author: jhoeller

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

@@ -449,8 +449,9 @@ interface Builder {
 		Builder responseTimeout(Duration timeout);
 
 		/**
-		 * Apply the given {@code Consumer} to this builder instance.
+		 * Apply the given configurer to this builder instance.
 		 * <p>This can be useful for applying pre-packaged customizations.
+		 * @param configurer the configurer to apply
 		 */
 		Builder apply(WebTestClientConfigurer configurer);
 

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2017 the original author or authors.
+ * Copyright 2002-2018 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -657,7 +657,7 @@ <T> ResponseEntity<T> exchange(RequestEntity<?> requestEntity, ParameterizedType
 			throws RestClientException;
 
 
-	// general execution
+	// General execution
 
 	/**
 	 * Execute the HTTP method to the given URI template, preparing the request with the

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

@@ -193,7 +193,7 @@ public RestTemplate(ClientHttpRequestFactory requestFactory) {
 	/**
 	 * Create a new instance of the {@link RestTemplate} using the given list of
 	 * {@link HttpMessageConverter} to use.
-	 * @param messageConverters the list of {@link HttpMessageConverter} to use.
+	 * @param messageConverters the list of {@link HttpMessageConverter} to use
 	 * @since 3.2.7
 	 */
 	public RestTemplate(List<HttpMessageConverter<?>> messageConverters) {
@@ -204,7 +204,7 @@ public RestTemplate(List<HttpMessageConverter<?>> messageConverters) {
 
 	private static DefaultUriBuilderFactory initUriTemplateHandler() {
 		DefaultUriBuilderFactory uriFactory = new DefaultUriBuilderFactory();
-		uriFactory.setEncodingMode(EncodingMode.URI_COMPONENT); // for backwards compatibility..
+		uriFactory.setEncodingMode(EncodingMode.URI_COMPONENT);  // for backwards compatibility..
 		return uriFactory;
 	}
 
@@ -279,13 +279,11 @@ else if (this.uriTemplateHandler instanceof org.springframework.web.util.Abstrac
 	 * backwards compatibility, the encoding mode is set to
 	 * {@link EncodingMode#URI_COMPONENT URI_COMPONENT}. As of 5.0.8, prefer
 	 * using {@link EncodingMode#TEMPLATE_AND_VALUES TEMPLATE_AND_VALUES}.
-	 *
 	 * <p><strong>Note:</strong> in 5.0 the switch from
 	 * {@link org.springframework.web.util.DefaultUriTemplateHandler
 	 * DefaultUriTemplateHandler} (deprecated in 4.3), as the default to use, to
 	 * {@link DefaultUriBuilderFactory} brings in a different default for the
 	 * {@code parsePath} property (switching from false to true).
-	 *
 	 * @param handler the URI template handler to use
 	 */
 	public void setUriTemplateHandler(UriTemplateHandler handler) {
@@ -649,7 +647,7 @@ public <T> ResponseEntity<T> exchange(RequestEntity<?> requestEntity, Parameteri
 	}
 
 
-	// general execution
+	// General execution
 
 	/**
 	 * {@inheritDoc}
@@ -817,7 +815,7 @@ public <T> ResponseExtractor<ResponseEntity<T>> responseEntityExtractor(Type res
 	}
 
 	/**
-	 * Returns a response extractor for {@link HttpHeaders}.
+	 * Return a response extractor for {@link HttpHeaders}.
 	 */
 	protected ResponseExtractor<HttpHeaders> headersExtractor() {
 		return this.headersExtractor;

spring-webflux/src/main/java/org/springframework/web/reactive/function/server/ServerRequest.java

@@ -85,12 +85,10 @@ default HttpMethod method() {
 	/**
 	 * Return a {@code UriBuilderComponents}  from the URI associated with this
 	 * {@code ServerRequest}.
-	 *
 	 * <p><strong>Note:</strong> as of 5.1 this method ignores
 	 * {@code "Forwarded"} and {@code "X-Forwarded-*"} headers that specify the
 	 * client-originated address. Consider using the {@code ForwardedHeaderFilter}
 	 * to extract and use, or to discard such headers.
-	 *
 	 * @return a URI builder
 	 */
 	UriBuilder uriBuilder();