Polishing

(cherry picked from commit 058714b)

Author: jhoeller

spring-context/src/main/java/org/springframework/context/support/ResourceBundleMessageSource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -394,6 +394,8 @@ private class MessageSourceControl extends ResourceBundle.Control {
 		@Override
 		public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload)
 				throws IllegalAccessException, InstantiationException, IOException {
+
+			// Special handling of default encoding
 			if (format.equals("java.properties")) {
 				String bundleName = toBundleName(baseName, locale);
 				final String resourceName = toResourceName(bundleName, "properties");
@@ -441,6 +443,7 @@ public InputStream run() throws IOException {
 				}
 			}
 			else {
+				// Delegate handling of "java.class" format to standard Control
 				return super.newBundle(baseName, locale, format, loader, reload);
 			}
 		}

spring-core/src/main/java/org/springframework/util/AlternativeJdkIdGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -22,11 +22,10 @@
 import java.util.UUID;
 
 /**
- * An {@link org.springframework.util.IdGenerator IdGenerator} that uses
- * {@link SecureRandom} for the initial seed and {@link Random} thereafter
- * instead of calling {@link UUID#randomUUID()} every time as
- * {@link org.springframework.util.JdkIdGenerator JdkIdGenerator} does.
- * This provides a better balance between securely random id's and performance.
+ * An {@link IdGenerator} that uses {@link SecureRandom} for the initial seed and
+ * {@link Random} thereafter, instead of calling {@link UUID#randomUUID()} every
+ * time as {@link org.springframework.util.JdkIdGenerator JdkIdGenerator} does.
+ * This provides a better balance between securely random ids and performance.
  *
  * @author Rossen Stoyanchev
  * @author Rob Winch
@@ -45,8 +44,8 @@ public AlternativeJdkIdGenerator() {
 	}
 
 
+	@Override
 	public UUID generateId() {
-
 		byte[] randomBytes = new byte[16];
 		this.random.nextBytes(randomBytes);
 

spring-core/src/main/java/org/springframework/util/JdkIdGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -19,14 +19,14 @@
 import java.util.UUID;
 
 /**
- * An IdGenerator that calls {@link java.util.UUID#randomUUID()}.
+ * An {@link IdGenerator} that calls {@link java.util.UUID#randomUUID()}.
  *
  * @author Rossen Stoyanchev
- * @since 4.2
+ * @since 4.1.5
  */
 public class JdkIdGenerator implements IdGenerator {
 
-
+	@Override
 	public UUID generateId() {
 		return UUID.randomUUID();
 	}

spring-core/src/main/java/org/springframework/util/SimpleIdGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -20,10 +20,10 @@
 import java.util.concurrent.atomic.AtomicLong;
 
 /**
- * An simple IdGenerator that starts at 1 and increments by 1 with each call.
+ * A simple {@link IdGenerator} that starts at 1 and increments by 1 with each call.
  *
  * @author Rossen Stoyanchev
- * @since 4.2
+ * @since 4.1.5
  */
 public class SimpleIdGenerator implements IdGenerator {
 

spring-messaging/src/main/java/org/springframework/messaging/handler/annotation/support/AbstractMethodArgumentResolutionException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2014 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -42,23 +42,23 @@ protected AbstractMethodArgumentResolutionException(Message<?> message, MethodPa
 
 	/**
 	 * Create a new instance providing the invalid {@code MethodParameter} and
-	 * a prepared description. Sub-classes should prepend the description with
+	 * a prepared description. Subclasses should prepend the description with
 	 * the help of {@link #getMethodParamMessage(org.springframework.core.MethodParameter)}.
 	 */
-	protected AbstractMethodArgumentResolutionException(Message<?> message,
-			MethodParameter parameter, String description) {
-
+	protected AbstractMethodArgumentResolutionException(Message<?> message, MethodParameter param, String description) {
 		super(message, description);
-		this.parameter = parameter;
+		this.parameter = param;
 	}
 
+
 	/**
 	 * Return the MethodParameter that was rejected.
 	 */
-	public MethodParameter getMethodParameter() {
+	public final MethodParameter getMethodParameter() {
 		return this.parameter;
 	}
 
+
 	protected static String getMethodParamMessage(MethodParameter param) {
 		return new StringBuilder("Could not resolve method parameter at index ")
 				.append(param.getParameterIndex()).append(" in method: ")

spring-messaging/src/main/java/org/springframework/messaging/handler/annotation/support/MethodArgumentNotValidException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2014 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -49,22 +49,21 @@ public MethodArgumentNotValidException(Message<?> message, MethodParameter param
 	public MethodArgumentNotValidException(Message<?> message, MethodParameter parameter,
 			BindingResult bindingResult) {
 
-		super(message, parameter, getMethodParamMessage(parameter) +
-				getValidationErrorMessage(parameter, bindingResult));
-
+		super(message, parameter, getMethodParamMessage(parameter) + getValidationErrorMessage(bindingResult));
 		this.bindingResult = bindingResult;
 	}
 
 
 	/**
-	 * Return the BindingResult if the failure is validation-related or {@code null}.
+	 * Return the BindingResult if the failure is validation-related,
+	 * or {@code null} if none.
 	 */
-	public BindingResult getBindingResult() {
+	public final BindingResult getBindingResult() {
 		return this.bindingResult;
 	}
 
 
-	private static String getValidationErrorMessage(MethodParameter parameter, BindingResult bindingResult) {
+	private static String getValidationErrorMessage(BindingResult bindingResult) {
 		if (bindingResult != null) {
 			StringBuilder sb = new StringBuilder();
 			sb.append(", with ").append(bindingResult.getErrorCount()).append(" error(s): ");

spring-messaging/src/main/java/org/springframework/messaging/handler/annotation/support/MethodArgumentTypeMismatchException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2014 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -29,11 +29,11 @@
 @SuppressWarnings("serial")
 public class MethodArgumentTypeMismatchException extends AbstractMethodArgumentResolutionException {
 
-
 	/**
 	 * Create a new instance with the invalid {@code MethodParameter}.
 	 */
-	public MethodArgumentTypeMismatchException(Message<?> message, MethodParameter parameter, String description) {
-		super(message, parameter, getMethodParamMessage(parameter) + description);
+	public MethodArgumentTypeMismatchException(Message<?> message, MethodParameter param, String description) {
+		super(message, param, getMethodParamMessage(param) + description);
 	}
+
 }

spring-messaging/src/main/java/org/springframework/messaging/handler/invocation/HandlerMethodArgumentResolver.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -20,8 +20,8 @@
 import org.springframework.messaging.Message;
 
 /**
- * Strategy interface for resolving method parameters into argument values in
- * the context of a given {@link Message}.
+ * Strategy interface for resolving method parameters into argument values
+ * in the context of a given {@link Message}.
  *
  * @author Rossen Stoyanchev
  * @since 4.0
@@ -39,12 +39,12 @@ public interface HandlerMethodArgumentResolver {
 
 	/**
 	 * Resolves a method parameter into an argument value from a given message.
-	 * @param parameter the method parameter to resolve. This parameter must
-	 * have previously been passed to
+	 * @param parameter the method parameter to resolve.
+	 * This parameter must have previously been passed to
 	 * {@link #supportsParameter(org.springframework.core.MethodParameter)}
-	 * and it must have returned {@code true}
+	 * which must have returned {@code true}.
 	 * @param message the currently processed message
-	 * @return the resolved argument value, or {@code null}.
+	 * @return the resolved argument value, or {@code null}
 	 * @throws Exception in case of errors with the preparation of argument values
 	 */
 	Object resolveArgument(MethodParameter parameter, Message<?> message) throws Exception;

spring-messaging/src/main/java/org/springframework/messaging/simp/broker/SimpleBrokerMessageHandler.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2014 the original author or authors.
+ * Copyright 2002-2015 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.
@@ -68,7 +68,6 @@ public SimpleBrokerMessageHandler(SubscribableChannel clientInboundChannel, Mess
 
 	/**
 	 * Configure a custom SubscriptionRegistry to use for storing subscriptions.
-	 *
 	 * <p><strong>Note</strong> that when a custom PathMatcher is configured via
 	 * {@link #setPathMatcher}, if the custom registry is not an instance of
 	 * {@link DefaultSubscriptionRegistry}, the provided PathMatcher is not used
@@ -102,17 +101,16 @@ public void setPathMatcher(PathMatcher pathMatcher) {
 	}
 
 	/**
-	 * Configure a {@link MessageHeaderInitializer} to apply to the headers of all
-	 * messages sent to the client outbound channel.
-	 *
+	 * Configure a {@link MessageHeaderInitializer} to apply to the headers
+	 * of all messages sent to the client outbound channel.
 	 * <p>By default this property is not set.
 	 */
 	public void setHeaderInitializer(MessageHeaderInitializer headerInitializer) {
 		this.headerInitializer = headerInitializer;
 	}
 
 	/**
-	 * @return the configured header initializer.
+	 * Return the configured header initializer.
 	 */
 	public MessageHeaderInitializer getHeaderInitializer() {
 		return this.headerInitializer;
@@ -131,7 +129,6 @@ public void stopInternal() {
 
 	@Override
 	protected void handleMessageInternal(Message<?> message) {
-
 		MessageHeaders headers = message.getHeaders();
 		SimpMessageType messageType = SimpMessageHeaderAccessor.getMessageType(headers);
 		String destination = SimpMessageHeaderAccessor.getDestination(headers);
@@ -197,7 +194,7 @@ private void initHeaders(SimpMessageHeaderAccessor accessor) {
 
 	protected void sendMessageToSubscribers(String destination, Message<?> message) {
 		MultiValueMap<String,String> subscriptions = this.subscriptionRegistry.findSubscriptions(message);
-		if ((subscriptions.size() > 0) && logger.isDebugEnabled()) {
+		if (!subscriptions.isEmpty() && logger.isDebugEnabled()) {
 			logger.debug("Broadcasting to " + subscriptions.size() + " sessions.");
 		}
 		for (String sessionId : subscriptions.keySet()) {

spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperBuilder.java

@@ -232,7 +232,7 @@ public Jackson2ObjectMapperBuilder deserializersByType(Map<Class<?>, JsonDeseria
 	 * @see com.fasterxml.jackson.databind.ObjectMapper#addMixInAnnotations(Class, Class)
 	 */
 	public Jackson2ObjectMapperBuilder mixIn(Class<?> target, Class<?> mixinSource) {
-		if (mixIns != null) {
+		if (mixinSource != null) {
 			this.mixIns.put(target, mixinSource);
 		}
 		return this;