Package com.univocity.parsers.conversions

Class Conversions

java.lang.Object

com.univocity.parsers.conversions.Conversions

public class Conversions
extends Object

This class provides default instances of common implementations if com.univocity.parsers.conversions.Conversion, as well as useful methods for obtaining new instances of these.

Field Summary

Fields

Modifier and Type	Field	Description
private static final LowerCaseConversion	lowerCase
private static final ToStringConversion	toString
private static final TrimConversion	trim
private static final UpperCaseConversion	upperCase

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Conversions()

Method Summary

Modifier and Type	Method	Description
static FormattedBigDecimalConversion	formatToBigDecimal(String... numberFormats)	Returns a new instance of FormattedBigDecimalConversion
static FormattedBigDecimalConversion	formatToBigDecimal(BigDecimal defaultValueForNullString, String... numberFormats)	Returns a new instance of FormattedBigDecimalConversion
static FormattedBigDecimalConversion	formatToBigDecimal(BigDecimal defaultValueForNullString, String stringIfNull, String... numberFormats)	Returns a new instance of FormattedBigDecimalConversion
static <T extends Number> NumericConversion<T>	formatToNumber(Class<T> numberType, String... numberFormats)	Returns a new instance of NumericConversion
static NumericConversion<Number>	formatToNumber(String... numberFormats)	Returns a new instance of NumericConversion
static ValidatedConversion	noneOf(String... noneOf)	Returns a new instance of ValidatedConversion to validate values of a record Nulls and blanks are not be allowed by default.
static ValidatedConversion	notBlank()	Returns a ValidatedConversion that doesn't allow null or blank values
static ValidatedConversion	notBlank(String regexToMatch)	Returns a ValidatedConversion that verifies the format of a given value
static ValidatedConversion	notNull()	Returns a ValidatedConversion that doesn't allow null values
static ValidatedConversion	oneOf(String... oneOf)	Returns a new instance of ValidatedConversion to validate values of a record Nulls and blanks are not be allowed by default.
static RegexConversion	replace(String replaceRegex, String replacement)	Returns a new instance of RegexConversion
static ToStringConversion	string()	Returns a singleton instance of ToStringConversion
static BigDecimalConversion	toBigDecimal()	Returns a new instance of BigDecimalConversion
static BigIntegerConversion	toBigInteger()	Returns a new instance of BigIntegerConversion
static BooleanConversion	toBoolean()	Returns a new instance of BooleanConversion that converts the string "true" to true, and the String "false" to false.
static BooleanConversion	toBoolean(Boolean defaultValueForNullString, String defaultValueForNullBoolean, String[] valuesForTrue, String[] valuesForFalse)	Returns a new instance of BooleanConversion
static BooleanConversion	toBoolean(Boolean defaultValueForNullString, String defaultValueForNullBoolean, String valueForTrue, String valueForFalse)	Returns a new instance of BooleanConversion
static BooleanConversion	toBoolean(String[] valuesForTrue, String[] valuesForFalse)	Returns a new instance of BooleanConversion
static BooleanConversion	toBoolean(String valueForTrue, String valueForFalse)	Returns a new instance of BooleanConversion
static ByteConversion	toByte()	Returns a new instance of ByteConversion
static CalendarConversion	toCalendar(String... dateFormats)	Returns a new instance of CalendarConversion
static CalendarConversion	toCalendar(Calendar dateIfNull, String... dateFormats)	Returns a new instance of CalendarConversion
static CalendarConversion	toCalendar(Calendar dateIfNull, String stringIfNull, String... dateFormats)	Returns a new instance of CalendarConversion
static CalendarConversion	toCalendar(Locale locale, String... dateFormats)	Returns a new instance of CalendarConversion
static CalendarConversion	toCalendar(Locale locale, Calendar dateIfNull, String... dateFormats)	Returns a new instance of CalendarConversion
static CalendarConversion	toCalendar(Locale locale, Calendar dateIfNull, String stringIfNull, String... dateFormats)	Returns a new instance of CalendarConversion
static CalendarConversion	toCalendar(TimeZone timeZone, Locale locale, Calendar dateIfNull, String stringIfNull, String... dateFormats)	Returns a new instance of CalendarConversion
static CharacterConversion	toChar()	Returns a new instance of CharacterConversion
static CharacterConversion	toChar(Character defaultValueForNullString)	Returns a new instance of CharacterConversion
static CharacterConversion	toChar(Character defaultValueForNullString, String defaultValueForNullChar)	Returns a new instance of CharacterConversion
static DateConversion	toDate(String... dateFormats)	Returns a new instance of DateConversion
static DateConversion	toDate(Date dateIfNull, String... dateFormats)	Returns a new instance of DateConversion
static DateConversion	toDate(Date dateIfNull, String stringIfNull, String... dateFormats)	Returns a new instance of DateConversion
static DateConversion	toDate(Locale locale, String... dateFormats)	Returns a new instance of DateConversion
static DateConversion	toDate(Locale locale, Date dateIfNull, String... dateFormats)	Returns a new instance of DateConversion
static DateConversion	toDate(Locale locale, Date dateIfNull, String stringIfNull, String... dateFormats)	Returns a new instance of DateConversion
static DateConversion	toDate(TimeZone timeZone, Locale locale, Date dateIfNull, String stringIfNull, String... dateFormats)	Returns a new instance of DateConversion
static DoubleConversion	toDouble()	Returns a new instance of DoubleConversion
static <T extends Enum<T>> EnumConversion<T>	toEnum(Class<T> enumType)	Returns a new instance of EnumConversion
static <T extends Enum<T>> EnumConversion<T>	toEnum(Class<T> enumType, EnumSelector... selectors)	Returns a new instance of EnumConversion
static <T extends Enum<T>> EnumConversion<T>	toEnum(Class<T> enumType, String customEnumElement, EnumSelector... selectors)	Returns a new instance of EnumConversion
static <T extends Enum<T>> EnumConversion<T>	toEnum(Class<T> enumType, T valueIfStringIsNull, String valueIfEnumIsNull, String customEnumElement, EnumSelector... selectors)	Returns a new instance of EnumConversion
static FloatConversion	toFloat()	Returns a new instance of FloatConversion
static FormattedDateConversion	toFormattedDate(String pattern)	Returns a new instance of FormattedDateConversion
static FormattedDateConversion	toFormattedDate(String pattern, String valueIfObjectIsNull)	Returns a new instance of FormattedDateConversion
static FormattedDateConversion	toFormattedDate(String pattern, Locale locale)	Returns a new instance of FormattedDateConversion
static FormattedDateConversion	toFormattedDate(String pattern, Locale locale, String valueIfObjectIsNull)	Returns a new instance of FormattedDateConversion
static IntegerConversion	toInteger()	Returns a new instance of IntegerConversion
static LongConversion	toLong()	Returns a new instance of LongConversion
static LowerCaseConversion	toLowerCase()	Returns a singleton instance of LowerCaseConversion
static NullStringConversion	toNull(String... nullRepresentations)	Returns a new instance of NullStringConversion
static ShortConversion	toShort()	Returns a new instance of ShortConversion
static UpperCaseConversion	toUpperCase()	Returns a singleton instance of UpperCaseConversion
static TrimConversion	trim()	Returns a singleton instance of TrimConversion
static TrimConversion	trim(int length)	Returns a TrimConversion that limits the output to a fixed length
static ValidatedConversion	validate(boolean nullable, boolean allowBlanks)	Returns a ValidatedConversion that checks for nulls or blank values.
static ValidatedConversion	validate(boolean nullable, boolean allowBlanks, String regexToMatch)	Returns a ValidatedConversion that checks for nulls or blank values.
static ValidatedConversion	validate(boolean nullable, boolean allowBlanks, String[] oneOf, String[] noneOf)	Returns a new instance of ValidatedConversion to validate values of a record
static ValidatedConversion	validate(boolean nullable, boolean allowBlanks, String[] oneOf, String[] noneOf, String regexToMatch)	Returns a new instance of ValidatedConversion to validate values of a record

