net.sf.mmm.util.validation.base

Class ComposedValidator<V>

java.lang.Object

net.sf.mmm.util.validation.base.AbstractValidator<V>

net.sf.mmm.util.validation.base.ComposedValidator<V>

Type Parameters:

V - is the generic type of the value to validate.

All Implemented Interfaces:

ValueValidator<V>, ComposedValueValidator<V>

public class ComposedValidator<V>
extends AbstractValidator<V>
implements ComposedValueValidator<V>

This is an implementation of ValueValidator that is composed out of a set of individual validators given at construction. It will always invoke all contained validators when a validation is performed.

Since:

3.1.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
static String	CODE
private AbstractValidator<? super V>[]	validators The child validators.

Fields inherited from class net.sf.mmm.util.validation.base.AbstractValidator

PROPERTY_MANDATORY, PROPERTY_MAXIMUM, PROPERTY_MINIMUM

Constructor Summary

Constructors

Constructor and Description
ComposedValidator(AbstractValidator<? super V>... validators) The constructor.

Method Summary

Modifier and Type	Method and Description
ComposedValidator<V>	append(AbstractValidator<? super V>... additionalValidators)
boolean	contains(AbstractValidator<?> validator)
boolean	equals(Object obj)
protected String	getCode() This is the default implementation to retrieve the code of this ValueValidator.
<P> P	getProperty(TypedProperty<P> property) Gets the value of a property.
AbstractValidator<? super V>	getValidator(int index) Gets the ValueValidator at the given index.
int	getValidatorCount()
int	hashCode()
ValidationFailure	validate(V value, Object valueSource) This method validates the given value.

Methods inherited from class net.sf.mmm.util.validation.base.AbstractValidator

createBundle, isDynamic, isMandatory, validate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.sf.mmm.util.validation.api.ValueValidator

validate

Field Detail

CODE

public static final String CODE

See Also:

getCode(), Constant Field Values

validators

private final AbstractValidator<? super V>[] validators

The child validators.

Constructor Detail

ComposedValidator

@SafeVarargs
public ComposedValidator(AbstractValidator<? super V>... validators)

The constructor.

Parameters:

validators - are the validators to compose.

Method Detail

getCode

protected String getCode()

Description copied from class: AbstractValidator

This is the default implementation to retrieve the code of this ValueValidator.
ATTENTION:
This default implementation returns the classname of the actual ValueValidator implementation. This strategy is chosen for simplicity when implementing a new validator. To ensure stable codes override this method and return a string constant. This shall at least be done when the name of the class is changed.

Overrides:

getCode in class AbstractValidator<V>

Returns:

the code.

validate

public ValidationFailure validate(V value,
                                  Object valueSource)

Description copied from interface: ValueValidator

This method validates the given value.

Specified by:

validate in interface ValueValidator<V>

Parameters:

value - is the value to validate.

valueSource - is the source describing the origin of the given value. This may be the filename where the value was read from, an XPath where the value was located in an XML document, the label of a widget of the UI containing the value, etc. This will help to find the problem easier. The source needs to have a reasonable string-representation as this may be displayed to the end-user to locate the source of the failure. In most cases it is suitable to directly pass a String.

Returns:

the ValidationFailure or null if the given value is valid according to this ValueValidator.

getValidatorCount

public int getValidatorCount()

Specified by:

getValidatorCount in interface ComposedValueValidator<V>

Returns:

the number of validators.

See Also:

getValidator(int), Collection.size()

getValidator

public AbstractValidator<? super V> getValidator(int index)

Gets the ValueValidator at the given index.

Specified by:

getValidator in interface ComposedValueValidator<V>

Parameters:

index - is the index of the ValueValidator to get.

Returns:

the requested ValueValidator.

See Also:

List.get(int)

getProperty

public <P> P getProperty(TypedProperty<P> property)

Description copied from class: AbstractValidator

Gets the value of a property.

Overrides:

getProperty in class AbstractValidator<V>

Type Parameters:

P - the generic type of the requested property.

Parameters:

property - the TypedProperty.

Returns:

the requested value or null if undefined.

contains

public boolean contains(AbstractValidator<?> validator)

Overrides:

contains in class AbstractValidator<V>

Parameters:

validator - the validator to check.

Returns:

true if the given validator is equal to this validator or one of its descendents, false otherwise.

append

public ComposedValidator<V> append(AbstractValidator<? super V>... additionalValidators)

Overrides:

append in class AbstractValidator<V>

Parameters:

additionalValidators - the validators to append.

Returns:

a new ComposedValidator instance composing the current validator (this) with the given validator.

hashCode

public int hashCode()

Specified by:

hashCode in class AbstractValidator<V>

equals

public boolean equals(Object obj)

Specified by:

equals in class AbstractValidator<V>