Package cdc.util.validation

Interface Validator<T>

Type Parameters:

T - Value type.

All Known Implementing Classes:

ValidatorImpl

public interface Validator<T>

Validator of values.

Author:

Damien Carbonne

Method Summary

Modifier and Type	Method	Description
default <S> Validator<S>	after(Converter<S,? extends T> converter)	Creates a validator composed of this one applied after a converter.
default <S> Validator<S>	after(java.util.function.Function<S,? extends T> function, java.lang.Class<S> sourceClass)	Creates a validator composed of this one applied after a conversion function.
default Validator<?>	afterRaw(Converter<?,?> converter)
default Validity	getValidity(T value)	Returns the validity of a value.
default Validity	getValidityRaw(java.lang.Object value)	Returns the validity of a raw value.
java.lang.Class<T>	getValueClass()
default java.util.List<ValidationRecord>	validate(T value, java.lang.String name)	Validates a value and returns a list of validation records.
void	validate(T value, java.lang.String name, ValidationHandler handler)	Validates a value.
default void	validate(T value, java.lang.String name, java.util.List<ValidationRecord> records)	Validates a value and adds validation records to a list.
default java.util.List<ValidationRecord>	validateRaw(java.lang.Object value, java.lang.String name)	Validates a raw value and returns a list of validation records.
default void	validateRaw(java.lang.Object value, java.lang.String name, ValidationHandler handler)	Validates a raw value.
default void	validateRaw(java.lang.Object value, java.lang.String name, java.util.List<ValidationRecord> records)	Validates a raw value and adds validation records to a list.

Method Detail

getValueClass

java.lang.Class<T> getValueClass()

Returns:

The class of values validated by this validator.

validate

void validate(T value,
              java.lang.String name,
              ValidationHandler handler)

Validates a value.

Parameters:

value - The value.

name - The name that must be given to value in messages.

handler - The validation messages handler.

validate

default void validate(T value,
                      java.lang.String name,
                      java.util.List<ValidationRecord> records)

Validates a value and adds validation records to a list.

Parameters:

value - The value.

name - The name that must be given to value in messages.

records - The list of validation records that must be filled.

Throws:

java.lang.IllegalArgumentException - When records is null.

validate

default java.util.List<ValidationRecord> validate(T value,
                                                  java.lang.String name)

Validates a value and returns a list of validation records.

Parameters:

value - The value.

name - The name that must be given to value in messages.

Returns:

A list of validation records, possibly empty.

validateRaw

default void validateRaw(java.lang.Object value,
                         java.lang.String name,
                         ValidationHandler handler)

Validates a raw value.

Parameters:

value - The value.

name - The name that must be given to value in messages.

handler - The validation messages handler.

Throws:

java.lang.ClassCastException - If value is not null and cannot be assigned to value type T.

validateRaw

default void validateRaw(java.lang.Object value,
                         java.lang.String name,
                         java.util.List<ValidationRecord> records)

Validates a raw value and adds validation records to a list.

Parameters:

value - The value.

name - The name that must be given to value in messages.

records - The list of validation records that must be filled.

Throws:

java.lang.IllegalArgumentException - When records is null.

java.lang.ClassCastException - If value is not null and cannot be assigned to value type T.

validateRaw

default java.util.List<ValidationRecord> validateRaw(java.lang.Object value,
                                                     java.lang.String name)

Validates a raw value and returns a list of validation records.

Parameters:

value - The value.

name - The name that must be given to value in messages.

Returns:

A list of validation records, possibly empty.

Throws:

java.lang.ClassCastException - If value is not null and cannot be assigned to value type T.

getValidity

default Validity getValidity(T value)

Returns the validity of a value.

Parameters:

value - The value.

Returns:

The validity of value.

getValidityRaw

default Validity getValidityRaw(java.lang.Object value)

Returns the validity of a raw value.

Parameters:

value - The value.

Returns:

The validity of value.

Throws:

java.lang.ClassCastException - If value is not null and cannot be assigned to value type T.

after

default <S> Validator<S> after(Converter<S,? extends T> converter)

Creates a validator composed of this one applied after a converter.

Type Parameters:

S - The source type.

Parameters:

converter - The converter from source type S to T.

Returns:

A new validator composed of this one applied after converter.

Throws:

java.lang.IllegalArgumentException - When converter is null.

afterRaw

default Validator<?> afterRaw(Converter<?,?> converter)

Parameters:

converter - The converter.

Returns:

A new validator composed of this one applied after converter.

Throws:

java.lang.IllegalArgumentException - When converter is null.

after

default <S> Validator<S> after(java.util.function.Function<S,? extends T> function,
                               java.lang.Class<S> sourceClass)

Creates a validator composed of this one applied after a conversion function.

Type Parameters:

S - The source type.

Parameters:

function - The function that converts values from source type S to T.

sourceClass - The source class.

Returns:

A new validator composed of this one applied conversion function.

Throws:

java.lang.IllegalArgumentException - When function or sourceClass is null.