Methods inherited from class java.lang.Object

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

Field Details

upperCase

private static final UpperCaseConversion upperCase

lowerCase

private static final LowerCaseConversion lowerCase

trim

private static final TrimConversion trim

toString

private static final ToStringConversion toString

Constructor Details

Conversions

private Conversions()

Method Details

string

public static ToStringConversion string()

Returns a singleton instance of ToStringConversion

Returns:

a singleton instance of ToStringConversion

toUpperCase

public static UpperCaseConversion toUpperCase()

Returns a singleton instance of UpperCaseConversion

Returns:

a singleton instance of UpperCaseConversion

toLowerCase

public static LowerCaseConversion toLowerCase()

Returns a singleton instance of LowerCaseConversion

Returns:

a singleton instance of LowerCaseConversion

trim

public static TrimConversion trim()

Returns a singleton instance of TrimConversion

Returns:

a singleton instance of TrimConversion

trim

public static TrimConversion trim(int length)

Returns a TrimConversion that limits the output to a fixed length

Parameters:

length - the maximum length a value can contain. Characters after this limit will be discarded.

Returns:

a trim-to-length conversion

replace

public static RegexConversion replace(String replaceRegex,
 String replacement)

Returns a new instance of RegexConversion

Parameters:

replaceRegex - the regular expression used to match contents of a given input String

