[hibernate-commits] Hibernate SVN: r16026 - beanvalidation/trunk/validation-api/src/main/java/javax/validation.

[hibernate-commits at lists.jboss.org]

Author: epbernard
Date: 2009-02-24 15:02:35 -0500 (Tue, 24 Feb 2009)
New Revision: 16026

Modified:
   beanvalidation/trunk/validation-api/src/main/java/javax/validation/Configuration.java
   beanvalidation/trunk/validation-api/src/main/java/javax/validation/MessageInterpolator.java
   beanvalidation/trunk/validation-api/src/main/java/javax/validation/Validator.java
Log:
BVAL-52 define exception model

Modified: beanvalidation/trunk/validation-api/src/main/java/javax/validation/Configuration.java
===================================================================
--- beanvalidation/trunk/validation-api/src/main/java/javax/validation/Configuration.java	2009-02-24 15:58:29 UTC (rev 16025)
+++ beanvalidation/trunk/validation-api/src/main/java/javax/validation/Configuration.java	2009-02-24 20:02:35 UTC (rev 16026)
@@ -166,6 +166,7 @@
 	 * Build a ValidatorFactory implementation.
 	 *
 	 * @return ValidatorFactory
+	 * @throws ValidationException if the ValidatorFactory cannot be built
 	 */
 	ValidatorFactory buildValidatorFactory();
 }

Modified: beanvalidation/trunk/validation-api/src/main/java/javax/validation/MessageInterpolator.java
===================================================================
--- beanvalidation/trunk/validation-api/src/main/java/javax/validation/MessageInterpolator.java	2009-02-24 15:58:29 UTC (rev 16025)
+++ beanvalidation/trunk/validation-api/src/main/java/javax/validation/MessageInterpolator.java	2009-02-24 20:02:35 UTC (rev 16026)
@@ -21,6 +21,7 @@
 
 /**
  * Interpolate a given constraint violation message.
+ * Implementations should be as tolerant as possible on syntax errors.
  *
  * @author Emmanuel Bernard
  * @author Hardy Ferentschik

Modified: beanvalidation/trunk/validation-api/src/main/java/javax/validation/Validator.java
===================================================================
--- beanvalidation/trunk/validation-api/src/main/java/javax/validation/Validator.java	2009-02-24 15:58:29 UTC (rev 16025)
+++ beanvalidation/trunk/validation-api/src/main/java/javax/validation/Validator.java	2009-02-24 20:02:35 UTC (rev 16026)
@@ -24,7 +24,6 @@
  *
  * @author Emmanuel Bernard
  * @author Hardy Ferentschik
- * @todo Should Serializable be part of the definition?
  */
 public interface Validator {
 	/**
@@ -37,6 +36,8 @@
 	 * @return constraint violations or an empty Set if none
 	 *
 	 * @throws IllegalArgumentException if object is null
+	 * @throws ValidationException if a non recoverable error happens
+	 *                             during the validation process
 	 */
 	<T> Set<ConstraintViolation<T>> validate(T object, Class<?>... groups);
 
@@ -52,6 +53,8 @@
 	 *
 	 * @throws IllegalArgumentException if object is null, if propertyName null, empty
 	 *                                  or not a valid object property
+	 * @throws ValidationException if a non recoverable error happens
+	 *                             during the validation process
 	 */
 	<T> Set<ConstraintViolation<T>> validateProperty(T object,
 													 String propertyName,
@@ -72,6 +75,8 @@
 	 * @return constraint violations or an empty Set if none
 	 * @throws IllegalArgumentException if object is null, if propertyName null, empty
 	 *                                  or not a valid object property
+	 * @throws ValidationException if a non recoverable error happens
+	 *                             during the validation process
 	 */
 	<T> Set<ConstraintViolation<T>> validateValue(Class<T> beanType,
 												  String propertyName,
@@ -85,6 +90,9 @@
 	 *
 	 * @param clazz class type evaluated
 	 * @return the bean descriptor for the specified class.
+	 * @throws ValidationException if a non recoverable error happens
+	 *                             during the metadata discovery or if some
+	 *                             constraints are invalid. 
 	 */
 	BeanDescriptor getConstraintsForClass(Class<?> clazz);
 }