org.apache.wicket.validation
Class Validatable<T>

java.lang.Object
  org.apache.wicket.validation.Validatable<T>

Type Parameters:

T - type of validatable

All Implemented Interfaces:

IValidatable<T>

public class Validatable<T>
extends Object
implements IValidatable<T>

This implementation of IValidatable is meant to be used outside of Wicket. It allows other parts of the application to utilize IValidators for validation.

Example:

 class WebService
 {
        public void addUser(String firstName, String lastName)
        {
                Validatable standin = new Validatable();
                standin.setValue(firstName);
                new FirstNameValidator().validate(standin);
                standing.setValue(lastName);
                new LastNameValidator().validate(standin);
                if (!standin.isValid())
                {
                        // roll your own ValidationException
                        throw new ValidationException(standin.getErrors());
                }
                else
                {
                        // add user here
                }
        }
 }
 

Since:

1.2.6

Author:

Igor Vaynberg (ivaynberg)

Constructor Summary

Validatable()
Constructor.

Validatable(T value)
Constructor.

Method Summary

void	error(IValidationError error) Reports an error against this IValidatable's value.
List<IValidationError>	getErrors() Retrieves an unmodifiable list of any errors reported against this IValidatable instance.
T	getValue() Retrieves the value to be validated.
boolean	isValid() Queries the current state of this IValidatable instance.
void	setValue(T value) Sets the value object that will be returned by getValue().

Methods inherited from class java.lang.Object

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

Constructor Detail

Validatable

public Validatable()

Constructor.

Validatable

public Validatable(T value)

Constructor.

Parameters:

value - The value that will be tested

Method Detail

setValue

public void setValue(T value)

Sets the value object that will be returned by getValue().

Parameters:

value - the value object

getValue

public T getValue()

Description copied from interface: IValidatable

Retrieves the value to be validated.

Specified by:

getValue in interface IValidatable<T>

Returns:

the value to be validated

See Also:

IValidatable.getValue()

error

public void error(IValidationError error)

Description copied from interface: IValidatable

Reports an error against this IValidatable's value. Multiple errors can be reported by calling this method multiple times.

Specified by:

error in interface IValidatable<T>

Parameters:

error - an IValidationError to be reported

See Also:

IValidatable.error(IValidationError)

getErrors

public List<IValidationError> getErrors()

Retrieves an unmodifiable list of any errors reported against this IValidatable instance.

Returns:

an unmodifiable list of errors

isValid

public boolean isValid()

Description copied from interface: IValidatable

Queries the current state of this IValidatable instance. IValidatables should assume they are valid until IValidatable.error(IValidationError) is called.

Specified by:

isValid in interface IValidatable<T>

Returns:

true if the object is in a valid state, false if otherwise

See Also:

IValidatable.isValid()