replacement - the replacement content to replace any contents matched by the given regular expression

Returns:

the new instance of RegexConversion created with the given parameters.

toNull

public static NullStringConversion toNull(String... nullRepresentations)

Returns a new instance of NullStringConversion

Parameters:

nullRepresentations - the sequence of Strings that represent a null value.

Returns:

the new instance of NullStringConversion created with the given parameters.

toDate

public static DateConversion toDate(Locale locale,
 String... dateFormats)

Returns a new instance of DateConversion

Parameters:

locale - the Locale that determines how the date mask should be formatted.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toDate

public static DateConversion toDate(String... dateFormats)

Returns a new instance of DateConversion

Parameters:

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toDate

public static DateConversion toDate(Locale locale,
 Date dateIfNull,
 String... dateFormats)

Returns a new instance of DateConversion

Parameters:

locale - the Locale that determines how the date mask should be formatted.

dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toDate

public static DateConversion toDate(Date dateIfNull,
 String... dateFormats)

Returns a new instance of DateConversion

Parameters:

dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toDate

public static DateConversion toDate(TimeZone timeZone,
 Locale locale,
 Date dateIfNull,
 String stringIfNull,
 String... dateFormats)

Returns a new instance of DateConversion

Parameters:

timeZone - the TimeZone of the date to be formatted

locale - the Locale that determines how the date mask should be formatted.

dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a Date input is null. Used when DateConversion.revert(Date) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toDate

public static DateConversion toDate(Locale locale,
 Date dateIfNull,
 String stringIfNull,
 String... dateFormats)

Returns a new instance of DateConversion

Parameters:

locale - the Locale that determines how the date mask should be formatted.

dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a Date input is null. Used when DateConversion.revert(Date) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toDate

public static DateConversion toDate(Date dateIfNull,
 String stringIfNull,
 String... dateFormats)

Returns a new instance of DateConversion

Parameters:

dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a Date input is null. Used when DateConversion.revert(Date) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).

Returns:

