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);
}
Show replies by date