Add Javadocs. Fix checkstyle.

Author: OlgaMaciaszek

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

@@ -24,7 +24,10 @@
 import org.springframework.util.Assert;
 
 /**
+ * Factory bean for autoconfigured Interface Clients.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 public abstract class AbstractInterfaceClientsFactoryBean implements FactoryBean<Object>, ApplicationContextAware {
 

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

@@ -47,18 +47,21 @@
 import org.springframework.util.ObjectUtils;
 
 /**
- * Registers bean definitions for {@code HttpClient}
- * and {@code RSocketClient}-annotated Interface Clients
- * in order to automatically instantiate client beans based on those interfaces.
+ * Registers bean definitions for {@code HttpClient} and {@code RSocketClient}-annotated
+ * Interface Clients in order to automatically instantiate client beans based on those
+ * interfaces.
  *
  * @author Josh Long
  * @author Olga Maciaszek-Sharma
- * @since 3.4.1
+ * @since 3.4.0
  */
 // TODO: Handle AOT
 public abstract class AbstractInterfaceClientsImportRegistrar
 		implements ImportBeanDefinitionRegistrar, EnvironmentAware, ResourceLoaderAware {
 
+	/**
+	 * Default qualifier for user-provided beans used for creating Interface Clients.
+	 */
 	public static final String DEFAULT_INTERFACE_CLIENTS_ID = "interface-clients";
 
 	private static final String INTERFACE_CLIENT_SUFFIX = "InterfaceClient";

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

@@ -27,18 +27,21 @@
 import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
 
-import static org.springframework.boot.autoconfigure.interfaceclients.AbstractInterfaceClientsImportRegistrar.DEFAULT_INTERFACE_CLIENTS_ID;
-
 /**
- * Utility class containing methods that allow searching for beans
- * with a specific qualifier, falling back to a default qualifier.
+ * Utility class containing methods that allow searching for beans with a specific
+ * qualifier, falling back to the
+ * {@link AbstractInterfaceClientsImportRegistrar#DEFAULT_INTERFACE_CLIENTS_ID} qualifier.
  *
  * @author Josh Long
  * @author Olga Maciaszek-Sharma
- * @since 3.4.1
+ * @since 3.4.0
  */
 public final class QualifiedBeanProvider {
 
+	private QualifiedBeanProvider() {
+		throw new UnsupportedOperationException("Do not instantiate utility class");
+	}
+
 	private static final Log logger = LogFactory.getLog(QualifiedBeanProvider.class);
 
 	public static <T> T qualifiedBean(ConfigurableListableBeanFactory beanFactory, Class<T> type, String clientId) {
@@ -50,7 +53,8 @@ public static <T> T qualifiedBean(ConfigurableListableBeanFactory beanFactory, C
 			if (logger.isDebugEnabled()) {
 				logger.debug("No qualified bean of type " + type + " found for " + clientId);
 			}
-			Map<String, T> matchingDefaultBeans = getQualifiedBeansOfType(beanFactory, type, DEFAULT_INTERFACE_CLIENTS_ID);
+			Map<String, T> matchingDefaultBeans = getQualifiedBeansOfType(beanFactory, type,
+					org.springframework.boot.autoconfigure.interfaceclients.AbstractInterfaceClientsImportRegistrar.DEFAULT_INTERFACE_CLIENTS_ID);
 			if (matchingDefaultBeans.size() > 1) {
 				throw new NoUniqueBeanDefinitionException(type, matchingDefaultBeans.keySet());
 			}

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/AbstractHttpInterfaceClientsFactoryBean.java

@@ -20,12 +20,21 @@
 import org.apache.commons.logging.LogFactory;
 
 import org.springframework.boot.autoconfigure.interfaceclients.AbstractInterfaceClientsFactoryBean;
+import org.springframework.boot.autoconfigure.interfaceclients.AbstractInterfaceClientsImportRegistrar;
 import org.springframework.boot.autoconfigure.interfaceclients.QualifiedBeanProvider;
 import org.springframework.web.service.invoker.HttpExchangeAdapter;
 import org.springframework.web.service.invoker.HttpServiceProxyFactory;
 
 /**
+ * HTTP-specific {@link AbstractInterfaceClientsFactoryBean} implementation.
+ * <p>
+ * Will attempt to use an {@link HttpServiceProxyFactory} provided by the user to create
+ * an HTTP Interface Client. Beans qualified with a specific client id or
+ * {@link AbstractInterfaceClientsImportRegistrar#DEFAULT_INTERFACE_CLIENTS_ID}) will be
+ * used. If no user-provided bean is found, one with a default implementation is created.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 public abstract class AbstractHttpInterfaceClientsFactoryBean extends AbstractInterfaceClientsFactoryBean {
 

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/HttpClient.java

@@ -22,8 +22,14 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import org.springframework.web.service.annotation.HttpExchange;
+
 /**
+ * Annotation to be placed on interfaces containing {@link HttpExchange}-annotated methods
+ * in order for a client based on that interface to be autoconfigured.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 // TODO: Consider moving over to Framework.
 @Target(ElementType.TYPE)

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/HttpInterfaceClientsAutoConfiguration.java

@@ -17,6 +17,7 @@
 package org.springframework.boot.autoconfigure.interfaceclients.http;
 
 import org.springframework.boot.autoconfigure.AutoConfiguration;
+import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnWebApplication;
@@ -37,7 +38,13 @@
 import org.springframework.web.service.invoker.HttpServiceProxyFactory;
 
 /**
+ * {@link EnableAutoConfiguration Auto-configuration} for HTTP Interface Clients.
+ * <p>
+ * This will result in creation of Interface Client beans from
+ * {@link HttpClient}-annotated interfaces.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 @AutoConfiguration(after = { RestTemplateAutoConfiguration.class, RestClientAutoConfiguration.class,
 		WebClientAutoConfiguration.class })

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/HttpInterfaceClientsBaseProperties.java

@@ -17,7 +17,10 @@
 package org.springframework.boot.autoconfigure.interfaceclients.http;
 
 /**
+ * Properties for HTTP Interface Clients.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 public class HttpInterfaceClientsBaseProperties {
 

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/HttpInterfaceClientsProperties.java

@@ -22,10 +22,14 @@
 import org.springframework.boot.context.properties.ConfigurationProperties;
 
 /**
- * Use per-client properties or default if no client-specific found. Based on <a
+ * Configuration properties for HTTP Interface Clients.
+ * <p>
+ * Allows using per-client properties or default if no client-specific found. Based on <a
  * href=https://github.com/spring-cloud/spring-cloud-commons/blob/main/spring-cloud-commons/src/main/java/org/springframework/cloud/client/loadbalancer/LoadBalancerClientsProperties.java>LoadBalancerClientsProperties.java</a>
  *
+ * @author Spencer Gibb
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 @ConfigurationProperties("spring.interfaceclients.http")
 public class HttpInterfaceClientsProperties extends HttpInterfaceClientsBaseProperties {

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/RestClientInterfaceClientsFactoryBean.java

@@ -19,13 +19,24 @@
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
 
+import org.springframework.boot.autoconfigure.interfaceclients.AbstractInterfaceClientsImportRegistrar;
 import org.springframework.boot.autoconfigure.interfaceclients.QualifiedBeanProvider;
 import org.springframework.web.client.RestClient;
 import org.springframework.web.client.support.RestClientAdapter;
 import org.springframework.web.service.invoker.HttpExchangeAdapter;
 
 /**
+ * {@link RestClient}-backed {@link AbstractHttpInterfaceClientsFactoryBean}
+ * implementation.
+ * <p>
+ * Will attempt to use a {@link RestClient} or {@link RestClient.Builder} bean provided by
+ * the user to create a {@link RestClientAdapter}. Beans qualified with a specific client
+ * id or {@link AbstractInterfaceClientsImportRegistrar#DEFAULT_INTERFACE_CLIENTS_ID})
+ * will be used. If no user-provided bean is found, one with a default implementation is
+ * created.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 public class RestClientInterfaceClientsFactoryBean extends AbstractHttpInterfaceClientsFactoryBean {
 

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/interfaceclients/http/RestClientInterfaceClientsImportRegistrar.java

@@ -19,9 +19,14 @@
 import java.lang.annotation.Annotation;
 
 import org.springframework.boot.autoconfigure.interfaceclients.AbstractInterfaceClientsImportRegistrar;
+import org.springframework.web.client.RestClient;
 
 /**
+ * {@link RestClient}-backed {@link AbstractInterfaceClientsImportRegistrar}
+ * implementation.
+ *
  * @author Olga Maciaszek-Sharma
+ * @since 3.4.0
  */
 public class RestClientInterfaceClientsImportRegistrar extends AbstractInterfaceClientsImportRegistrar {