the new instance of DateConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(Locale locale,
 String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

locale - the Locale that determines how the date mask should be formatted.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(Locale locale,
 Calendar dateIfNull,
 String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

locale - the Locale that determines how the date mask should be formatted.

dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(Calendar dateIfNull,
 String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(Locale locale,
 Calendar dateIfNull,
 String stringIfNull,
 String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

locale - the Locale that determines how the date mask should be formatted.

dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a Date input is null. Used when CalendarConversion.revert(Calendar) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(TimeZone timeZone,
 Locale locale,
 Calendar dateIfNull,
 String stringIfNull,
 String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

timeZone - the TimeZone to be considered

locale - the Locale that determines how the date mask should be formatted.

dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a Date input is null. Used when CalendarConversion.revert(Calendar) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toCalendar

public static CalendarConversion toCalendar(Calendar dateIfNull,
 String stringIfNull,
 String... dateFormats)

Returns a new instance of CalendarConversion

Parameters:

dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a Date input is null. Used when CalendarConversion.revert(Calendar) is invoked.

dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).

Returns:

the new instance of CalendarConversion created with the given parameters.

toByte

public static ByteConversion toByte()

Returns a new instance of ByteConversion

Returns:

a new instance of ByteConversion

toShort

public static ShortConversion toShort()

Returns a new instance of ShortConversion

Returns:

a new instance of ShortConversion

toInteger

public static IntegerConversion toInteger()

Returns a new instance of IntegerConversion

Returns:

a new instance of IntegerConversion

toLong

public static LongConversion toLong()

Returns a new instance of LongConversion

Returns:

a new instance of LongConversion

toBigInteger

public static BigIntegerConversion toBigInteger()

Returns a new instance of BigIntegerConversion

Returns:

a new instance of BigIntegerConversion

toFloat

public static FloatConversion toFloat()

Returns a new instance of FloatConversion

Returns:

a new instance of FloatConversion

toDouble

public static DoubleConversion toDouble()

Returns a new instance of DoubleConversion

Returns:

a new instance of DoubleConversion

toBigDecimal

public static BigDecimalConversion toBigDecimal()

Returns a new instance of BigDecimalConversion

Returns:

a new instance of BigDecimalConversion

formatToNumber

public static NumericConversion<Number> formatToNumber(String... numberFormats)

Returns a new instance of NumericConversion

Parameters:

numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a Number into a String in NumericConversion.revert(Number).

Returns:

a new instance of NumericConversion that supports the given number formats

formatToNumber

public static <T extends Number>
NumericConversion<T> formatToNumber(Class<T> numberType,
 String... numberFormats)

Returns a new instance of NumericConversion

Type Parameters:

T - type of number

Parameters:

numberType - type of number to be returned. The resulting instance of Number will be cast to the expected type.

numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a Number into a String in NumericConversion.revert(Number).

Returns:

a new instance of NumericConversion that supports the given number formats

formatToBigDecimal

public static FormattedBigDecimalConversion formatToBigDecimal(String... numberFormats)

Returns a new instance of FormattedBigDecimalConversion

Parameters:

numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a BigDecimal into a String in NumericConversion.revert(Number).

Returns:

a new instance of FormattedBigDecimalConversion that supports the given number formats

formatToBigDecimal

public static FormattedBigDecimalConversion formatToBigDecimal(BigDecimal defaultValueForNullString,
 String... numberFormats)

Returns a new instance of FormattedBigDecimalConversion

Parameters:

defaultValueForNullString - default BigDecimal to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a BigDecimal into a String in NumericConversion.revert(Number).

Returns:

a new instance of FormattedBigDecimalConversion that supports the given number formats

formatToBigDecimal

public static FormattedBigDecimalConversion formatToBigDecimal(BigDecimal defaultValueForNullString,
 String stringIfNull,
 String... numberFormats)

Returns a new instance of FormattedBigDecimalConversion

Parameters:

defaultValueForNullString - default BigDecimal to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

stringIfNull - default String value to be returned when a BigDecimal input is null. Used when FormattedBigDecimalConversion#revert(BigDecimal) is invoked.

numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a BigDecimal into a String in NumericConversion.revert(Number).

Returns:

a new instance of FormattedBigDecimalConversion that supports the given number formats

toBoolean

public static BooleanConversion toBoolean(Boolean defaultValueForNullString,
 String defaultValueForNullBoolean,
 String[] valuesForTrue,
 String[] valuesForFalse)

Returns a new instance of BooleanConversion

Parameters:

defaultValueForNullString - default Boolean value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

defaultValueForNullBoolean - default String value to be returned when a Boolean input is null. Used when BooleanConversion.revert(Boolean) is invoked.

valuesForTrue - Strings that identify the boolean value true. The first element will be returned when executing BooleanConversion.revert(true)

valuesForFalse - Strings that identify the boolean value false. The first element will be returned when executing BooleanConversion.revert(false)

Returns:

a new instance of BooleanConversion with support for multiple representations of true and false

toBoolean

public static BooleanConversion toBoolean(Boolean defaultValueForNullString,
 String defaultValueForNullBoolean,
 String valueForTrue,
 String valueForFalse)

Returns a new instance of BooleanConversion

Parameters:

defaultValueForNullString - default Boolean value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

defaultValueForNullBoolean - default String value to be returned when a Boolean input is null. Used when BooleanConversion.revert(Boolean) is invoked.

valueForTrue - String that identify the boolean value true.

valueForFalse - String that identify the boolean value false.

Returns:

a new instance of BooleanConversion with support for multiple representations of true and false

toBoolean

public static BooleanConversion toBoolean(String[] valuesForTrue,
 String[] valuesForFalse)

Returns a new instance of BooleanConversion

Parameters:

valuesForTrue - Strings that identify the boolean value true. The first element will be returned when executing BooleanConversion.revert(true)

valuesForFalse - Strings that identify the boolean value false. The first element will be returned when executing BooleanConversion.revert(false)

Returns:

a new instance of BooleanConversion with support for multiple representations of true and false

toBoolean

public static BooleanConversion toBoolean()

Returns a new instance of BooleanConversion that converts the string "true" to true, and the String "false" to false.

Returns:

a new instance of BooleanConversion with support for multiple representations of true and false

toBoolean

public static BooleanConversion toBoolean(String valueForTrue,
 String valueForFalse)

Returns a new instance of BooleanConversion

Parameters:

valueForTrue - String that identifies the boolean value true.

valueForFalse - String that identifies the boolean value false.

Returns:

a new instance of BooleanConversion with support for multiple representations of true and false

toChar

public static CharacterConversion toChar()

Returns a new instance of CharacterConversion

Returns:

a new instance of CharacterConversion

toChar

public static CharacterConversion toChar(Character defaultValueForNullString,
 String defaultValueForNullChar)

Returns a new instance of CharacterConversion

Parameters:

defaultValueForNullString - default Character value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

defaultValueForNullChar - default String value to be returned when a Character input is null. Used when CharacterConversion#revert(Character) is invoked.

Returns:

a new instance of CharacterConversion

toChar

public static CharacterConversion toChar(Character defaultValueForNullString)

Returns a new instance of CharacterConversion

Parameters:

defaultValueForNullString - default Character value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.

Returns:

a new instance of CharacterConversion

toEnum

public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType)

Returns a new instance of EnumConversion

Type Parameters:

T - the enum type

Parameters:

enumType - the enumeration type to be converted from/to String

Returns:

new instance of EnumConversion

toEnum

public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType,
 EnumSelector... selectors)

Returns a new instance of EnumConversion

Type Parameters:

T - the enum type

Parameters:

enumType - the enumeration type to be converted from/to String

selectors - the selection elements of the enumeration to use for matching Strings.

Returns:

new instance of EnumConversion

toEnum

public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType,
 String customEnumElement,
 EnumSelector... selectors)

Returns a new instance of EnumConversion

Type Parameters:

T - the enum type

Parameters:

enumType - the enumeration type to be converted from/to String

customEnumElement - name of custom element of the enumeration (attribute or method) whose values should be used to match equivalent Strings.

selectors - the selection elements of the enumeration to use for matching Strings.

Returns:

new instance of EnumConversion

toEnum

public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType,
 T valueIfStringIsNull,
 String valueIfEnumIsNull,
 String customEnumElement,
 EnumSelector... selectors)

