DataSift: The Java data validation and transformation framework

Predefined validators

The validators specified here are registered at DataSift startup, and are always available to the user without further configuration.

Boolean validators
Double validators
Float validators
Integer validators
String validators
Iterating validators

Boolean validators

BooleanValue

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
expectedValue	java.lang.Boolean	Yes		The boolean value to look for.

Data parameter	Type	Description
data	java.lang.Boolean	Piece of data to be validated.

Double validators

DoubleInRange

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
minValue	java.lang.Double	No	Double.MIN_VALUE	Minimum value of the number in the data object for the validation to succeed.
maxValue	java.lang.Double	No	Double.MAX_VALUE	Maximum value of the number in the data object for the validation to succeed.

Data parameter	Type	Description
data	java.lang.Double	Piece of data to be validated.

Float validators

FloatInRange

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
minValue	java.lang.Float	No	Float.MIN_VALUE	Minimum value of the number in the data object for the validation to succeed.
maxValue	java.lang.Integer	No	Float.MAX_VALUE	Maximum value of the number in the data object for the validation to succeed.

Data parameter	Type	Description
data	java.lang.Float	Piece of data to be validated.

Integer validators

IntegerInRange

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
minValue	java.lang.Integer	No	Integer.MIN_VALUE	Minimum value of the number in the data object for the validation to succeed.
maxValue	java.lang.Integer	No	Integer.MAX_VALUE	Maximum value of the number in the data object for the validation to succeed.

Data parameter	Type	Description
data	java.lang.Integer	Piece of data to be validated.

String validators

StringIsBoolean

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
expectedValue	java.lang.Boolean	No		If the String is a correct boolean value, allows to check for a specific value (`true` or `false`).

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringIsDate

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
pattern	java.lang.String	Yes		Date pattern to use for matching. This pattern will be defined as specified in `java.text.SimpleDateFormat`.
locale	java.lang.String	No	(Default locale)	Locale to be used for date constants (month names, etc). For instance: "es", "es_ES", "es_ES.UTF-8"...
allowedDates	java.lang.String[]	No	ANY	Dates that will be allowed. Possible values are: `ANY`: Any date which matches the pattern will be valid. `PAST`: Only dates which match the pattern and are in the past will be valid. `PRESENT`: Only dates which match the pattern and refer to the present moment will be valid. `FUTURE`: Only dates which match the pattern and are in the future will be valid. This values can be combined. For instance: "PAST PRESENT", "PRESENT FUTURE",... Only the date fields present in the specified pattern will be used for comparison.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringIsInteger

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
minValue	java.lang.Integer	No	Integer.MIN_VALUE	Minimum value of the number in the String object for the validation to succeed.
maxValue	java.lang.Integer	No	Integer.MAX_VALUE	Maximum value of the number in the String object for the validation to succeed.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringIsDouble

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
minValue	java.lang.Double	No	Double.MIN_VALUE	Minimum value of the number in the String object for the validation to succeed.
maxValue	java.lang.Double	No	Double.MAX_VALUE	Maximum value of the number in the String object for the validation to succeed.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringIsEmail

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated. Validation will succeed if the string is an email address.

StringIsFloat

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
minValue	java.lang.Float	No	Float.MIN_VALUE	Minimum value of the number in the String object for the validation to succeed.
maxValue	java.lang.Float	No	Float.MAX_VALUE	Maximum value of the number in the String object for the validation to succeed.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringIsUrl

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated (will be valid if String conforms to a URL specification as defined in `java.net.URL`).

StringLength

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
minLength	java.lang.Integer	No	0	Minimum length of the String for the validation to succeed.
maxLength	java.lang.Integer	No	Integer.MAX_VALUE	Maximum length of the String for the validation to succeed.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringMatchPattern

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.
pattern	java.lang.String	Yes		Pattern (`java.util.regex.Pattern` style) against which the string will be tried to match.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

StringNotEmpty

Config parameter	Type	Required	Default value	Description
trim	java.lang.Boolean	No	Boolean.TRUE	Trim the String before checking it.

Data parameter	Type	Description
data	java.lang.String	Piece of data to be validated.

Iterating validators

ArrayIterator

This validator performs all its nested validations on every item of an array of objects (applying an ObjectResolver to each of the array items).

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
successCondition	java.lang.String	No	AND	Condition to apply on the results of the iteration items. Possible values: `AND`: All the items must validate OK. `OR`: At least one item must validate OK. `EXOR`: Only one item must validate OK. `NEXOR`: Either none or all of the items must validate OK.

Data parameter	Type	Description
data	java.lang.Object[]	Piece of data to be validated.

CollectionIterator

This validator performs all its nested validations on every item of a Collection (applying an ObjectResolver to each of the Collection items).

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
successCondition	java.lang.String	No	AND	Condition to apply on the results of the iteration items. Possible values: `AND`: All the items must validate OK. `OR`: At least one item must validate OK. `EXOR`: Only one item must validate OK. `NEXOR`: Either none or all of the items must validate OK.

Data parameter	Type	Description
data	java.util.Collection	Piece of data to be validated.

MapIterator

This validator performs all its nested validations on every entry of a Map (applying a MapEntryResolver to each of the Map entries).

Config parameter	Type	Required	Default value	Description
acceptNull	java.lang.Boolean	No	Boolean.FALSE	If `true` validation will succeed if the data parameter is null.
successCondition	java.lang.String	No	AND	Condition to apply on the results of the iteration items. Possible values: `AND`: All the items must validate OK. `OR`: At least one item must validate OK. `EXOR`: Only one item must validate OK. `NEXOR`: Either none or all of the items must validate OK.

Data parameter	Type	Description
data	java.util.Map	Piece of data to be validated.

AuelProject DataSift

Documentation

Development