org.valid4j

Class Validation

java.lang.Object

org.valid4j.Validation

public class Validation
extends Object

Entry point for validation methods. Use these methods to throw recoverable exceptions if validation fails. Recoverable exceptions are exceptions that a correct program can and should catch and recover from. (Recoverable exceptions may be checked or unchecked.)

Method Summary

Modifier and Type	Method and Description
static <X extends Exception> ExceptionFactory<X>	otherwiseThrowing(Class<X> exceptionClass)
static <X extends Exception> void	validate(boolean condition, Class<X> exceptionClass) Validate the boolean expression that is supposed to be true.
static <X extends Exception> void	validate(boolean condition, ExceptionFactory<X> factory) Validate the boolean expression that is supposed to be true.
static <X extends Exception> void	validate(boolean condition, X exception) Validate the boolean expression that is supposed to be true.
static <T,X extends Exception> T	validate(T o, org.hamcrest.Matcher<?> matcher, Class<X> exceptionClass) Validate the given object that is supposed to satisfy the matcher.
static <T,X extends Exception> T	validate(T o, org.hamcrest.Matcher<?> matcher, ExceptionFactory<X> factory) Validate the given object that is supposed to satisfy the matcher.
static <T,X extends Exception> T	validate(T o, org.hamcrest.Matcher<?> matcher, X exception) Validate the given object that is supposed to satisfy the matcher.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

otherwiseThrowing

public static <X extends Exception> ExceptionFactory<X> otherwiseThrowing(Class<X> exceptionClass)

validate

public static <X extends Exception> void validate(boolean condition,
                                                  X exception)
                                           throws X extends Exception

Validate the boolean expression that is supposed to be true. If not, a recoverable exception will be thrown that the client is supposed to catch and recover from.

Type Parameters:

X - type of exception to throw if validation fails

Parameters:

condition - the condition to validate. Supposed to be true.

exception - the recoverable exception to be thrown if validation fails.

Throws:

X - the recoverable exception, if validation fails

X extends Exception

validate

public static <X extends Exception> void validate(boolean condition,
                                                  Class<X> exceptionClass)
                                           throws X extends Exception

Validate the boolean expression that is supposed to be true. If not, a recoverable exception will be thrown that the client is supposed to catch and recover from.

Type Parameters:

X - type of exception to throw if validation fails

Parameters:

condition - the condition to validate. Supposed to be true.

exceptionClass - the class of recoverable exception to be thrown if validation fails.

Throws:

X - the recoverable exception, if validation fails

X extends Exception

validate

public static <X extends Exception> void validate(boolean condition,
                                                  ExceptionFactory<X> factory)
                                           throws X extends Exception

Validate the boolean expression that is supposed to be true. If not, a recoverable exception will be thrown that the client is supposed to catch and recover from.

Type Parameters:

X - type of exception to throw if validation fails

Parameters:

condition - the condition to validate. Supposed to be true.

factory - the factory of recoverable exception to be thrown if validation fails.

Throws:

X - the recoverable exception, if validation fails

X extends Exception

validate

public static <T,X extends Exception> T validate(T o,
                                                 org.hamcrest.Matcher<?> matcher,
                                                 X exception)
                                          throws X extends Exception

Validate the given object that is supposed to satisfy the matcher. If not, a recoverable exception will be thrown that the client is supposed to catch and recover from.

Type Parameters:

T - type of object to validate

X - type of exception to throw if validation fails

Parameters:

o - the object to validate

matcher - the matcher that the object must satisfy

exception - the recoverable exception to be thrown if validation fails.

Returns:

the validated object, if valid

Throws:

X - the recoverable exception, if validation fails

X extends Exception

validate

public static <T,X extends Exception> T validate(T o,
                                                 org.hamcrest.Matcher<?> matcher,
                                                 Class<X> exceptionClass)
                                          throws X extends Exception

Validate the given object that is supposed to satisfy the matcher. If not, a recoverable exception will be thrown that the client is supposed to catch and recover from.

Type Parameters:

T - type of object to validate

X - type of exception to throw if validation fails

Parameters:

o - the object to validate

matcher - the matcher that the object must satisfy

exceptionClass - the class of recoverable exception to be thrown if validation fails.

Returns:

the validated object, if valid

Throws:

X - the recoverable exception, if validation fails

X extends Exception

validate

public static <T,X extends Exception> T validate(T o,
                                                 org.hamcrest.Matcher<?> matcher,
                                                 ExceptionFactory<X> factory)
                                          throws X extends Exception

Validate the given object that is supposed to satisfy the matcher. If not, a recoverable exception will be thrown that the client is supposed to catch and recover from.

Type Parameters:

T - type of object to validate

X - type of exception to throw if validation fails

Parameters:

o - the object to validate

matcher - the matcher that the object must satisfy

factory - the factory of recoverable exception to be thrown if validation fails.

Returns:

the validated object, if valid

Throws:

X - the recoverable exception, if validation fails

X extends Exception