Polishing

Author: jhoeller

spring-context/src/main/java/org/springframework/cache/interceptor/CacheAspectSupport.java

@@ -777,4 +777,5 @@ public int hashCode() {
 			return (this.cacheOperation.hashCode() * 31 + this.methodCacheKey.hashCode());
 		}
 	}
+
 }

spring-context/src/main/java/org/springframework/context/expression/AnnotatedElementKey.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -27,7 +27,7 @@
  *
  * @author Costin Leau
  * @author Stephane Nicoll
- * @since 4.2.0
+ * @since 4.2
  * @see CachedExpressionEvaluator
  */
 public final class AnnotatedElementKey {
@@ -36,12 +36,13 @@ public final class AnnotatedElementKey {
 
 	private final Class<?> targetClass;
 
+
 	/**
 	 * Create a new instance with the specified {@link AnnotatedElement} and
 	 * optional target {@link Class}.
 	 */
 	public AnnotatedElementKey(AnnotatedElement element, Class<?> targetClass) {
-		Assert.notNull(element, "AnnotatedElement must be set.");
+		Assert.notNull(element, "AnnotatedElement must not be null");
 		this.element = element;
 		this.targetClass = targetClass;
 	}

spring-context/src/main/java/org/springframework/context/expression/CachedExpressionEvaluator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -28,13 +28,14 @@
  * are defined on {@link java.lang.reflect.AnnotatedElement}.
  *
  * @author Stephane Nicoll
- * @since 4.2.0
+ * @since 4.2
  * @see AnnotatedElementKey
  */
 public abstract class CachedExpressionEvaluator {
 
 	private final SpelExpressionParser parser;
 
+
 	/**
 	 * Create a new instance with the specified {@link SpelExpressionParser}.
 	 */
@@ -50,13 +51,15 @@ protected CachedExpressionEvaluator() {
 		this(new SpelExpressionParser());
 	}
 
+
 	/**
 	 * Return the {@link SpelExpressionParser} to use.
 	 */
 	protected SpelExpressionParser getParser() {
 		return this.parser;
 	}
 
+
 	/**
 	 * Return the {@link Expression} for the specified SpEL value
 	 * <p>Parse the expression if it hasn't been already.
@@ -66,6 +69,7 @@ protected SpelExpressionParser getParser() {
 	 */
 	protected Expression getExpression(Map<ExpressionKey, Expression> cache,
 			AnnotatedElementKey elementKey, String expression) {
+
 		ExpressionKey expressionKey = createKey(elementKey, expression);
 		Expression expr = cache.get(expressionKey);
 		if (expr == null) {
@@ -79,6 +83,7 @@ private ExpressionKey createKey(AnnotatedElementKey elementKey, String expressio
 		return new ExpressionKey(elementKey, expression);
 	}
 
+
 	protected static class ExpressionKey {
 
 		private final AnnotatedElementKey key;
@@ -105,7 +110,7 @@ public boolean equals(Object other) {
 
 		@Override
 		public int hashCode() {
-			return this.key.hashCode() * 29 + (this.expression != null ? this.expression.hashCode() : 0);
+			return this.key.hashCode() + (this.expression != null ? this.expression.hashCode() * 29 : 0);
 		}
 	}
 

spring-context/src/main/java/org/springframework/context/expression/MethodBasedEvaluationContext.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -25,16 +25,16 @@
 /**
  * A method-based {@link org.springframework.expression.EvaluationContext} that
  * provides explicit support for method-based invocations.
- * <p>
- * Expose the actual method arguments using the following aliases:
+ *
+ * <p>Expose the actual method arguments using the following aliases:
  * <ol>
  * <li>pX where X is the index of the argument (p0 for the first argument)</li>
  * <li>aX where X is the index of the argument (a1 for the second argument)</li>
  * <li>the name of the parameter as discovered by a configurable {@link ParameterNameDiscoverer}</li>
  * </ol>
  *
  * @author Stephane Nicoll
- * @since 4.2.0
+ * @since 4.2
  */
 public class MethodBasedEvaluationContext extends StandardEvaluationContext {
 
@@ -46,6 +46,7 @@ public class MethodBasedEvaluationContext extends StandardEvaluationContext {
 
 	private boolean paramLoaded = false;
 
+
 	public MethodBasedEvaluationContext(Object rootObject, Method method, Object[] args,
 			ParameterNameDiscoverer paramDiscoverer) {
 
@@ -55,6 +56,7 @@ public MethodBasedEvaluationContext(Object rootObject, Method method, Object[] a
 		this.paramDiscoverer = paramDiscoverer;
 	}
 
+
 	@Override
 	public Object lookupVariable(String name) {
 		Object variable = super.lookupVariable(name);

spring-test/src/main/java/org/springframework/test/web/servlet/result/JsonPathResultMatchers.java

@@ -47,6 +47,7 @@ public class JsonPathResultMatchers {
 
 	private String prefix;
 
+
 	/**
 	 * Protected constructor.
 	 * <p>Use {@link MockMvcResultMatchers#jsonPath(String, Object...)} or
@@ -65,7 +66,7 @@ protected JsonPathResultMatchers(String expression, Object... args) {
 	 * <p>Use this method if the JSON payloads are prefixed to avoid
 	 * Cross Site Script Inclusion (XSSI) attacks.
 	 * @param prefix the string prefix prepended to the actual JSON payload
-	 * @since 4.3.0
+	 * @since 4.3
 	 */
 	public JsonPathResultMatchers prefix(String prefix) {
 		this.prefix = prefix;
@@ -252,14 +253,14 @@ private String getContent(MvcResult result) throws UnsupportedEncodingException
 		String content = result.getResponse().getContentAsString();
 		if (StringUtils.hasLength(this.prefix)) {
 			try {
-				String reason = String.format("Expected a JSON payload prefixed with \"%s\" but found: %s", this.prefix,
-						StringUtils.quote(content.substring(0, this.prefix.length())));
+				String reason = String.format("Expected a JSON payload prefixed with \"%s\" but found: %s",
+						this.prefix, StringUtils.quote(content.substring(0, this.prefix.length())));
 				MatcherAssert.assertThat(reason, content, StringStartsWith.startsWith(this.prefix));
 				return content.substring(this.prefix.length());
 			}
 			catch (StringIndexOutOfBoundsException oobe) {
-				String message = "JSON prefix \"" + this.prefix + "\" not found, exception: ";
-				throw new AssertionError(message + oobe.getMessage());
+				throw new AssertionError(
+						"JSON prefix \"" + this.prefix + "\" not found, exception: " + oobe.getMessage());
 			}
 		}
 		else {

spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/ResponseEntityExceptionHandler.java

@@ -71,26 +71,28 @@
  *
  * @author Rossen Stoyanchev
  * @since 3.2
- *
  * @see #handleException(Exception, WebRequest)
  * @see org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver
  */
 public abstract class ResponseEntityExceptionHandler {
 
-	protected final Log logger = LogFactory.getLog(getClass());
-
 	/**
 	 * Log category to use when no mapped handler is found for a request.
 	 * @see #pageNotFoundLogger
 	 */
 	public static final String PAGE_NOT_FOUND_LOG_CATEGORY = "org.springframework.web.servlet.PageNotFound";
 
 	/**
-	 * Additional logger to use when no mapped handler is found for a request.
+	 * Specific logger to use when no mapped handler is found for a request.
 	 * @see #PAGE_NOT_FOUND_LOG_CATEGORY
 	 */
 	protected static final Log pageNotFoundLogger = LogFactory.getLog(PAGE_NOT_FOUND_LOG_CATEGORY);
 
+	/**
+	 * Common logger for use in subclasses.
+	 */
+	protected final Log logger = LogFactory.getLog(getClass());
+
 
 	/**
 	 * Provides handling for standard Spring MVC exceptions.
@@ -115,9 +117,7 @@ public abstract class ResponseEntityExceptionHandler {
 			NoHandlerFoundException.class
 		})
 	public final ResponseEntity<Object> handleException(Exception ex, WebRequest request) {
-
 		HttpHeaders headers = new HttpHeaders();
-
 		if (ex instanceof NoSuchRequestHandlingMethodException) {
 			HttpStatus status = HttpStatus.NOT_FOUND;
 			return handleNoSuchRequestHandlingMethod((NoSuchRequestHandlingMethodException) ex, headers, status, request);
@@ -202,7 +202,6 @@ protected ResponseEntity<Object> handleExceptionInternal(Exception ex, Object bo
 		if (HttpStatus.INTERNAL_SERVER_ERROR.equals(status)) {
 			request.setAttribute(WebUtils.ERROR_EXCEPTION_ATTRIBUTE, ex, WebRequest.SCOPE_REQUEST);
 		}
-
 		return new ResponseEntity<Object>(body, headers, status);
 	}
 
@@ -242,7 +241,6 @@ protected ResponseEntity<Object> handleHttpRequestMethodNotSupported(HttpRequest
 		if (!supportedMethods.isEmpty()) {
 			headers.setAllow(supportedMethods);
 		}
-
 		return handleExceptionInternal(ex, null, headers, status, request);
 	}
 
@@ -443,8 +441,8 @@ protected ResponseEntity<Object> handleBindException(BindException ex, HttpHeade
 	 * @return a {@code ResponseEntity} instance
 	 * @since 4.0
 	 */
-	protected ResponseEntity<Object> handleNoHandlerFoundException(NoHandlerFoundException ex, HttpHeaders headers,
-	                                                     HttpStatus status, WebRequest request) {
+	protected ResponseEntity<Object> handleNoHandlerFoundException(
+			NoHandlerFoundException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {
 
 		return handleExceptionInternal(ex, null, headers, status, request);
 	}

spring-webmvc/src/main/java/org/springframework/web/servlet/resource/ResourceHttpRequestHandler.java

@@ -162,7 +162,7 @@ public List<ResourceTransformer> getResourceTransformers() {
 	/**
 	 * Configure the {@link ResourceHttpMessageConverter} to use.
 	 * <p>By default a {@link ResourceHttpMessageConverter} will be configured.
-	 * @since 4.3.0
+	 * @since 4.3
 	 */
 	public void setResourceHttpMessageConverter(ResourceHttpMessageConverter resourceHttpMessageConverter) {
 		this.resourceHttpMessageConverter = resourceHttpMessageConverter;
@@ -172,7 +172,6 @@ public ResourceHttpMessageConverter getResourceHttpMessageConverter() {
 		return this.resourceHttpMessageConverter;
 	}
 
-
 	/**
 	 * Configure a {@code ContentNegotiationManager} to determine the media types
 	 * for resources being served. If the manager contains a path
@@ -185,7 +184,7 @@ public ResourceHttpMessageConverter getResourceHttpMessageConverter() {
 	 * settings is used to create the manager. See the Javadoc of
 	 * {@code ContentNegotiationManagerFactoryBean} for details
 	 * @param contentNegotiationManager the manager to use
-	 * @since 4.3.0
+	 * @since 4.3
 	 */
 	public void setContentNegotiationManager(ContentNegotiationManager contentNegotiationManager) {
 		this.contentNegotiationManager = contentNegotiationManager;
@@ -335,10 +334,7 @@ public void handleRequest(HttpServletRequest request, HttpServletResponse respon
 				this.resourceHttpMessageConverter.write(rangeResource, mediaType, outputMessage);
 			}
 			catch (IllegalArgumentException ex) {
-				Long contentLength = resource.contentLength();
-				if (contentLength != null) {
-					response.addHeader("Content-Range", "bytes */" + resource.contentLength());
-				}
+				response.addHeader("Content-Range", "bytes */" + resource.contentLength());
 				response.sendError(HttpServletResponse.SC_REQUESTED_RANGE_NOT_SATISFIABLE);
 			}
 		}
@@ -468,7 +464,6 @@ protected boolean isInvalidPath(String path) {
 	 */
 	@SuppressWarnings("deprecation")
 	protected MediaType getMediaType(HttpServletRequest request, Resource resource) {
-
 		// For backwards compatibility
 		MediaType mediaType = getMediaType(resource);
 		if (mediaType != null) {
@@ -535,6 +530,7 @@ protected void setHeaders(HttpServletResponse response, Resource resource, Media
 		response.setHeader(HttpHeaders.ACCEPT_RANGES, "bytes");
 	}
 
+
 	@Override
 	public String toString() {
 		return "ResourceHttpRequestHandler [locations=" + getLocations() + ", resolvers=" + getResourceResolvers() + "]";