Package org.esa.snap.core.param
Interface ParamValidator
-
- All Known Implementing Classes:
AbstractExpressionValidator
,AbstractParamValidator
,BooleanExpressionValidator
,BooleanValidator
,ColorValidator
,FileValidator
,GeneralExpressionValidator
,NumberValidator
,ProductNodeNameValidator
,StringArrayValidator
,StringValidator
public interface ParamValidator
AParamValidator
is an interface for parameter type specific value-to-text and text-to-value conversions, data validation and comparision.This interface strictly defines algorithms, implementors of this interface should refrain from defining any data in their implementing classes. Any information required to correctly perform the operations defined in
ParamValidator
shall be supplied by the givenParameter
.Parameter validators for a given Java class can be permanently registered in
ParamValidator
- Version:
- $Revision$ $Date$
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
equalValues(Parameter parameter, Object value1, Object value2)
Tests if the given two values are equal taking the given parameter information into account.String
format(Parameter parameter, Object value)
Converts the given value into a text taking the given parameter information into account.Object
parse(Parameter parameter, String text)
Converts the given text into a value taking the given parameter information into account.void
validate(Parameter parameter, Object value)
Tests if the given value passes all constraints given in the supplied parameter information.
-
-
-
Method Detail
-
parse
Object parse(Parameter parameter, String text) throws ParamParseException
Converts the given text into a value taking the given parameter information into account.- Parameters:
parameter
- the parameter, must not benull
text
- the text to be converted into a value, must not benull
- Returns:
- the value represented by the text
- Throws:
ParamParseException
-
format
String format(Parameter parameter, Object value) throws ParamFormatException
Converts the given value into a text taking the given parameter information into account.- Parameters:
parameter
- the parameter, must not benull
value
- the value to be converted into a text, can benull
- Returns:
- the value represented by the text, never
null
. - Throws:
ParamFormatException
-
validate
void validate(Parameter parameter, Object value) throws ParamValidateException
Tests if the given value passes all constraints given in the supplied parameter information. The value can also benull
since parameters can be allowed to have the value 'null'.- Parameters:
parameter
- the parameter, must not benull
value
- the value to be tested, can benull
- Throws:
ParamValidateException
-
equalValues
boolean equalValues(Parameter parameter, Object value1, Object value2)
Tests if the given two values are equal taking the given parameter information into account.- Parameters:
parameter
- the parameter, must not benull
value1
- the first value, can benull
value2
- the second value, can also benull
- Returns:
true
if the value are equal,false
otherwise
-
-