Fix warnings, polish Javadoc for @validated et al.

Author: cbeams

org.springframework.context/src/main/java/org/springframework/validation/SmartValidator.java

@@ -26,19 +26,18 @@
 public interface SmartValidator extends Validator {
 
 	/**
-	 * Validate the supplied <code>target</code> object, which must be
-	 * of a {@link Class} for which the {@link #supports(Class)} method
-	 * typically has (or would) return <code>true</code>.
-	 * <p>The supplied {@link Errors errors} instance can be used to report
-	 * any resulting validation errors.
-	 * <p><b>This variant of <code>validate</code> supports validation hints,
-	 * such as validation groups against a JSR-303 provider</b> (in this case,
-	 * the provided hint objects need to be annotation arguments of type Class).
-	 * <p>Note: Validation hints may get ignored by the actual target Validator,
+	 * Validate the supplied {@code target} object, which must be of a {@link Class} for
+	 * which the {@link #supports(Class)} method typically has (or would) return {@code true}.
+	 * <p>The supplied {@link Errors errors} instance can be used to report any
+	 * resulting validation errors.
+	 * <p><b>This variant of {@code validate} supports validation hints, such as
+	 * validation groups against a JSR-303 provider</b> (in this case, the provided hint
+	 * objects need to be annotation arguments of type {@code Class}).
+	 * <p>Note: Validation hints may get ignored by the actual target {@code Validator},
 	 * in which case this method is supposed to be behave just like its regular
 	 * {@link #validate(Object, Errors)} sibling.
-	 * @param target the object that is to be validated (can be <code>null</code>)
-	 * @param errors contextual state about the validation process (never <code>null</code>)
+	 * @param target the object that is to be validated (can be {@code null})
+	 * @param errors contextual state about the validation process (never {@code null})
 	 * @param validationHints one or more hint objects to be passed to the validation engine
 	 * @see ValidationUtils
 	 */

org.springframework.context/src/main/java/org/springframework/validation/annotation/Validated.java

@@ -58,6 +58,6 @@
 	 * <p>Other {@link org.springframework.validation.SmartValidator} implementations may
 	 * support class arguments in other ways as well.
 	 */
-	Class[] value() default {};
+	Class<?>[] value() default {};
 
 }

org.springframework.context/src/main/java/org/springframework/validation/beanvalidation/MethodValidationPostProcessor.java

@@ -46,13 +46,15 @@
  *
  * <p>Applicable methods have JSR-303 constraint annotations on their parameters
  * and/or on their return value (in the latter case specified at the method level,
- * typically as inline annotation).
+ * typically as inline annotation), e.g.:
  *
- * <p>E.g.: <code>public @NotNull Object myValidMethod(@NotNull String arg1, @Max(10) int arg2)</code>
+ * <pre class="code">
+ * public @NotNull Object myValidMethod(@NotNull String arg1, @Max(10) int arg2)
+ * </pre>
  *
  * <p>Target classes with such annotated methods need to be annotated with Spring's
  * {@link Validated} annotation at the type level, for their methods to be searched for
- * inline constraint annotations. Validation groups can be specified through {@link Validated}
+ * inline constraint annotations. Validation groups can be specified through {@code @Validated}
  * as well. By default, JSR-303 will validate against its default group only.
  *
  * <p>As of Spring 3.1, this functionality requires Hibernate Validator 4.2 or higher.
@@ -64,6 +66,7 @@
  * @see MethodValidationInterceptor
  * @see org.hibernate.validator.method.MethodValidator
  */
+@SuppressWarnings("serial")
 public class MethodValidationPostProcessor extends ProxyConfig
 		implements BeanPostProcessor, BeanClassLoaderAware, Ordered, InitializingBean {