com.guiseframework.validator
Class AbstractRegularExpressionValidator<V>

java.lang.Object
  com.globalmentor.beans.BoundPropertyObject
      com.guiseframework.event.GuiseBoundPropertyObject
          com.guiseframework.validator.AbstractValidator<V>
              com.guiseframework.validator.AbstractRegularExpressionValidator<V>

Type Parameters:

V - The value type this validator supports.

All Implemented Interfaces:

com.globalmentor.beans.PropertyBindable, com.globalmentor.beans.PropertyConstrainable, Validator<V>

Direct Known Subclasses:

RegularExpressionCharArrayValidator, RegularExpressionStringValidator

public abstract class AbstractRegularExpressionValidator<V>
extends AbstractValidator<V>

An abstract validator that can validate against regular expressions.

Author:

Garret Wilson

Field Summary

Fields inherited from class com.globalmentor.beans.BoundPropertyObject

NO_PROPERTY_CHANGE_LISTENERS, NO_VETOABLE_CHANGE_LISTENERS

Fields inherited from interface com.guiseframework.validator.Validator

INVALID_VALUE_MESSAGE_PROPERTY, VALUE_REQUIRED_MESSAGE_PROPERTY, VALUE_REQUIRED_PROPERTY

Constructor Summary

AbstractRegularExpressionValidator(java.util.regex.Pattern pattern)
Constructs a string regular expression validator from a regular expression pattern, without requiring a non-null value.

AbstractRegularExpressionValidator(java.util.regex.Pattern pattern, boolean valueRequired)
Constructs a string regular expression validator from a regular expression pattern.

AbstractRegularExpressionValidator(java.lang.String regularExpression)
Constructs a string regular expression validator from a regular expression string, without requiring a non-null value..

AbstractRegularExpressionValidator(java.lang.String regularExpression, boolean valueRequired)
Constructs a string regular expression validator from a regular expression string.

Method Summary

java.util.regex.Pattern	getPattern()
protected abstract java.lang.String	toString(V value) Returns a string representation of the given value so that it may be validated against the regular expression.
void	validate(V value) Checks whether a given string matches the regular expression.

Methods inherited from class com.guiseframework.validator.AbstractValidator

getInvalidValueMessage, getValueRequiredMessage, isValid, isValueRequired, setInvalidValueMessage, setValueRequired, setValueRequiredMessage, throwInvalidValueValidationException, throwValueRequiredValidationException

Methods inherited from class com.guiseframework.event.GuiseBoundPropertyObject

getSession

Methods inherited from class com.globalmentor.beans.BoundPropertyObject

addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, createPostponedPropertyChangeEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, getForwardPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, getPropertyChangeSupport, getRepeatPropertyChangeListener, getRepeatVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, getVetoableChangeSupport, hasPropertyChangeListeners, hasVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.guiseframework.validator.Validator

getSession

Methods inherited from interface com.globalmentor.beans.PropertyBindable

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, hasPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Constructor Detail

AbstractRegularExpressionValidator

public AbstractRegularExpressionValidator(java.lang.String regularExpression)

Constructs a string regular expression validator from a regular expression string, without requiring a non-null value..

Parameters:

regularExpression - The regular expression against which to validate string values.

Throws:

java.lang.NullPointerException - if the given regular expression is null.

AbstractRegularExpressionValidator

public AbstractRegularExpressionValidator(java.lang.String regularExpression,
                                          boolean valueRequired)

Constructs a string regular expression validator from a regular expression string.

Parameters:

regularExpression - The regular expression against which to validate string values.

valueRequired - Whether the value must be non-null in order to be considered valid.

Throws:

java.lang.NullPointerException - if the given regular expression is null.

AbstractRegularExpressionValidator

public AbstractRegularExpressionValidator(java.util.regex.Pattern pattern)

Constructs a string regular expression validator from a regular expression pattern, without requiring a non-null value.

Parameters:

pattern - The regular expression pattern against which to validate string values.

Throws:

java.lang.NullPointerException - if the given regular expression pattern is null.

AbstractRegularExpressionValidator

public AbstractRegularExpressionValidator(java.util.regex.Pattern pattern,
                                          boolean valueRequired)

Constructs a string regular expression validator from a regular expression pattern.

Parameters:

pattern - The regular expression pattern against which to validate string values.

valueRequired - Whether the value must be non-null in order to be considered valid.

Throws:

java.lang.NullPointerException - if the given regular expression pattern is null.

Method Detail

getPattern

public java.util.regex.Pattern getPattern()

Returns:

The regular expression pattern against which to validate string values.

toString

protected abstract java.lang.String toString(V value)

Returns a string representation of the given value so that it may be validated against the regular expression.

Overrides:

toString in class AbstractValidator<V>

Parameters:

value - The value being validated.

Returns:

A string representation of the given value, or null if the value is null.

validate

public void validate(V value)
              throws ValidationException

Checks whether a given string matches the regular expression.

Specified by:

validate in interface Validator<V>

Overrides:

validate in class AbstractValidator<V>

Parameters:

value - The value to validate.

Throws:

ValidationException - if the provided value is not valid.

See Also:

getPattern()