Returns a new instance of EnumConversion

Type Parameters:

T - the enum type

Parameters:

enumType - the enumeration type to be converted from/to String

valueIfStringIsNull - the default enumeration constant to use if the input String is null

valueIfEnumIsNull - the default String value to use if the input enum constant is null

customEnumElement - name of custom element of the enumeration (attribute or method) whose values should be used to match equivalent Strings.

selectors - the selection elements of the enumeration to use for matching Strings.

Returns:

new instance of EnumConversion

toFormattedDate

public static FormattedDateConversion toFormattedDate(String pattern)

Returns a new instance of FormattedDateConversion

Parameters:

pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.

Returns:

new instance of FormattedDateConversion configured with the given parameters

toFormattedDate

public static FormattedDateConversion toFormattedDate(String pattern,
 String valueIfObjectIsNull)

Returns a new instance of FormattedDateConversion

Parameters:

pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.

valueIfObjectIsNull - Default string value to be returned when the input object is null.

Returns:

new instance of FormattedDateConversion configured with the given parameters

toFormattedDate

public static FormattedDateConversion toFormattedDate(String pattern,
 Locale locale)

Returns a new instance of FormattedDateConversion

Parameters:

pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.

locale - The Locale that determines how the date pattern should be formatted.

Returns:

new instance of FormattedDateConversion configured with the given parameters

