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>

public class ComposedValidator<V>
extends AbstractValidator<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
private static String	CODE
private AbstractValidator<? super V>[]	validators The child validators.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected String	getCode() This is the default implementation to retrieve the code of this ValueValidator.
ValueValidator<? super V>	getValidator(int index) Gets the ValueValidator at the given index.
int	getValidatorCount()
boolean	isMandatory()
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, validate

Methods inherited from class java.lang.Object

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

Field Detail

CODE

private 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

isMandatory

public boolean isMandatory()

Overrides:

isMandatory in class AbstractValidator<V>

Returns:

true if this is a validator for mandatory fields (that will not accept null or empty values), false otherwise.

getCode

protected String getCode()

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)

This method validates the given value.

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()

Returns:

the number of validators.

See Also:

getValidator(int), Collection.size()

getValidator

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

Gets the ValueValidator at the given index.

Parameters:

index - is the index of the ValueValidator to get.

Returns:

the requested ValueValidator.

See Also:

List.get(int)