Polish SmartValidator and SpringValidatorAdapter

sbrannen · cbeams · commit c8e693b878a4 · 2012-05-28T11:08:25.000+03:00
- Improve wording &amp; grammar in SmartValidator Javadoc
 - Suppress 'rawtypes' warnings in SpringValidatorAdapter
diff --git a/spring-context/src/main/java/org/springframework/validation/SmartValidator.java b/spring-context/src/main/java/org/springframework/validation/SmartValidator.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2011 the original author or authors.
+ * Copyright 2002-2012 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,20 +21,21 @@
  * validation 'hints'.
  *
  * @author Juergen Hoeller
+ * @author Sam Brannen
  * @since 3.1
  */
 public interface SmartValidator extends 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}.
+	 * Validate the supplied {@code target} object, which must be of a type of {@link Class}
+	 * for which the {@link #supports(Class)} method typically returns {@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
+	 * <p><b>This variant of {@code validate()} supports validation hints, such as
+	 * validation groups against a JSR-303 provider</b> (in which 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
+	 * in which case this method should behave just like its regular
 	 * {@link #validate(Object, Errors)} sibling.
 	 * @param target the object that is to be validated (can be {@code null})
 	 * @param errors contextual state about the validation process (never {@code null})
diff --git a/spring-context/src/main/java/org/springframework/validation/beanvalidation/SpringValidatorAdapter.java b/spring-context/src/main/java/org/springframework/validation/beanvalidation/SpringValidatorAdapter.java
@@ -89,6 +89,7 @@ public void validate(Object target, Errors errors) {
 		processConstraintViolations(this.targetValidator.validate(target), errors);
 	}
 
+	@SuppressWarnings("rawtypes")
 	public void validate(Object target, Errors errors, Object... validationHints) {
 		Set<Class> groups = new LinkedHashSet<Class>();
 		if (validationHints != null) {

Original file line number	Diff line number	Diff line change
`@@ -89,6 +89,7 @@ public void validate(Object target, Errors errors) {`
`89`	`89`	`processConstraintViolations(this.targetValidator.validate(target), errors);`
`90`	`90`	`}`
`91`	`91`
	`92`	`+ @SuppressWarnings("rawtypes")`
`92`	`93`	`public void validate(Object target, Errors errors, Object... validationHints) {`
`93`	`94`	`Set<Class> groups = new LinkedHashSet<Class>();`
`94`	`95`	`if (validationHints != null) {`