Fixing Javadoc for JDK9

Author: derjust

pom.xml

@@ -3,7 +3,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.github.derjust</groupId>
     <artifactId>spring-data-dynamodb</artifactId>
-    <version>5.0.0-SNAPSHOT</version>
+    <version>5.0.1-SNAPSHOT</version>
     <name>Spring Data DynamoDb</name>
     <description>Spring Data module providing support for DynamoDb repositories.</description>
     <url>http://github.com/derjust/spring-data-dynamodb</url>
@@ -255,8 +255,9 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-release-plugin</artifactId>
-                <version>2.5</version>
+                <version>2.5.3</version>
                 <configuration>
+                    <tagNameFormat>v@{project.version}</tagNameFormat>
                     <autoVersionSubmodules>true</autoVersionSubmodules>
                     <useReleaseProfile>false</useReleaseProfile>
                     <releaseProfiles>release</releaseProfiles>

src/main/java/org/socialsignin/spring/data/dynamodb/core/DynamoDBOperations.java

@@ -39,6 +39,7 @@ public interface DynamoDBOperations {
     /**
      * Provides access to the DynamoDB mapper table model of the underlying domain type.
      *
+	 * @param <T> The type of the domain type itself
      * @param domainClass A domain type
      * @return Corresponding DynamoDB table model
      */

src/main/java/org/socialsignin/spring/data/dynamodb/repository/config/EnableDynamoDBRepositories.java

@@ -45,6 +45,7 @@
 	 * annotation declarations e.g.:
 	 * {@code @EnableDynamoDBRepositories("org.my.pkg")} instead of
 	 * {@code @EnableDynamoDBaRepositories(basePackages="org.my.pkg")}.
+	 * @return The package name for scanning
 	 */
 	String[] value() default {};
 
@@ -53,6 +54,7 @@
 	 * alias for (and mutually exclusive with) this attribute. Use
 	 * {@link #basePackageClasses()} for a type-safe alternative to String-based
 	 * package names.
+	 * @return The package name for scanning
 	 */
 	String[] basePackages() default {};
 
@@ -62,6 +64,7 @@
 	 * specified will be scanned. Consider creating a special no-op marker class
 	 * or interface in each package that serves no purpose other than being
 	 * referenced by this attribute.
+	 * @return The class to figure out the base package for scanning
 	 */
 	Class<?>[] basePackageClasses() default {};
 
@@ -70,21 +73,23 @@
 	 * narrows the set of candidate components from everything in
 	 * {@link #basePackages()} to everything in the base packages that matches
 	 * the given filter or filters.
+	 * @return All the include filters
 	 */
 	Filter[] includeFilters() default {};
 
 	/**
 	 * Specifies which types are not eligible for component scanning.
+	 * @return All the exclude filters
 	 */
 	Filter[] excludeFilters() default {};
 
 	/**
 	 * Returns the postfix to be used when looking up custom repository
 	 * implementations. Defaults to {@literal Impl}. So for a repository named
 	 * {@code PersonRepository} the corresponding implementation class will be
-	 * looked up scanning for {@code PersonRepositoryImpl}.
+	 * looked up scanning for {@code PersonRepositoryImpl}. Defaults to 'Impl'.
 	 *
-	 * @return
+	 * @return The implementation postfix that's used
 	 */
 	String repositoryImplementationPostfix() default "Impl";
 
@@ -93,49 +98,49 @@
 	 * properties file. Will default to
 	 * {@code META-INFO/jpa-named-queries.properties}.
 	 *
-	 * @return
+	 * @return The location itself
 	 */
 	String namedQueriesLocation() default "";
 
 	/**
 	 * Returns the key of the {@link org.springframework.data.repository.query.QueryLookupStrategy} to be used for lookup
 	 * queries for query methods. Defaults to {@link Key#CREATE_IF_NOT_FOUND}.
 	 *
-	 * @return
+	 * @return The lookup strategy
 	 */
 	Key queryLookupStrategy() default Key.CREATE_IF_NOT_FOUND;
 
 	/**
 	 * Returns the {@link org.springframework.beans.factory.FactoryBean} class to be used for each repository
 	 * instance. Defaults to {@link DynamoDBRepositoryFactoryBean}.
 	 *
-	 * @return
+	 * @return The repository factory bean cleass
 	 */
 	Class<?> repositoryFactoryBeanClass() default DynamoDBRepositoryFactoryBean.class;
 
-	// DynamoDB sepcific configuration
+	// DynamoDB specific configuration
 
 	/**
 	 * Returns the {@link com.amazonaws.services.dynamodbv2.AmazonDynamoDB } reference to be used for each
 	 * repository instance
 	 *
-	 * @return
+	 * @return The {@link com.amazonaws.services.dynamodbv2.AmazonDynamoDB} bean name
 	 */
 	String amazonDynamoDBRef() default "";
 
 	/**
 	 * Returns the {@link com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBMapperConfig } reference to be used for to
 	 * configure AmazonDynamoDB
 	 *
-	 * @return
+	 * @return The {@link com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBMapperConfig} bean name
 	 */
 	String dynamoDBMapperConfigRef() default "";
 
 	/**
 	 * Returns the {@link javax.validation.Validator } reference to be used for to
 	 * validate DynamoDB entities
 	 *
-	 * @return
+	 * @return The {@link org.socialsignin.spring.data.dynamodb.core.DynamoDBOperations} bean name
 	 */
 	String dynamoDBOperationsRef() default "";
 

src/main/java/org/socialsignin/spring/data/dynamodb/repository/query/AbstractDynamoDBQueryCriteria.java

@@ -70,7 +70,7 @@ public abstract class AbstractDynamoDBQueryCriteria<T, ID> implements DynamoDBQu
 	public abstract boolean isApplicableForLoad();
 
 	/**
-	 * @throws UnsupportedOperationException if a {@link #sort} is initalized (non-null && not {@link Sort#unsorted()}
+	 * @throws UnsupportedOperationException if a {@link #sort} is initalized (non-null &amp;&amp; not {@link Sort#unsorted()}
 	 */
 	protected void ensureNoSort() throws UnsupportedOperationException {
 		if (sort != null && sort != Sort.unsorted()) {

src/main/java/org/socialsignin/spring/data/dynamodb/repository/query/DynamoDBQueryLookupStrategy.java

@@ -154,9 +154,9 @@ protected <T, ID> RepositoryQuery createDynamoDBQuery(Method method, RepositoryM
 	 * Creates a {@link QueryLookupStrategy} for the given
 	 * {@link com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBMapper} and {@link Key}.
 	 *
-	 * @param dynamoDBOperations
-	 * @param key
-	 * @return
+	 * @param dynamoDBOperations The current operation
+	 * @param key The key of the entity
+	 * @return The created {@link QueryLookupStrategy}
 	 */
 	public static QueryLookupStrategy create(DynamoDBOperations dynamoDBOperations, Key key) {