Merge branch '5.1.x'

Author: jhoeller

spring-core/src/main/java/org/springframework/core/log/LogDelegateFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2019 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.
@@ -44,15 +44,15 @@ private LogDelegateFactory() {
 	/**
 	 * Create a composite logger that delegates to a primary or falls back on a
 	 * secondary logger if logging for the primary logger is not enabled.
-	 * <p>This may be used for fallback logging from lower level packages that
-	 * logically should log together with some higher level package but the two
+	 * <p>This may be used for fallback logging from lower-level packages that
+	 * logically should log together with some higher-level package but the two
 	 * don't happen to share a suitable parent package (e.g. logging for the web
-	 * and lower level http and codec packages). For such cases the primary,
-	 * class-based logger can be wrapped with a shared fallback logger.
+	 * and lower-level http and codec packages). For such cases the primary
+	 * (class-based) logger can be wrapped with a shared fallback logger.
 	 * @param primaryLogger primary logger to try first
 	 * @param secondaryLogger secondary logger
-	 * @param tertiaryLoggers optionally, more fallback loggers
-	 * @return the resulting logger to use
+	 * @param tertiaryLoggers optional vararg of further fallback loggers
+	 * @return the resulting composite logger for the related categories
 	 */
 	public static Log getCompositeLog(Log primaryLogger, Log secondaryLogger, Log... tertiaryLoggers) {
 		List<Log> loggers = new ArrayList<>(2 + tertiaryLoggers.length);
@@ -68,7 +68,7 @@ public static Log getCompositeLog(Log primaryLogger, Log secondaryLogger, Log...
 	 * or unnecessary to see at any log level by default under the normal package
 	 * based log hierarchy.
 	 * @param clazz the class for which to create a logger
-	 * @return the created logger
+	 * @return a logger for the hidden category ("_" + fully-qualified class name)
 	 */
 	public static Log getHiddenLog(Class<?> clazz) {
 		return LogFactory.getLog("_" + clazz.getName());

spring-webflux/src/main/java/org/springframework/web/reactive/result/method/annotation/ControllerMethodResolver.java

@@ -55,8 +55,9 @@
 /**
  * Package-private class to assist {@link RequestMappingHandlerAdapter} with
  * resolving, initializing, and caching annotated methods declared in
- * {@code @Controller} and {@code @ControllerAdvice} components. Assists with
- * the following annotations:
+ * {@code @Controller} and {@code @ControllerAdvice} components.
+ *
+ * <p>Assists with the following annotations:
  * <ul>
  * <li>{@code @InitBinder}
  * <li>{@code @ModelAttribute}
@@ -340,7 +341,6 @@ private InvocableHandlerMethod createAttributeMethod(Object bean, Method method)
 	 */
 	@Nullable
 	public InvocableHandlerMethod getExceptionHandlerMethod(Throwable ex, HandlerMethod handlerMethod) {
-
 		Class<?> handlerType = handlerMethod.getBeanType();
 
 		// Controller-local first...