com.vaadin.data.validator
Class AbstractStringValidator

java.lang.Object
  com.vaadin.data.validator.AbstractValidator
      com.vaadin.data.validator.AbstractStringValidator

All Implemented Interfaces:

Validator, Serializable

Direct Known Subclasses:

DoubleValidator, IntegerValidator, RegexpValidator

public abstract class AbstractStringValidator
extends AbstractValidator

Validator base class for validating strings. See AbstractValidator for more information.

To include the value that failed validation in the exception message you can use "{0}" in the error message. This will be replaced with the failed value (converted to string using Object.toString()) or "null" if the value is null.

Since:

5.4

Version:

6.8.18

Author:

Vaadin Ltd.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.data.Validator

Validator.EmptyValueException, Validator.InvalidValueException

Constructor Summary

AbstractStringValidator(String errorMessage)
Constructs a validator for strings.

Method Summary

boolean	isValid(Object value) Tests if the given value is a valid string.
protected abstract boolean	isValidString(String value) Checks if the given string is valid.

Methods inherited from class com.vaadin.data.validator.AbstractValidator

getErrorMessage, setErrorMessage, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractStringValidator

public AbstractStringValidator(String errorMessage)

Constructs a validator for strings.

Null and empty string values are always accepted. To reject empty values, set the field being validated as required.

Parameters:

errorMessage - the message to be included in an InvalidValueException (with "{0}" replaced by the value that failed validation).

Method Detail

isValid

public boolean isValid(Object value)

Tests if the given value is a valid string.

Null values are always accepted. Values that are not Strings are converted using Object.toString(). Then isValidString(String) is used to validate the value.

Parameters:

value - the value to check

Returns:

true if the value (or its toString()) is a valid string, false otherwise

isValidString

protected abstract boolean isValidString(String value)

Checks if the given string is valid.

Parameters:

value - String to check. Can never be null.

Returns:

true if the string is valid, false otherwise