toFormattedDate

public static FormattedDateConversion toFormattedDate(String pattern,
 Locale locale,
 String valueIfObjectIsNull)

Returns a new instance of FormattedDateConversion

Parameters:

pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.

locale - The Locale that determines how the date pattern should be formatted.

valueIfObjectIsNull - Default string value to be returned when the input object is null.

Returns:

new instance of FormattedDateConversion configured with the given parameters

notNull

public static ValidatedConversion notNull()

Returns a ValidatedConversion that doesn't allow null values

Returns:

a not-null validator

notBlank

public static ValidatedConversion notBlank()

Returns a ValidatedConversion that doesn't allow null or blank values

Returns:

a not-blank validator

notBlank

public static ValidatedConversion notBlank(String regexToMatch)

Returns a ValidatedConversion that verifies the format of a given value

Parameters:

regexToMatch - regular expression to match and ensure the value has a given format

Returns:

a value format validator

validate

public static ValidatedConversion validate(boolean nullable,
 boolean allowBlanks)

Returns a ValidatedConversion that checks for nulls or blank values.

Parameters:

nullable - flag to indicate whether values can be null

allowBlanks - flag to indicate whether values can be blank

Returns:

new instance of ValidatedConversion configured with the given parameters

validate

public static ValidatedConversion validate(boolean nullable,
 boolean allowBlanks,
 String[] oneOf,
 String[] noneOf)

Returns a new instance of ValidatedConversion to validate values of a record

Parameters:

nullable - flag to indicate whether values can be null

allowBlanks - flag to indicate whether values can be blank

oneOf - list of accepted values.

noneOf - list of unacceptable values

Returns:

new instance of ValidatedConversion configured with the given parameters

validate

public static ValidatedConversion validate(boolean nullable,
 boolean allowBlanks,
 String regexToMatch)

Returns a ValidatedConversion that checks for nulls or blank values.

Parameters:

nullable - flag to indicate whether values can be null

allowBlanks - flag to indicate whether values can be blank

regexToMatch - regular expression to match and ensure the value has a given format

Returns:

new instance of ValidatedConversion configured with the given parameters

validate

public static ValidatedConversion validate(boolean nullable,
 boolean allowBlanks,
 String[] oneOf,
 String[] noneOf,
 String regexToMatch)

Returns a new instance of ValidatedConversion to validate values of a record

Parameters:

nullable - flag to indicate whether values can be null

allowBlanks - flag to indicate whether values can be blank

oneOf - list of accepted values.

noneOf - list of unacceptable values

regexToMatch - regular expression to match and ensure the value has a given format

Returns:

new instance of ValidatedConversion configured with the given parameters

oneOf

public static ValidatedConversion oneOf(String... oneOf)

Returns a new instance of ValidatedConversion to validate values of a record Nulls and blanks are not be allowed by default.

Parameters:

oneOf - list of accepted values.

Returns:

new instance of ValidatedConversion configured with the given parameters

noneOf

public static ValidatedConversion noneOf(String... noneOf)

Returns a new instance of ValidatedConversion to validate values of a record Nulls and blanks are not be allowed by default.

Parameters:

noneOf - list of values that are not allowed.

Returns:

new instance of ValidatedConversion configured with the given parameters