Fix Javadoc.

Fix invalid links. Replace Javadoc links to JSR-305 with code annotations.

Replace self-enclosing tags with simple ones.

See #2423

Author: mp911de

src/main/java/org/springframework/data/annotation/PersistenceConstructor.java

@@ -21,7 +21,7 @@
 import java.lang.annotation.Target;
 
 /**
- * @author Jon Brisbin <[email protected]>
+ * @author Jon Brisbin
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.CONSTRUCTOR)

src/main/java/org/springframework/data/auditing/IsNewAwareAuditingHandler.java

@@ -15,8 +15,6 @@
  */
 package org.springframework.data.auditing;
 
-import java.util.Optional;
-
 import org.springframework.data.mapping.PersistentEntity;
 import org.springframework.data.mapping.PersistentProperty;
 import org.springframework.data.mapping.context.MappingContext;
@@ -26,8 +24,8 @@
 
 /**
  * {@link AuditingHandler} extension that uses {@link PersistentEntity#isNew(Object)} to expose a generic
- * {@link #markAudited(Optional)} method that will route calls to {@link #markCreated(Optional)} or
- * {@link #markModified(Optional)} based on the {@link IsNewStrategy} determined from the factory.
+ * {@link #markAudited(Object)} method that will route calls to {@link #markCreated(Object)} or
+ * {@link #markModified(Object)} based on the {@link IsNewStrategy} determined from the factory.
  *
  * @author Oliver Gierke
  * @author Christoph Strobl
@@ -65,7 +63,7 @@ public IsNewAwareAuditingHandler(PersistentEntities entities) {
 
 	/**
 	 * Marks the given object created or modified based on {@link PersistentEntity#isNew(Object)}. Will route the calls to
-	 * {@link #markCreated(Optional)} and {@link #markModified(Optional)} accordingly.
+	 * {@link #markCreated(Object)} and {@link #markModified(Object)} accordingly.
 	 *
 	 * @param object must not be {@literal null}.
 	 */

src/main/java/org/springframework/data/domain/Sort.java

@@ -402,7 +402,7 @@ public Order(@Nullable Direction direction, String property) {
 		 *
 		 * @param direction can be {@literal null}, will default to {@link Sort#DEFAULT_DIRECTION}
 		 * @param property must not be {@literal null} or empty.
-		 * @param nullHandling must not be {@literal null}.
+		 * @param nullHandlingHint must not be {@literal null}.
 		 */
 		public Order(@Nullable Direction direction, String property, NullHandling nullHandlingHint) {
 			this(direction, property, DEFAULT_IGNORE_CASE, nullHandlingHint);

src/main/java/org/springframework/data/domain/jaxb/SpringDataJaxb.java

@@ -108,7 +108,6 @@ public static class PageDto extends RepresentationModel {
 	 * @param source
 	 * @param adapter must not be {@literal null}.
 	 * @return
-	 * @throws Exception
 	 */
 	public static <T, S> List<T> unmarshal(Collection<S> source, XmlAdapter<S, T> adapter) {
 
@@ -136,7 +135,6 @@ public static <T, S> List<T> unmarshal(Collection<S> source, XmlAdapter<S, T> ad
 	 * @param source
 	 * @param adapter must not be {@literal null}.
 	 * @return
-	 * @throws Exception
 	 */
 	public static <T, S> List<S> marshal(@Nullable Iterable<T> source, XmlAdapter<S, T> adapter) {
 

src/main/java/org/springframework/data/geo/GeoPage.java

@@ -41,7 +41,7 @@ public class GeoPage<T> extends PageImpl<GeoResult<T>> {
 	/**
 	 * Creates a new {@link GeoPage} from the given {@link GeoResults}.
 	 *
-	 * @param content must not be {@literal null}.
+	 * @param results must not be {@literal null}.
 	 */
 	public GeoPage(GeoResults<T> results) {
 

src/main/java/org/springframework/data/geo/format/DistanceFormatter.java

@@ -33,7 +33,7 @@
 /**
  * Converter to create {@link Distance} instances from {@link String} representations. The supported format is a decimal
  * followed by whitespace and a metric abbreviation. We currently support the following abbreviations:
- * {@value #SUPPORTED_METRICS}.
+ * {@link #SUPPORTED_METRICS}.
  *
  * @author Oliver Gierke
  * @author Christoph Strobl

src/main/java/org/springframework/data/history/AnnotationRevisionMetadata.java

@@ -29,7 +29,7 @@
 
 /**
  * A {@link RevisionMetadata} implementation that inspects the given object for fields with the configured annotations
- * and returns the field's values on calls to {@link #getRevisionDate()}, {@link #getRevisionInstant()} and
+ * and returns the field's values on calls to {@link #getRevisionInstant()}, {@link #getRevisionInstant()} and
  * {@link #getRevisionNumber()}.
  *
  * @author Oliver Gierke

src/main/java/org/springframework/data/mapping/Alias.java

@@ -22,10 +22,10 @@
 /**
  * A container object which may or may not contain a type alias value. If a value is present, {@code isPresent()} will
  * return {@code true} and {@link #getValue()} will return the value.
- * <p/>
+ * <p>
  * Additional methods that depend on the presence or absence of a contained value are provided, such as
  * {@link #hasValue(Object)} or {@link #isPresent()}
- * <p/>
+ * <p>
  * Aliases are immutable once created.
  *
  * @author Oliver Gierke

src/main/java/org/springframework/data/mapping/Association.java

@@ -21,7 +21,7 @@
  * Value object to capture {@link Association}s.
  *
  * @param <P> {@link PersistentProperty}s the association connects.
- * @author Jon Brisbin <[email protected]>
+ * @author Jon Brisbin
  * @author Mark Paluch
  */
 public class Association<P extends PersistentProperty<P>> {

src/main/java/org/springframework/data/mapping/AssociationHandler.java

@@ -18,7 +18,7 @@
 /**
  * Callback interface to implement functionality to be applied to a collection of {@link Association}s.
  *
- * @author Jon Brisbin <[email protected]>
+ * @author Jon Brisbin
  * @author Oliver Gierke
  */
 public interface AssociationHandler<P extends PersistentProperty<P>> {