Merge branch '2.2.x' into 2.3.x

Closes gh-24411

Author: philwebb

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/cloudfoundry/AccessLevel.java

@@ -38,6 +38,9 @@ public enum AccessLevel {
 	 */
 	FULL;
 
+	/**
+	 * The request attribute used to store the {@link AccessLevel}.
+	 */
 	public static final String REQUEST_ATTRIBUTE = "cloudFoundryAccessLevel";
 
 	private final List<String> ids;

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/cloudfoundry/CloudFoundryAuthorizationException.java

@@ -58,24 +58,54 @@ public Reason getReason() {
 	 */
 	public enum Reason {
 
+		/**
+		 * Access Denied.
+		 */
 		ACCESS_DENIED(HttpStatus.FORBIDDEN),
 
+		/**
+		 * Invalid Audience.
+		 */
 		INVALID_AUDIENCE(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Invalid Issuer.
+		 */
 		INVALID_ISSUER(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Invalid Key ID.
+		 */
 		INVALID_KEY_ID(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Invalid Signature.
+		 */
 		INVALID_SIGNATURE(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Invalid Token.
+		 */
 		INVALID_TOKEN(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Missing Authorization.
+		 */
 		MISSING_AUTHORIZATION(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Token Expired.
+		 */
 		TOKEN_EXPIRED(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Unsupported Token Signing Algorithm.
+		 */
 		UNSUPPORTED_TOKEN_SIGNING_ALGORITHM(HttpStatus.UNAUTHORIZED),
 
+		/**
+		 * Service Unavailable.
+		 */
 		SERVICE_UNAVAILABLE(HttpStatus.SERVICE_UNAVAILABLE);
 
 		private final HttpStatus status;

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/AutoConfigureOrder.java

@@ -48,6 +48,9 @@
 @Documented
 public @interface AutoConfigureOrder {
 
+	/**
+	 * The default order value.
+	 */
 	int DEFAULT_ORDER = 0;
 
 	/**

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/EnableAutoConfiguration.java

@@ -83,6 +83,10 @@
 @Import(AutoConfigurationImportSelector.class)
 public @interface EnableAutoConfiguration {
 
+	/**
+	 * Environment property that can be used to override when auto-configuration is
+	 * enabled.
+	 */
 	String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
 
 	/**

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/condition/ConditionMessage.java

@@ -401,23 +401,28 @@ else if (StringUtils.hasLength(this.plural)) {
 	 */
 	public enum Style {
 
+		/**
+		 * Render with normal styling.
+		 */
 		NORMAL {
+
 			@Override
 			protected Object applyToItem(Object item) {
 				return item;
 			}
 
-			@Override
-			public Collection<?> applyTo(Collection<?> items) {
-				return items;
-			}
 		},
 
+		/**
+		 * Render with the item surrounded by quotes.
+		 */
 		QUOTE {
+
 			@Override
 			protected String applyToItem(Object item) {
 				return (item != null) ? "'" + item + "'" : null;
 			}
+
 		};
 
 		public Collection<?> applyTo(Collection<?> items) {

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/web/servlet/DispatcherServletAutoConfiguration.java

@@ -69,13 +69,13 @@
 @AutoConfigureAfter(ServletWebServerFactoryAutoConfiguration.class)
 public class DispatcherServletAutoConfiguration {
 
-	/*
-	 * The bean name for a DispatcherServlet that will be mapped to the root URL "/"
+	/**
+	 * The bean name for a DispatcherServlet that will be mapped to the root URL "/".
 	 */
 	public static final String DEFAULT_DISPATCHER_SERVLET_BEAN_NAME = "dispatcherServlet";
 
-	/*
-	 * The bean name for a ServletRegistrationBean for the DispatcherServlet "/"
+	/**
+	 * The bean name for a ServletRegistrationBean for the DispatcherServlet "/".
 	 */
 	public static final String DEFAULT_DISPATCHER_SERVLET_REGISTRATION_BEAN_NAME = "dispatcherServletRegistration";
 

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/web/servlet/WebMvcAutoConfiguration.java

@@ -145,8 +145,14 @@
 		ValidationAutoConfiguration.class })
 public class WebMvcAutoConfiguration {
 
+	/**
+	 * The default Spring MVC view prefix.
+	 */
 	public static final String DEFAULT_PREFIX = "";
 
+	/**
+	 * The default Spring MVC view suffix.
+	 */
 	public static final String DEFAULT_SUFFIX = "";
 
 	private static final String[] SERVLET_LOCATIONS = { "/" };

src/checkstyle/checkstyle-suppressions.xml

@@ -15,8 +15,8 @@
 	<suppress files="[\\/]src[\\/]test[\\/]java[\\/]" checks="Javadoc*" />
 	<suppress files="[\\/]src[\\/]test[\\/]java[\\/]" id="mainCodeIllegalImportCheck" />
 	<suppress files="[\\/]src[\\/]test[\\/]java[\\/]" checks="NonEmptyAtclauseDescription" />
-	<suppress files="[\\/]autoconfigure[\\/]" checks="JavadocType" />
-	<suppress files="[\\/]autoconfigure[\\/]" checks="JavadocVariable" />
+	<suppress files="[\\/]autoconfigure[\\/].*Properties\.java" checks="JavadocType" />
+	<suppress files="[\\/]autoconfigure[\\/].*Properties\.java" checks="JavadocVariable" />
 	<suppress files="[\\/]spring-boot-docs[\\/]" checks="JavadocType" />
 	<suppress files="[\\/]spring-boot-smoke-tests[\\/]" checks="JavadocType" />
 	<suppress files="[\\/]spring-boot-smoke-tests[\\/]" checks="ImportControl" />