de.jstacs.parameters.validation
Class ConstraintValidator

java.lang.Object
  de.jstacs.parameters.validation.ConstraintValidator

All Implemented Interfaces:

ParameterValidator, Storable, Cloneable

public class ConstraintValidator
extends Object
implements ParameterValidator

Class for a ParameterValidator that is based on Constraints. Each instance of a ConstraintValidator may contain a set of constraints that are all fulfilled, if the checkValue()-method returns true

Author:

Jan Grau

Constructor Summary

ConstraintValidator()
Creates a new ConstraintValidator having an empty list of Constraints, i.e. the constraints of this ConstraintValidator are always fulfilled before additional Constraints are added using the addConstraint()-method.

ConstraintValidator(StringBuffer representation)
Creates a new ConstraintValidator from its XML-representation.

Method Summary

void	addConstraint(Constraint c) Adds an additional Constraint to the list of Constraints.
boolean	checkValue(Object value) Returns true if the value is valid and false otherwise
ConstraintValidator	clone() This method returns a deep copy of the current instance.
void	fromXML(StringBuffer representation) Parses a ConstraintValidator from the XML-representation as returned by toXML().
String	getErrorMessage() Returns the error message if checkValue() returned false.
StringBuffer	toXML() This method returns an XML-representation of an instance of the implementing class.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConstraintValidator

public ConstraintValidator()

Creates a new ConstraintValidator having an empty list of Constraints, i.e. the constraints of this ConstraintValidator are always fulfilled before additional Constraints are added using the addConstraint()-method.

ConstraintValidator

public ConstraintValidator(StringBuffer representation)
                    throws NonParsableException

Creates a new ConstraintValidator from its XML-representation.

Parameters:

representation - the XML-representation

Throws:

NonParsableException - is thrown if representation could not be parsed.

Method Detail

clone

public ConstraintValidator clone()
                          throws CloneNotSupportedException

Description copied from interface: ParameterValidator

This method returns a deep copy of the current instance.

Specified by:

clone in interface ParameterValidator

Overrides:

clone in class Object

Returns:

a deep copy

Throws:

CloneNotSupportedException - if the ParameterValidator could not be cloned

See Also:

Cloneable

addConstraint

public void addConstraint(Constraint c)

Adds an additional Constraint to the list of Constraints.

Parameters:

c - the Constraint to be added

checkValue

public boolean checkValue(Object value)

Description copied from interface: ParameterValidator

Returns true if the value is valid and false otherwise

Specified by:

checkValue in interface ParameterValidator

Parameters:

value - the value to check

Returns:

if the value is valid

getErrorMessage

public String getErrorMessage()

Description copied from interface: ParameterValidator

Returns the error message if checkValue() returned false.

Specified by:

getErrorMessage in interface ParameterValidator

Returns:

the error message

toXML

public StringBuffer toXML()

Description copied from interface: Storable

This method returns an XML-representation of an instance of the implementing class.

Specified by:

toXML in interface Storable

Returns:

the XML-representation

fromXML

public void fromXML(StringBuffer representation)
             throws NonParsableException

Parses a ConstraintValidator from the XML-representation as returned by toXML().

Parameters:

representation - the XML-representation

Throws:

NonParsableException - thrown if the XML-code could not be parsed