fluent.validation

Interface Check<T>

Type Parameters:

T - Type of the data to be tested using this check.

All Known Subinterfaces:

CheckDsl<L,D>

All Known Implementing Classes:

AbstractCheckDsl, CustomResultFactoryCheck, CheckBuilder, LocalDateCheck, LocalDateTimeCheck, LocalTimeCheck, MapCheckBuilder, ThrowingCheck, ZonedDateTimeCheck

public interface Check<T>

Simple check used in for validation of various data. It tests, if value meets a criteria described by the check. But the main purpose of this class is to provide transparency during any complex check evaluation, similar to Hamcrest Matchers. If you are familiar with Hamcrest matchers, it should be easy to get familiar with Checks too. There are only following differences: 1. Evaluation detail is not limited to mismatch description. You can achieve full detail even for passed ones. 2. This interface is type-safe on application (see test() methods are accepting class type argument, not Object). It may be limiting, but helps avoid test errors. 3. Thanks to it being generic, it's very simple to simplify creation of any custom, or composed conditions with advantage of Java 8 functional interfaces (lambdas).

Method Summary

Modifier and Type	Method and Description
default <U extends T> Check<U>	and(Check<? super U> operand) Compose this check with another one using logical AND operator.
static <T> Result	evaluate(T data, Check<? super T> check)
Result	evaluate(T data, ResultFactory factory) Abstract method to delegate implementation of specific check logic to subclasses.
default <U extends T> Check<U>	or(Check<? super U> operand) Compose this check with another one using logical OR operator.
static <T> boolean	that(T data, Check<? super T> check) Assert the data using provided check.
static <T> boolean	that(T data, Check<? super T> check, ResultVisitor visitor)

Method Detail

evaluate

@End(message="Check is not used. Pass it either to Assert.that(), Check.that() or Check.evaluate().")
Result evaluate(T data,
                                                                                                                      ResultFactory factory)

Abstract method to delegate implementation of specific check logic to subclasses.

Parameters:

data - Tested data.

factory - Result factory responsible for creating result tree from current node.

Returns:

representation of outcome of the test.

and

default <U extends T> Check<U> and(Check<? super U> operand)

Compose this check with another one using logical AND operator.

Type Parameters:

U - Type of the data tested by other check. It may cause up-cast.

Parameters:

operand - Another check.

Returns:

Composed check.

or

default <U extends T> Check<U> or(Check<? super U> operand)

Compose this check with another one using logical OR operator.

Type Parameters:

U - Type of the data tested by other check. It may cause up-cast.

Parameters:

operand - Another check.

Returns:

Composed check.

that

@End(message="Check is not used. Pass it either to Assert.that(), Check.that() or Check.evaluate().")
static <T> boolean that(T data,
                                                                                                                              Check<? super T> check)

Assert the data using provided check.

Type Parameters:

T - Type of the tested data.

Parameters:

data - Tested data.

check - Check to be applied.

that

static <T> boolean that(T data,
                        Check<? super T> check,
                        ResultVisitor visitor)

evaluate

static <T> Result evaluate(T data,
                           Check<? super T> check)