DATAJDBC-267 - Polishing.

Add author tags. Extend Javadoc. Original pull request: spring-projects#89.

Author: mp911de

src/main/java/org/springframework/data/jdbc/repository/config/JdbcConfiguration.java

@@ -20,7 +20,6 @@
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.core.convert.converter.Converter;
-import org.springframework.data.convert.CustomConversions;
 import org.springframework.data.jdbc.core.convert.JdbcCustomConversions;
 import org.springframework.data.relational.core.conversion.BasicRelationalConverter;
 import org.springframework.data.relational.core.conversion.RelationalConverter;
@@ -34,10 +33,17 @@
  * @author Jens Schauder
  * @author Mark Paluch
  * @author Michael Simons
+ * @author Christoph Strobl
  */
 @Configuration
 public class JdbcConfiguration {
 
+/**
+ * Register a {@link RelationalMappingContext} and apply an optional {@link NamingStrategy}.
+ *
+ * @param namingStrategy optional {@link NamingStrategy}. Use {@link NamingStrategy#INSTANCE} as fallback.
+ * @return must not be {@literal null}.
+ */
 @Bean
 protected RelationalMappingContext jdbcMappingContext(Optional<NamingStrategy> namingStrategy) {
 
@@ -48,16 +54,23 @@ protected RelationalMappingContext jdbcMappingContext(Optional<NamingStrategy> n
 return mappingContext;
 }
 
+/**
+ * Creates a {@link RelationalConverter} using the configured {@link #jdbcMappingContext(Optional)}. Will get
+ * {@link #jdbcCustomConversions()} applied.
+ *
+ * @see #jdbcMappingContext(Optional)
+ * @see #jdbcCustomConversions()
+ * @return must not be {@literal null}.
+ */
 @Bean
 protected RelationalConverter relationalConverter(RelationalMappingContext mappingContext) {
 return new BasicRelationalConverter(mappingContext, jdbcCustomConversions());
 }
 
 /**
- * Register custom {@link Converter}s in a {@link CustomConversions} object if required. These
- * {@link CustomConversions} will be registered with the
- * {@link #relationalConverter(RelationalMappingContext)}. Returns an empty
- * {@link JdbcCustomConversions} instance by default.
+ * Register custom {@link Converter}s in a {@link JdbcCustomConversions} object if required. These
+ * {@link JdbcCustomConversions} will be registered with the {@link #relationalConverter(RelationalMappingContext)}.
+ * Returns an empty {@link JdbcCustomConversions} instance by default.
  *
  * @return must not be {@literal null}.
  */